Existe uma documentação detalhada da API sobre a ligação do python para appindicator?

Estou ficando sério com um projeto próprio e preciso de uma boa documentação no módulo appindicator para python. O que eu encontrei até agora:

1. Documentação da API no dev.ubuntu.com
2. Entrada do wiki da comunidade
3. Documentação da API no código C
4. Nice post do blog

o que há de errado com eles:

1. Apenas uma lista sem explicações sobre os argumentos, retornos e o que os métodos fazem
2. Apenas considerações e antecedentes de design - pouco que ajudaria na programação real
3. Material em falta no módulo python (por exemplo, create_menu_from_desktop)
4. Muitas informações úteis compactadas, mas não completas

Então, basicamente, preciso de algo tão detalhado quanto 3., mas para o módulo python.

Exemplo no meu problema:

void build_menu_from_desktop (arquivo de área de trabalho, perfil de área de trabalho)

Quais devem ser os argumentos e o que o método faz? Meu palpite é que o método cria entradas de menu a partir de um arquivo '* .desktop'. Mas se sim, por que precisa de mais argumentos do que apenas esse arquivo? De quais entradas do arquivo são retirados os itens de menu? É para perguntas como esta que estou tendo dificuldade em encontrar uma resposta.

Sim, percebemos que precisamos da documentação do Python com o nível de detalhe apropriado. Esse é o objetivo do projeto Giraffe . Ele funcionará com as ligações do GObject Introspection, que é a maneira como os novos aplicativos Python devem ser gravados para usar os indicadores de aplicativo.

Até então, a melhor aposta é a documentação da API que você anotou. Deve ser aproximadamente o mesmo, embora seja "python-ified".

O build_menu_from_desktop é uma função de conveniência que utiliza para carregar as entradas que, de outra forma, estariam em algo como uma lista rápida no Unity . Portanto, para obter essas entradas, você usaria build_menu_from_desktop("/my/path/myfile.desktop", "Unity")para especificar o TargetEnvironment.

Isso permite que você tenha entradas diferentes no arquivo da área de trabalho e tenha alguma sobreposição e outras não.