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. It is generated from manual.xml.in when you run configure.

entities/file-entities.ent

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

entities/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, phpweb, 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.

your_language/translation.xml

This file is used to store all central translation info, like a small intro text for translators, the persons list, and the files under translation / modification. This file is not present in the English tree.

your_language/some_directory

The PHP Manual XML source is organized into directories. The biggest part is the extension reference, which is stored in the reference directory of your language.