Beyond Linux® From Scratch (Edição systemd ) - Versão 12.2

Capítulo 13. Programação

Doxygen-1.12.0

Introdução ao "Doxygen"

O pacote Doxygen contém um sistema de documentação para "C++", "C", "Java", "Objective-C", "Corba IDL" e, até certo ponto, "PHP", "C#" e "D". É útil para gerar documentação "HTML" e(ou) manual de referência fora de linha a partir de um conjunto de arquivos fonte documentados. Também existe suporte para gerar saída em "RTF", "PostScript", "PDF" com hiperlink, "HTML" compactado e páginas de manual "Unix". A documentação é extraída diretamente dos fontes, o que torna muito mais fácil manter a documentação consistente com o código-fonte.

Você também pode configurar o Doxygen para extrair a estrutura do código a partir de arquivos fonte não documentados. Isso é muito útil para encontrar rapidamente seu caminho em grandes distribuições de fontes. Usado junto com Graphviz, você também consegue visualizar as relações entre os vários elementos por meio de gráficos de dependência, diagramas de herança e diagramas de colaboração, todos gerados automaticamente.

Esse pacote é conhecido por construir e funcionar corretamente usando uma plataforma LFS 12.2.

Informação do Pacote

  • Transferência (HTTP): https://doxygen.nl/files/doxygen-1.12.0.src.tar.gz

  • Transferência (FTP):

  • Soma de verificação MD5 da transferência: 3ab97fd76c6fe090946c836c5051182b

  • Tamanho da transferência: 8,1 MB

  • Espaço em disco estimado exigido: 248 MB (com testes)

  • Tempo de construção estimado: 1,9 UPC (com testes; ambos usando paralelismo = 4)

Dependências do "Doxygen"

Exigidas

CMake-3.30.2 e git-2.46.0

Recomendadas

Qt-6.7.2 (para doxywizard)

Opcionais

Graphviz-12.1.0, ghostscript-10.03.1, libxml2-2.13.3 (exigido para os testes), LLVM-18.1.7 (com clang), qt5-components-5.15.14 (obsoleto), texlive-20240312 (ou install-tl-unx), xapian-1.4.26 (para doxyindexer) e javacc

Instalação do "Doxygen"

Primeiro, corrija alguns conjuntos de comandos sequenciais python: 

grep -rl '^#!.*python$' | xargs sed -i '1s/python/&3/'

Instale Doxygen executando os seguintes comandos: 

mkdir -v build &&
cd       build &&

cmake -G "Unix Makefiles"          \
      -D CMAKE_BUILD_TYPE=Release  \
      -D CMAKE_INSTALL_PREFIX=/usr \
      -D build_wizard=ON           \
      -D force_qt=Qt6              \
      -W no-dev .. &&
make

Para testar os resultados, emita: make testes. Um teste, 012_cite.dox, é conhecido por falhar se texlive-20240312 ou install-tl-unx não estiver instalado.

Se você deseja gerar a documentação do pacote, [então] você precisa ter Python, TeX Live (para documentos "HTML") e Ghostscript (para documentos "PDF") instalados, então emita o seguinte comando: 

cmake  -D build_doc=ON \
       -D DOC_INSTALL_DIR=share/doc/doxygen-1.12.0 \
       .. &&
make docs

Agora, como o(a) usuário(a) root: 

make install &&
install -vm644 ../doc/*.1 /usr/share/man/man1

Se você gerou a documentação do pacote, então as páginas de manual serão instaladas automaticamente e você não precisará executar o último comando install ....

Explicações do Comando

-D build_wizard=OFF: Use essa chave se Qt6 não estiver instalado.

-D build_search=ON: Use essa chave se xapian estiver instalado e você desejar construir ferramentas de pesquisa externas (doxysearch.cgi e doxyindexer).

-D force_qt6=ON: Use essa chave para construir doxywizard com Qt6, mesmo se Qt5 estiver instalado.

-D use_libclang=ON: Use essa chave se llvm com clang estiverem instalados, para adicionar suporte para análise da libclang.

Configurando o "Doxygen"

Não existe nenhuma configuração real necessária para o pacote Doxygen, embora três pacotes adicionais sejam exigidos se você desejar usar recursos estendidos. Se demandar fórmulas para criar documentação em PDF, então você precisa ter o texlive-20240312 instalado. Se demandar fórmulas para converter arquivos PostScript em bitmaps, então você precisa ter o ghostscript-10.03.1 instalado.

Conteúdo

Aplicativos Instalados: doxygen e opcionalmente, doxywizard, doxyindexer e doxysearch.cgi
Bibliotecas Instaladas: Nenhum(a)
Diretório Instalado: /usr/share/doc/doxygen-1.12.0

Descrições Curtas

doxygen

é um utilitário baseado em linha de comando usado para gerar arquivos de configuração de modelo e, em seguida, gerar documentação a partir desses modelos. Use doxygen --help para uma explicação dos parâmetros da linha de comando

doxywizard

é uma estrutura "GUI" de interação direta com o(a) usuário(a) para configurar e executar doxygen

doxyindexer

gera um índice de pesquisa chamado doxysearch.db a partir de um ou mais arquivos de dados de pesquisa produzidos por doxygen. Veja-se, por exemplo, https://javacc.github.io/javacc/

doxysearch.cgi

é um aplicativo "CGI" para pesquisar os dados indexados por doxyindexer