5.2. Major DTD and Application Directories

These directories are created on a per-package basis for major, well-known DTDs and applications that have a large number of architecture independent files.

Note: Common or minor dtds, declarations, entities should be placed in /usr/share/sgml/{dtd,entities,declaration} as appropriate.

One possibility wuold look like this:

/usr/share/sgml/
...
docbook/
jade/
sgmltools-lite/
tei/
...

The sgml-data package also creates a number of symlink-based directories here, via the common practice of mapping public identifiers to system identifiers.

5.2.1. Directory Creation Guidelines

New DTD directories in /usr/share/sgml should only be created when installing a new dtd that has accompanying stylesheets and/or a significant number of associated files.

Other major packages (such as jade) may also create directories.

When a new directory is created, its name should use only lowercase letters and should not contain any version numbers.