☰

如何从源代码构建 GDB 文档？

tag-icon • tag-icon gdb
如何从源代码构建 GDB 文档？

我已经下载了GDB源：

git clone git://sourceware.org/git/binutils-gdb.git

现在我如何从源代码生成文档，可以从以下位置下载：https://sourceware.org/gdb/current/onlinedocs/？

我对 HTML 文档特别感兴趣，特别是如果可以构建它的单页版本的话。

我在 GDB master f47998d69f8d290564c022b010e63d5886a1fd7d 之后gdb-8.2-release。

答案1

cd binutils-gdb/gdb
./configure
cd doc
make html MAKEINFO=makeinfo MAKEINFOFLAGS='--no-split'
ls *.html

这假设您已经makeinfo安装；这应该apt-get install texinfo与类似 Debian 的系统类似。

答案2

如果你运行：

cd binutils-gdb
./configure
make html MAKEINFO=makeinfo MAKEINFOFLAGS='--no-split'
find . -name '*.html'

然后需要一段时间，但是为所有 Binutils 项目生成单页 HTML 文档，这也很方便。

-j $(nproc)不幸的是不起作用。

例如，我发现 GAS 文档本身无法轻松构建为 GDB。如果您尝试：

cd gas
./configure
cd doc
make html

然后它失败：

as.texi:23: @include: could not find bfdver.texi

所以似乎存在 BFD 依赖性。

在 Ubuntu 18.04 上测试。

相关内容