Haciendo documentaciones

El make de GNU se utiliza para compilar documentación desde fuentes DocBook. Hay algunas definiciones de entorno que quizás sea necesario fijar o modificar en su instalación. Makefile busca doc/../src/Makefile e implícitamente doc/../src/Makefile.custom para obtener información del entorno. En mi sistema el fichero src/Makefile.custom tiene este aspecto:

# Makefile.custom
# Thomas Lockhart 1998-03-01

POSTGRESDIR= /opt/postgres/current
CFLAGS+= -m486
YFLAGS+= -v

# documentation

HSTYLE= /home/lockhart/SGML/db143.d/docbook/html
PSTYLE= /home/lockhart/SGML/db143.d/docbook/print
   

donde HSTYLE y PSTYLE determinan el path a docbook.dsl para hojas de estilo HTML y copias impresas respectivamente. Estos ficheros de hojas de estilo son para el Modular Style Sheets, de Norm Walsh. Si se usan otras hojas de estilo, entonces se pueden definir HDSL y PDSL como el path completo y como nombre del fichero de la hoja de estilo como se hizo más arriba con HSTYLE y PSTYLE. En muchos sistemas estas hojas de estilo se encontrarán en en paquetes instalados en /usr/lib/sgml/, /usr/share/lib/sgml/, o /usr/local/lib/sgml/.

Los paquetes de documentación HTML pueden ser generados desde la fuente SGML escribiendo lo siguiente:

% cd doc/src
% make tutorial.tar.gz
% make user.tar.gz
% make admin.tar.gz
% make programmer.tar.gz
% make postgres.tar.gz
% make install
   

Estos paquetes pueden ser instalados desde el directorio principal de la documentación escribiendo:

% cd doc
% make install