Aplikatör için python bağlaması hakkında ayrıntılı bir API belgesi var mı?

Kendime ait bir projeyle serpiyorum ve python için appindicator modülünde iyi bir belgeye ihtiyacım var. Şimdiye kadar bulduğum şey:

1. Dev.ubuntu.com adresindeki API belgeleri
2. Topluluk wiki girişi
3. C kodundaki API belgeleri
4. Güzel blog yazısı

onların sorunu ne:

1. Sadece argümanlar, geri dönüşler ve yöntemlerin ne yaptığı hakkında açıklamaları olmayan bir liste
2. Yalnızca tasarım konuları ve arka planlar - gerçek programlamaya yardımcı olacak çok az şey
3. Python modülünde eksik olan şeyler (ör. Create_menu_from_desktop)
4. Sıkıştırılmış ancak tam olmayan çok yararlı bilgiler

Yani temelde 3. kadar ayrıntılı bir şeye ihtiyacım var ama python modülü için.

Sorunumla ilgili örnek:

void build_menu_from_desktop (desktop_file, desktop_profile)

Argümanlar ne olmalı ve yöntem ne yapıyor? Benim tahminim, yöntem '* .desktop' dosyasından menü girişleri oluşturur. Ama eğer öyleyse, neden bu dosyadan daha fazla argümana ihtiyacı var? Dosyadaki hangi girişler menü öğelerini alır? Bunun gibi sorular için cevap bulmakta biraz zorlanıyorum.

Evet, uygun ayrıntı düzeyine sahip Python belgelerine ihtiyacımız olduğunu biliyoruz. Zürafa projesinin amacı budur . Uygulama göstergelerini kullanmak için yeni Python uygulamalarının yazılması gereken yöntem olan GObject Introspection bağlarıyla çalışacaktır.

O zamana kadar, en iyi bahis not ettiğiniz API dokümanlarıdır. "Python ified" olsa da kabaca aynı olmalıdır.

Build_menu_from_desktop bir konfor fonksiyonu kullanımı aksi bir gibi bir şey olurdu girdileri yük olduğunu Unity şekilde hızlı . Bu nedenle build_menu_from_desktop("/my/path/myfile.desktop", "Unity"), TargetEnvironment'ı belirtmek için kullanacağınız girişleri almak için.

Bu, masaüstü dosyasında farklı girişlere sahip olmanıza ve bazı çakışmalara sahip olmanıza ve diğerlerinin olmamasına izin verir.