The directories immediately below /usr/share/sgml naturally fall into two categories: the SGML base directories, and the major DTD and application directories. These are described in more detail below.
These directories are part of the SGML infrastructure and are created by the sgml-base package. They are defined as the following directories:
| declaration/ |
| dtd/ |
| entities/ |
| misc/ |
| stylesheet/ |
The layout of the SGML base directories is similar to the previous layout in /usr/lib/sgml. Note, however, that there is no provision for a notations directory under /usr/share/sgml.
Common or minor dtds, declarations, entities should be placed in /usr/share/sgml/{dtd,entities,declaration}, whereas "well known" DTDs get their own top-level /usr/share/sgml/[well-known-dtd] directory.
SGML Base Directories
All declarations needed by more than one package should be placed here.
Packages with a small number of dtd files and no catalog file should install their files here, especially if the maintainer feels that a new docbook-like tree directly under /usr/share/sgml is not warranted. Such packages are not required to create a subdirectory, but may do so.
DTD packages that do have a catalog file must create their own subdirectory, so that the catalog file (named catalog) has a unique location.
Packages with a large number of files should create their own non-versioned subdirectory named package-name.
When package directories are created they may or may not have versioned subdirectories, at the discretion of the maintainer. If created, they must use only version numbers in their names.
Entities for general use are placed in here.
If it doesn't belong in the other directories, put it in here. An example here would be character sets.
FIXME: is this one needed?