Gibt es eine detaillierte API-Dokumentation zur Python-Bindung für appindicator?

Ich werde ernsthaft mit einem eigenen Projekt und benötige eine gute Dokumentation zum Appindicator-Modul für Python. Was ich bisher gefunden habe:

1. API-Dokumentation auf dev.ubuntu.com
2. Community Wiki Eintrag
3. API-Dokumentation zum C-Code
4. Schöner Blogbeitrag

Was stimmt mit denen nicht:

1. Nur eine Liste ohne Erklärungen zu den Argumenten, Ergebnissen und der Funktionsweise der Methoden
2. Nur Überlegungen zum Design und Hintergründe - wenig, was bei der tatsächlichen Programmierung helfen würde
3. Was das Python-Modul vermisst (zB create_menu_from_desktop)
4. Viele nützliche Informationen komprimiert, aber nicht vollständig

Also brauche ich im Grunde etwas so Detailliertes wie 3. Aber für das Python-Modul.

Beispiel zu meinem Problem:

void build_menu_from_desktop (desktop_file, desktop_profile)

Was sollen die Argumente sein und was macht die Methode? Ich vermute, die Methode erstellt Menüeinträge aus einer '* .desktop'-Datei. Aber wenn ja, warum braucht es mehr Argumente als nur diese Datei? Aus welchen Einträgen in der Datei stammen die Menüpunkte? Es sind Fragen wie diese, für die es mir schwer fällt, eine Antwort zu finden.

Ja, wir stellen fest, dass wir eine Python-Dokumentation mit dem entsprechenden Detaillierungsgrad benötigen. Das ist das Ziel des Giraffenprojekts . Es funktioniert mit den GObject Introspection-Bindungen. Auf diese Weise sollten neue Python-Anwendungen geschrieben werden, um die Anwendungsindikatoren zu verwenden.

Bis dahin ist die API-Dokumentation, die Sie notiert haben, die beste Wahl. Es sollte ungefähr das gleiche sein, obwohl "Python-ified".

Das build_menu_from_desktop ist eine praktische Funktion, mit der Sie die Einträge laden können, die sich ansonsten in einer Art Quicklist in Unity befinden würden . Um diese Einträge zu erhalten, müssen Sie build_menu_from_desktop("/my/path/myfile.desktop", "Unity")die Zielumgebung angeben.

Dies ermöglicht es Ihnen, unterschiedliche Einträge in der Desktop-Datei zu haben und einige zu überlappen und andere nicht.