Introdução ao GTK-Doc
O pacote GTK-Doc contém um
documentador de código. Isso é útil para extrair comentários
especialmente formatados a partir do código para criar a
documentação da API. Esse pacote é opcional; se não estiver instalado,
[então] os pacotes não construirão a documentação. Isso não
significa que você não terá nenhuma documentação. Se GTK-Doc não estiver disponível, [então] o
processo de instalação copiará qualquer documentação pré-construída
para seu sistema.
![[Nota]](../images/note.png)
Nota
Esse pacote é conhecido por construir e
funcionar adequadamente usando-se uma plataforma LFS 13.1.
Informação do Pacote
-
Transferência (HTTP):
https://download.gnome.org/sources/gtk-doc/1.36/gtk-doc-1.36.1.tar.xz
-
Transferência (FTP):
-
Soma de verificação MD5 da transferência:
819b11aa730cf5108f1df3f0eec91cf9
-
Tamanho da transferência: 584 KB
-
Espaço em disco estimado exigido: 16 MB (adicionar 2,2 MB
para os testes)
-
Tempo de construção estimado: menos que 0,1 UPC (com testes)
Dependências do GTK-Doc
Exigidas
docbook-xml-4.5, docbook-xsl-nons-1.79.2, GLib-2.88.3,
itstool-2.0.7, libxslt-1.1.45 e
Pygments-2.20.0
Opcionais
Para testes: dblatex ou
fop-2.11 (suporte a PDF XML), Which-2.25 e
módulos Python lxml-6.1.1, parameterized e
yelp-tools
Nota
Os módulos opcionais "Python" acima podem ser facilmente
instalados com o comando pip3.
Instalação do GTK-Doc
Instale GTK-Doc executando os
seguintes comandos:
mkdir -p build &&
cd build &&
meson setup .. \
--prefix=/usr \
--buildtype=release \
-D tests=false &&
ninja
A suíte de teste travará se o pacote (ou uma versão anterior) ainda
não estiver instalado.
Agora, como o(a) usante root:
ninja install
Para testar os resultados, certifique-se de ter o módulo Python
parameterized instalado e
emita:
meson configure -D tests=true &&
ninja test
Alguns testes falharão dependendo dos pacotes instalados
opcionalmente.