Início / unix / Perguntas / 477303
Accepted
Ciro Santilli OurBigBook.com
Asked: 2018-10-24 07:47:01 +0800 CST

Como construir a documentação do GDB a partir da fonte?

  • 772

Baixei a fonte do GDB:

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

agora, como faço para gerar a documentação da fonte, conforme pode ser baixado em: https://sourceware.org/gdb/current/onlinedocs/ ?

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

Estou no GDB master f47998d69f8d290564c022b010e63d5886a1fd7d após gdb-8.2-release.

gdb

2 respostas

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

    Isso pressupõe que você tenha makeinfoinstalado; isso deve ser algo como apt-get install texinfoem sistemas do tipo debian.

    • 3

  2. Se você executar:

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

    então demora um pouco, 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 GAS, por exemplo, não podiam ser facilmente construídos como GDB por si mesmos. Se você tentar:

    cd gas
./configure
cd doc
make html

    então ele falha com:

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

    então parece haver uma dependência BFD.

    Testado no Ubuntu 18.04.

    • 1

relate perguntas