☰

ソースコードからGDBドキュメントを書くには？

tag-icon • tag-icon gdb
ソースコードからGDBドキュメントを書くには？

GDBソースをダウンロードしました。

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

では、次からダウンロードできるソースコードからドキュメントを生成する方法は？https://sourceware.org/gdb/current/onlinedocs/？

私は特にHTML文書に興味があります。特に、HTML文書の単一ページバージョンを作成することが可能であれば、さらにそうです。

私はGDBマスターf47998d69f8d290564c022b010e63d5886a1fd7dを追っていますgdb-8.2-release。

答え1

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

これはすでにインストールされていると仮定します。 Debianのようなシステムでも似ていますmakeinfo。apt-get install texinfo

答え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でテストされました。

関連情報