# UPDATE-XMLCATALOG - maintain XML catalog files - man(8) - [phpMan]

[_UPDATE-XMLCATALOG_(8)](https://www.chedong.com/phpMan.php/man/UPDATE-XMLCATALOG/8/markdown)                          xml-core                          [_UPDATE-XMLCATALOG_(8)](https://www.chedong.com/phpMan.php/man/UPDATE-XMLCATALOG/8/markdown)

## NAME
       update-xmlcatalog - maintain XML catalog files

## SYNOPSIS
       **update-xmlcatalog --add --root --package _**package_ **--type _**type_ **--id _**id_

       **update-xmlcatalog --del --root --package _**package_ **--type _**type_ **--id _**id_

       **update-xmlcatalog --add --package _**package_ **--local _**local_ **--type _**type_ **--id _**id_

       **update-xmlcatalog --del --package _**package_ **--local _**local_ **--type _**type_ **--id _**id_

       **update-xmlcatalog --add --local _**local_ **--file _**file_ **--type _**type_ **--id _**id_

       **update-xmlcatalog --del --local _**local_ **--file _**file_ **--type _**type_ **--id _**id_

### update-xmlcatalog --help

## DESCRIPTION
       **update-xmlcatalog **add entries to and removes entries from the root XML catalog file, a
       package XML catalog file or a local XML catalog file.

## OPTIONS
### --add
           Adds  the  entry  to the root XML catalog file, a package XML catalog file or a local XML
           catalog file.  If the XML catalog file does not exist yet, it is automatically created.

### --del
           Deletes the entry from the root XML catalog file, the package XML  catalog  file  or  the
           local  XML catalog file.  A resulting empty XML catalog is not automatically deleted from
           the filesystem.

       **--file _**file_
           Indicates a local filename.

       **--id _**id_
           Indicates the XML catalog file entry identifier.

       **--local _**local_
           Indicates a local XML catalog file.

       **--package _**package_
           Indicates a package XML catalog file.

### --root
           Indicates the root XML catalog file.

       **--type _**type_
           Indicates the XML catalog file entry type (public, system, uri).

### --help
           Displays the usage information.

### --verbose
           Optional switch to make a verbose output.

### --sort
           Optional switch to sort the manipulated catalog content.

           Tip: To sort a catalog without adding or removing an item, just add an  already  existing
           item to the catalog.

## NOTES
       **update-xmlcatalog **is the de-facto standard tool to be used to maintain XML catalog files on a
       Debian system, similar to that [**update-catalog**(8)](https://www.chedong.com/phpMan.php/man/update-catalog/8/markdown) is the standard tool to be used to main SGML
       catalog  files  on a Debian system.  A Debian XML Policy document to this effect is currently
       under development.

       **update-xmlcatalog **and [**xmlcatalog**(1)](https://www.chedong.com/phpMan.php/man/xmlcatalog/1/markdown) are incompatible.  The former has an internal database of
       all the entries in all the XML catalog files it maintains and regenerates the  indicated  XML
       catalog  file  completely  from scratch upon an update.  The latter updates the indicated XML
       catalog file directly.  This means that  any  change  made  to  an  XML  catalog  file  using
       [**xmlcatalog**(1)](https://www.chedong.com/phpMan.php/man/xmlcatalog/1/markdown)  is  overwritten  the  next time that XML catalog file is updated using **update-**
       **xmlcatalog**.

## SEE ALSO
       _/usr/share/doc/xml-core/README.Debian_

## AUTHOR
       **Ardo van Rangelrooij **<<ardo@debian.org>>

perl v5.36.0                                 2023-12-12                         [_UPDATE-XMLCATALOG_(8)](https://www.chedong.com/phpMan.php/man/UPDATE-XMLCATALOG/8/markdown)