Obtendo GTK-Doc

1.3.1. Requisitos

Perl v5 - os scripts principais são Perl.

DocBook DTD v3.0 - Este é o DocBook SGML DTD. http://www.ora.com/davenport

Jade v1.1 - Este é um processador de DSSSL para conversão de SGML para vários formatos. http://www.jclark.com/jade

Folhas de estilo modulares do DocBook Este é o código DSSSL para converter DocBook para HTML (e alguns outros formatos). É usado junto com jade. Eu personalizei um pouco o código DSSSL, em gtk-doc.dsl, para colorir as listagens/declarações do código do programa e para dar suporte a índices de referências cruzadas globais nos HTML gerados. http://nwalsh.com/docbook/dsssl

docbook-to-man - se você deseja criar páginas man a partir do DocBook. Eu personalizei um pouco a "especificação de tradução", para deixar o título em caixa alta e adicionar o título "GTK Library" no topo das páginas e a data de revisão no canto inferior. Há também um link para isso em http://www.ora.com/davenport. NOTA: isso não funciona ainda.

1.3.2. Instalação

Não há um lugar padrão onde as folhas de estilos modulares de DocBook são instaladas.

O script de configuração do GTK-DOC pesquisa por esses três diretórios automaticamente:

/usr/lib/sgml/stylesheets/nwalsh-modular (usado pelo RedHat)

/usr/lib/dsssl/stylesheets/docbook (usado pelo Debian)

/usr/share/sgml/docbkdsl (usado pelo SuSE)

Se você tiver as folhas de estilos instaladas em algum lugar, você precisa configurar o Gtk-Doc usando a opção: --with-dsssl-dir=<CAMINHO_PARA_DIRETÓRIO_RAIZ_DAS_FOLHAS_DE_ESTILO>