Chapter 5. File Overview

There are many files used to produce the several output formats, and to store the many text and information needed to generate the files. These are the most important ones, you should know about:

manual.xml

The main file for the documentation. It is supposed to be only a "glue" between the other parts, containing only part titles and entity references to chapters.

entities/chapters.ent

Contains entity definitions for all chapters and appendices. Entities for the XML files are generated by configure, so you should not edit this file.

entites/global.ent

Global internal text entities for all the XML files. This is where all the external links, email addresses, and "macros" are stored.

dsssl/*

DSSSL style sheets we use to generate the available formats of the manual.

xsl/*

XSL style sheets to generate HTML, HTMLHelp and print output from the manual XML sources.

your_language/language-defs.ent

Contains local entities used by this language. Some common ones are the main part titles, but you should also put entities used only by this language's files here.

your_language/language-snippets.ent

Longer often used XML snippets translated to this language. Including common warnings, notes, etc.