Appendix C. Makefiles

Table of Contents

C.1. An individual book makefile
C.2. The Cogent Documentation bookset makefile
C.3. A Cogent Documentation auxiliary makefile
C.4. The fundamental makefile: doc/sgml.mak
C.5. The Export makefile in doc/export/
C.6. The Do-Everything makefile in doc/o/
C.7. The Top-Level makefile in doc/

Here are the makefiles we use to build our documentation.

C.1. An individual book makefile

This is the makefile for the Cascade DataHub manual. It is located at doc/o/dh-book/Makefile. All of the individual books' makefiles are virtually identical to this. Each of them calls the main makefile, doc/sgml.mak, using the include statement as shown here. The .sgml: line of this makefile sets the dependencies, which are: main.sgml, doc/i/datahub/*.sgml, and doc/i/common/*.sgml The two date statements towards the end of the file are used to generate the current date for the title page of the book.

# Makefile
#

I=../../i/datahub

.sgml: $(wildcard main.sgml $(I)/* ../../i/common/*.sgml \
         ../../config/cogent-both.dsl) 

include ../../sgml.mak

default: html pdf

again: fresh html