Чи є детальна документація API щодо прив'язки python для appindicator?

Я отримую серйозний власний проект і мені потрібна хороша документація на модуль програми для програми python. Що я знайшов поки:

1. Документація API на dev.ubuntu.com
2. Запис у вікі спільноти
3. Документація API на код C
4. Приємна публікація в блозі

що з ними не так:

1. Просто список без пояснень щодо аргументів, повернень та того, що роблять методи
2. Тільки міркування та дизайн дизайну - мало, що допомогло б реально програмувати
3. У речей, у яких відсутній модуль python (наприклад, create_menu_from_desktop)
4. Багато корисної інформації стискається, але не є повною

Так що в основному мені потрібно щось детальне, як 3. але для модуля python.

Приклад моєї проблеми:

void build_menu_from_desktop (desktop_file, desktop_profile)

Якими повинні бути аргументи та що робить метод? Я здогадуюсь, що метод створює записи меню з файлу '* .desktop'. Але якщо так, то для чого йому потрібно більше аргументів, ніж просто цей файл? З яких записів у файлі він бере елементи меню? Це такі питання, як мені важко знайти відповідь.

Так, ми розуміємо, що нам потрібна документація Python з відповідним рівнем деталізації. Це мета проекту Giraffe . Він буде працювати з інтроспекційними прив'язками GObject, тобто таким чином слід писати нові програми Python для використання індикаторів додатків.

До цього часу найкраща ставка - це документація API, яку ви відзначили. Це повинно бути приблизно таким же, хоч "пітон-іфікований".

Build_menu_from_desktop - це функція зручності, використовуйте завантаження записів, які в іншому випадку були б такими, як швидкий список в Unity . Отже, щоб отримати ті записи, які ви використовуєте build_menu_from_desktop("/my/path/myfile.desktop", "Unity")для вказівки TargetEn Environment.

Це дозволяє мати різні записи у файлі робочого столу та мати певні накладки, а інші - ні.