Install and register xml catalog files
dh_installxmlcatalogs [debhelper options] [-n]
dh_installxmlcatalogs is a debhelper program that installs and registers \s-1XML\s0 catalog files. It complies with the Debian \s-1XML/SGML\s0 policy.
The file debian/package.xmlcatalogs lists the local \s-1XML\s0 catalog files to be installed per package as well as the \s-1XML\s0 entities in those local \s-1XML\s0 catalog files that are to be registered in the \s-1XML\s0 catalog system.
The local \s-1XML\s0 catalog file entries in that file should be of the form \*(C`local;source;dest\*(C', where the verbatim \*(C`local\*(C' indicates this is an entry for a local \s-1XML\s0 catalog file, \*(C`source\*(C' indicates where the local \s-1XML\s0 catalog resides in the source tree, and \*(C`dest\*(C' indicates the destination location for the local \s-1XML\s0 catalog under the package build area. \*(C`dest\*(C' should start with /usr/share/xml/.
The entries for the \s-1XML\s0 entities to be registered in the package \s-1XML\s0 catalog file should be of the form \*(C`package;type;id;catalog\*(C', where the verbatim \*(C`package\*(C' indicates this is an entry for an \s-1XML\s0 entity to be registered in the package \s-1XML\s0 catalog file, \*(C`type\*(C' indicates the \s-1XML\s0 entity type (public, system, uri), \*(C`id\*(C' indicates the \s-1XML\s0 entity id, and \*(C`catalog\*(C' indicates the local \s-1XML\s0 catalog file.
The entries for the \s-1XML\s0 entities to be registered in the root \s-1XML\s0 catalog file should be of the form \*(C`root;type;id\*(C', where the verbatim \*(C`root\*(C' indicates this is an entry for an \s-1XML\s0 entity to be registered in the root \s-1XML\s0 catalog file, \*(C`type\*(C' indicates the \s-1XML\s0 entity type (public, system, uri), and \*(C`id\*(C' indicates the \s-1XML\s0 entity id.
If an entry for is to be registered identically in the root catalog and the package catalog file, you can use the form \*(C`root-and-package;type;id;catalog\*(C', where the verbatim \*(C`root-and-package\*(C' indicates this is an entry for an \s-1XML\s0 entity to be registered in both the root and package \s-1XML\s0 catalog files, \*(C`type\*(C' indicates the \s-1XML\s0 entity type (public, system, uri), \*(C`id\*(C' indicates the \s-1XML\s0 entity id, and \*(C`catalog\*(C' indicates the local \s-1XML\s0 catalog file.
\s-1XML\s0 entity types are described in update-xmlcatalog\|(8). Using the \*(C`root\*(C' or \*(C`package\*(C' commands, a type of \*(C`public\*(C' will general \*(C`delegatePublic\*(C' statements in the applicable catalog file. Generally you will want to use the types \*(C`public\*(C' for any formal public identifiers, and \*(C`system\*(C' for any files on the local filesystem or URLs. \*(C`uri\*(C' is only used for non-local files which are not part of the external document subset, e.g., they are not used for entities or DTDs.
dh_installxmlcatalogs automatically adds maintainer script snippets for the registration and unregistration of the listed \s-1XML\s0 entities in the \s-1XML\s0 catalog system (unless -n is used). A dependency on the xml-core package will be added to \*(C`${misc:Depends}\*(C', so be sure to use that variable in the file debian/control. See dh_installdeb\|(1) for an explanation of Debhelper maintainer script snippets.
Do not modify postinst/postrm/prerm scripts.
Note that this command is not idempotent. \*(L"dh_clean -k\*(R" should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.
debhelper\|(7)
/usr/share/doc/xml-core/
Ardo van Rangelrooij <[email protected]>
Adam Di Carlo <[email protected]>