问题描述
我正在认真对待自己的一个项目，并且需要有关 python appindicator 模块的良好文档。到目前为止我发现了什么：
他们怎么了：
-
只是一个列表，没有对参数、返回值以及方法的作用进行解释
-
只有设计考虑因素和背景 – 对实际编程几乎没有帮助
-
python 模块缺少的东西(例如 create_menu_from_desktop)
-
许多有用的信息被压缩但不完整
所以基本上我需要像 3. 这样详细的东西，但是对于 python 模块。
我的问题的示例：
\\n
void build_menu_from_desktop (desktop_file, desktop_profile)
\\n
参数应该是什么以及该方法的作用是什么？我的猜测是，该方法从 ‘*.desktop’ 文件创建菜单条目。但如果是这样，为什么它需要更多的参数而不仅仅是该文件呢？它从文件中的哪些条目获取菜单项？像这样的问题我很难找到答案。
最佳方案
是的，我们意识到我们需要具有适当详细程度的 Python 文档。这就是 Giraffe project 的目标。它将与 GObject Introspection 绑定一起使用，这是编写新的 Python 应用程序以使用应用程序指示器的方式。
在那之前，最好的选择是您注意到的 API 文档。 “python-ified” 应该大致相同。
build_menu_from_desktop 是一个方便的函数，用于加载本来会在 quicklist in Unity 之类的条目中。因此，要获取这些条目，您可以使用 build_menu_from_desktop("/my/path/myfile.desktop", "Unity") 来指定 TargetEnvironment。
这允许您在桌面文件中拥有不同的条目，并且有一些重叠，而另一些则没有。