dh_installxmlcatalogs
Install XML catalog files into Debian packages
SYNOPSIS
dh_installxmlcatalogs [options]
PARAMETERS
-n
Act on the package named
-p
Same as -n
-i
Replace rather than merge with entries from other packages.
-a
Act on all binary packages listed in debian/control.
-N package
Do not act on the specified binary package.
-X item
Exclude files that contain item anywhere in their filename from being installed.
-d directory
Look in directory instead of debian/package for files to install.
DESCRIPTION
dh_installxmlcatalogs is a debhelper command that installs XML catalog files (`.xml` files pointing to XML schemas or DTDs) into the appropriate locations within a Debian package during the package build process. It helps manage and register XML catalogs, making them accessible to applications that use XML schema validation or entity resolution. It automates the installation of XML catalog files listed in `debian/package.xmlcatalogs` or `debian/xmlcatalogs` for each given package. This command is designed to ease the process of managing XML catalog files, particularly when multiple packages need to share or use the same XML catalogs. It will generate `etc/xml/catalog` entries. If no files are specified, it will look for `.xml` files in debian/$package/. This is especially useful for packages providing XML infrastructure or utilizing XML schemas.
dh_installxmlcatalogs simplifies the package maintainer's work by handling the details of catalog registration according to Debian policy, ensuring that XML catalogs are correctly installed and available for applications using them.
FILES
debian/package.xmlcatalogs: List of XML catalog files to install. Each line should specify the filename of an XML catalog file to install. If `debian/xmlcatalogs` exists it is preferred over `debian/package.xmlcatalogs`.
EXAMPLES
To install all `.xml` catalog files in the `debian/package/` directory:dh_installxmlcatalogs
To install `catalog1.xml` and `catalog2.xml` into the package:
Add the following to debian/package.xmlcatalogs:catalog1.xml
catalog2.xml
SEE ALSO
debhelper(7)