1

valadoc我想为 gnome库重新生成gio-2.0（这是 的一部分glib）。

我知道完整的文档可以在线获取。

我希望能够在本地生成它（理想情况下不必自己重建库）。

Valadoc 能够从库编译期间创建的 gobject-introspection 文件（gir 文件）生成文档。该文件包含所有定义和注释。

希望对我来说，vala 团队维护了一个中央存储库，并且Gio-2.0.gir可用。

现在我下载了文件，我在使用正确的参数调用 valadoc 时遇到了问题。

以下命令：

valadoc --girdir=. --importdir=. --import=Gio-2.0 --pkg=gio-2.0 --force -o ./dist

或者

valadoc --pkg=gio-2.0 --force -o ./dist

退货

Succeeded - 0 warning(s)

并创建一个只有包名但没有类/方法/等的 html。

你能帮我正确调用valadoc吗？

注意：对于任何对如何生成完整的valadoc.org感到好奇的人，可以使用脚本和应用程序。

4

1 回答 1

3

正如您已经完成的那样，您可以通过--pkg gtk+-3.0例如指定所需的包。为了使这些文档生成，您还必须指定--deps（没有任何额外的参数）。

编辑：也可能感兴趣：要实际包含文档字符串，您需要将--importdir参数设置为您的 gir 目录（大部分时间是/usr/share/gir-1.0），并为您想要文档字符串的每个包添加例如--import=Gio-2.0。如果您的 vapis 已生成并保留了注释，您可能不需要这个额外的步骤。

于 2015-02-26T14:09:42.673 回答