'br}

NAME

dh_installxmlcatalogs - install and register XML catalog files

SYNOPSIS

dh_installxmlcatalogs [debhelper options] [-n]

DESCRIPTION

dh_installxmlcatalogs is a debhelper program that installs and registers s-1XMLs0 catalog files. It complies with the Debian s-1XML/SGMLs0 policy.

The file debian/package.xmlcatalogs lists the local s-1XMLs0 catalog files to be installed per package as well as the s-1XMLs0 entities in those local s-1XMLs0 catalog files that are to be registered in the s-1XMLs0 catalog system.

The local s-1XMLs0 catalog file entries in that file should be of the form f(CW*(C`local;source;dest*(C', where the verbatim f(CW*(C`local*(C' indicates this is an entry for a local s-1XMLs0 catalog file, f(CW*(C`source*(C' indicates where the local s-1XMLs0 catalog resides in the source tree, and f(CW*(C`dest*(C' indicates the destination location for the local s-1XMLs0 catalog under the package build area. f(CW*(C`dest*(C' should start with /usr/share/xml/.

The entries for the s-1XMLs0 entities to be registered in the package s-1XMLs0 catalog file should be of the form f(CW*(C`package;type;id;catalog*(C', where the verbatim f(CW*(C`package*(C' indicates this is an entry for an s-1XMLs0 entity to be registered in the package s-1XMLs0 catalog file, f(CW*(C`type*(C' indicates the s-1XMLs0 entity type (public, system, uri), f(CW*(C`id*(C' indicates the s-1XMLs0 entity id, and f(CW*(C`catalog*(C' indicates the local s-1XMLs0 catalog file.

The entries for the s-1XMLs0 entities to be registered in the root s-1XMLs0 catalog file should be of the form f(CW*(C`root;type;id*(C', where the verbatim f(CW*(C`root*(C' indicates this is an entry for an s-1XMLs0 entity to be registered in the root s-1XMLs0 catalog file, f(CW*(C`type*(C' indicates the s-1XMLs0 entity type (public, system, uri), and f(CW*(C`id*(C' indicates the s-1XMLs0 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 f(CW*(C`root-and-package;type;id;catalog*(C', where the verbatim f(CW*(C`root-and-package*(C' indicates this is an entry for an s-1XMLs0 entity to be registered in both the root and package s-1XMLs0 catalog files, f(CW*(C`type*(C' indicates the s-1XMLs0 entity type (public, system, uri), f(CW*(C`id*(C' indicates the s-1XMLs0 entity id, and f(CW*(C`catalog*(C' indicates the local s-1XMLs0 catalog file.

s-1XMLs0 entity types are described in update-xmlcatalog|(8). Using the f(CW*(C`root*(C' or f(CW*(C`package*(C' commands, a type of f(CW*(C`public*(C' will general f(CW*(C`delegatePublic*(C' statements in the applicable catalog file. Generally you will want to use the types f(CW*(C`public*(C' for any formal public identifiers, and f(CW*(C`system*(C' for any files on the local filesystem or URLs. f(CW*(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-1XMLs0 entities in the s-1XMLs0 catalog system (unless -n is used). A dependency on the xml-core package will be added to f(CW*(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.

OPTIONS

\fB-n\fR, \fB--noscripts\fR 4

Do not modify postinst/postrm/prerm scripts.

NOTES

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.

AUTHOR

Ardo van Rangelrooij <ardo@debian.org>