Existe-t-il une documentation API détaillée sur la liaison python pour appindicator?

Je deviens sérieux avec mon propre projet et j'ai besoin d'une bonne documentation sur le module appindicator pour python. Ce que j'ai trouvé jusqu'à présent:

1. Documentation API sur dev.ubuntu.com
2. Entrée wiki communautaire
3. Documentation API sur le code C
4. Bon article de blog

Qu'est-ce qui ne va pas avec eux:

1. Juste une liste sans explications sur les arguments, les retours et sur ce que font les méthodes
2. Uniquement des considérations et des arrière-plans de conception - peu qui pourraient aider à la programmation réelle
3. Truc manquant le module python a (par exemple create_menu_from_desktop)
4. Beaucoup d'informations utiles compressées mais pas complètes

Donc, fondamentalement, j'ai besoin de quelque chose d'aussi détaillé que 3. mais pour le module python.

Exemple sur mon problème:

void build_menu_from_desktop (desktop_file, desktop_profile)

Quels sont les arguments censés être et que fait la méthode? Je suppose que la méthode crée des entrées de menu à partir d'un fichier '* .desktop'. Mais si c'est le cas, pourquoi a-t-il besoin de plus d'arguments que ce seul fichier? De quelles entrées du fichier prend-il les éléments de menu? Ce sont des questions comme celle-ci que j'ai un peu de mal à trouver une réponse.

Oui, nous réalisons que nous avons besoin d'une documentation Python avec le niveau de détail approprié. Tel est l'objectif du projet Giraffe . Il fonctionnera avec les liaisons GObject Introspection, ce qui est la façon dont les nouvelles applications Python doivent être écrites pour utiliser les indicateurs d'application.

Jusque-là, le meilleur pari est la documentation API que vous avez notée. Il devrait être à peu près le même si "python-ified".

Le build_menu_from_desktop est une fonction de commodité qui permet de charger les entrées qui seraient autrement dans quelque chose comme une liste rapide dans Unity . Donc, pour obtenir ces entrées, vous utiliseriez build_menu_from_desktop("/my/path/myfile.desktop", "Unity")pour spécifier le TargetEnvironment.

Cela vous permet d'avoir différentes entrées dans le fichier de bureau et d'avoir des chevauchements et d'autres non.