Chapter 2. XML Directory Layout and File Placement

Table of Contents

2.1. Terminology
2.2. Symbolic Link Policy for Migration to /usr/share/xml
2.3. General Directory Naming and File Placement Policy
2.3.1. Version-numbered Directories
2.3.2. Non Version-numbered Directories
2.3.3. General Customization Package Directories
2.4. XML Infrastructure Directories
2.4.1. Directory Descriptions
2.5. XML Application Directories
2.5.1. FHS-required Application Directories
2.5.2. Application Directory Layout
2.6. Configuration Files

This chapter describes the directory layout in /usr/share/xml and identifies those directories that are required by the Filesystem Hierarchy Standard (FHS). It also defines the general policies that packagers should follow regarding directory naming and the placement of XML resources.

2.1. Terminology

Before proceeding, it will be helpful to define a few terms, most of which will be described in detail later in this document.

The top-level directories in /usr/share/xml are of two types:

Infrastructure Directories

These four directories are defined as: /usr/share/xml/{declaration, entities, misc, schema}

Application Directories

These are the directories where major applications install their files. Examples are provided by the FHS-required directories: /usr/share/xml/{docbook, mathml, xhtml}

Both types typically have a number of subdirectories.

For the purposes of this document we define one more type of directory:

Package Directory

A package directory is simply the top-level directory where a package installs the majority of its files.