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