![如何从源代码构建 GDB 文档?](https://linux22.com/image/141039/%E5%A6%82%E4%BD%95%E4%BB%8E%E6%BA%90%E4%BB%A3%E7%A0%81%E6%9E%84%E5%BB%BA%20GDB%20%E6%96%87%E6%A1%A3%EF%BC%9F.png)
我已经下载了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 上测试。