Debian XML Policy (Working Draft)

Edited by

Mark Johnson

Adam Di Carlo

Ardo van Rangelrooij

The latest version of this document can be found at

Status of This Document
Legal Notice

$Date: 2004/04/12 12:36:30 $


Subpolicy for Debian packages that provide and/or make use of XML resources.

Table of Contents

1. About This Document
1.1. Scope
1.1.1. What This Document Addresses
1.1.2. What This Document Does Not Address
1.1.3. Goals of this Policy
1.2. New Versions of This Document
1.3. Authors, Maintainers, and Contributors
2. XML Directory Layout and File Placement
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
3. XML Catalogs
3.1. About XML Catalogs
3.2. The XML Catalog Hierarchy
3.2.1. The Root Catalog: /etc/xml/catalog
3.2.2. Package Catalogs: /etc/xml/package.xml
3.2.3. Local Catalogs: /usr/share/xml/.../package-dir/.../catalog.xml
3.3. Registering/Deregistering Resources
3.3.1. Using dh_installxmlcatalogs with XML Catalogs
3.3.2. Using dh_installcatalogs with SGML Catalogs
4. Caching XML Resources Retrieved from the Network

List of Examples

2.1. Version-numbered Directories for the DocBook XML DTD
2.2. DocBook Stylesheet Directory Layout
2.3. DocBook Website Customization Installation
2.4. docbook Application Directory Layout
3.1. Root Catalog Fragment
3.2. Package Catalog: xml-core
3.3. Package Catalog: docbook-xml
3.4. Package Catalog: docbook-xsl
3.5. Local Catalog: xml-core
3.6. Local Catalog: DocBook XML, V4.2 DTD
3.7. Local Catalog: docbook-xsl
3.8. debian/tei-xlite.xmlcatalogs
3.9. debian/tei-xlite.sgmlcatalogs