3.2. A typical output subdirectory

Preparing Cogent Documentation :
	Chapter 3. Creating Output from doc/o/

The output subdirectories are structured identically, and only differ with respect to the content of the various books produced within them. Here is a list of the top-level files and subdirectories in a typical output subdirectory, after the HTML, Help, and PDF documentation has been generated:

`CVS/`	The CVS repository.
`Cogent_Title.*`	Symbolic links to the GIF and PDF of the title-page graphic.
`Makefile`	The makefile for the book.
`main.sgml`	The SGML wrapper that generates the book. It contains the document header, DTD declaration, entity declarations, and one or more entities corresponding to the content of the book. As far as the processor is concerned, this wrapper is the base document for the book.
`dvi/`	An auto-generated subdirectory that contains the dvi output.
`help/`	An auto-generated subdirectory that contains the QNX Helpviewer output.
`html/`	An auto-generated subdirectory that contains the HTML output.
`pdf/`	An auto-generated subdirectory that contains the PDF output.
`tex/`	An auto-generated subdirectory that contains the TEX output.
`indexBookTitle.sgml`	The auto-generated index for the book.
`indexset.sgml`	A copy of the set index, that will appear in the book when it is in the Cogent Documentation set.

The auto-generated directories and all their contents are deleted and regenerated each time a make is issued for that output type. The same holds for the index*.sgml files.

The make empty command removes all files in the directory except CVS/, Makefile, and main.sgml.


Chapter 3. Creating Output from doc/o/		3.3. The main.sgml file