Como construir a documentação do GDB a partir do código-fonte?

2

Eu fiz o download da fonte do GDB:

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

agora, como faço para gerar a documentação a partir do código-fonte, pois ela pode ser baixada de: link ?

Estou especialmente interessado na documentação HTML, especialmente se for possível criar uma versão de uma única página.

Eu estou no mestre GDB f47998d69f8d290564c022b010e63d5886a1fd7d depois de gdb-8.2-release .

    

2 respostas

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

Isso pressupõe que você tenha makeinfo instalado; deve ser algo como apt-get install texinfo em sistemas parecidos com o debian.

    
por 23.10.2018 / 18:22
0

Se você executar:

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

leva algum tempo, mas gera documentos HTML de página única para todos os projetos Binutils, o que também é conveniente.

-j $(nproc) não funciona infelizmente.

Descobri que os documentos do GAS, por exemplo, não podiam ser criados facilmente como o GDB por si próprios. Se você tentar:

cd gas
./configure
cd doc
make html

falha com:

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

então parece haver uma dependência de BFD.

Testado no Ubuntu 18.04.

    
por 23.10.2018 / 19:03

Tags