# update-catalog(8) - man - phpman

[UPDATE-CATALOG(8)](https://www.chedong.com/phpMan.php/man/UPDATE-CATALOG/8/markdown)                              Debian                              [UPDATE-CATALOG(8)](https://www.chedong.com/phpMan.php/man/UPDATE-CATALOG/8/markdown)



## NAME
       update-catalog - create or update entry in SGML catalog file

## SYNOPSIS
       **update-catalog** [_options_] **--add** _centralized_catalog_ _ordinary_catalog_

       **update-catalog** [_options_] **--remove** _centralized_catalog_ _ordinary_catalog_

       **update-catalog** [_options_] **--update-super**

## DESCRIPTION
       **update-catalog**  inserts,  updates or removes entries in the SGML centralized catalogs located
       in _/etc/sgml_.  To change the SGML super catalog located in _/etc/sgml/catalog_ modify  the  di‐
       rectory  contents of _/etc/sgml_ to contain new files or symbolic links having a **.cat** extension
       or remove (or move) existing centralized catalogs and regenerate the super catalog using  the
       **--update-super** option.  See section **SUPER** **CATALOG** for details on the generation process.

## OPTIONS
       **--add**  Adds an entry for the _ordinary_catalog_ in the _centralized_catalog_.

### --remove
              Removes the entry for the _ordinary_catalog_ from the _centralized_catalog_.

### --update-super
              Regenerates  the SGML super catalog from the contents of the _/etc/sgml_ directory.  See
              section **SUPER** **CATALOG** for details on the super catalog generation.

### --quiet
              Prevents the usual diagnostic output.

       **--test** Prevents the update of the catalog and writes the resulting SGML catalog  to  standard
              output.

### --version
              Displays the version information and exits.

       **--help** Display the usage information and exits.

## SUPER CATALOG
       The  super-catalog located in _/etc/sgml/catalog_ cannot be directly modified.  It is generated
       by the  _update-catalog_  _--update-super_  command.   The  generation  considers  files  in  the
       _/etc/sgml_  directory  that have a **.cat** extension.  For instance files ending in .old or .dis‐
       abled are not considered.  Before adding a catalog to the super catalog it is parsed and ver‐
       ified in order to not corrupt the super catalog.  All referenced catalogs are verified to ac‐
       tually exist.  If the check fails, a message is printed and the complete catalog is  ignored.
       This check ensures that a catalog from a package, which is removed but not purged, is removed
       from the super catalog.

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

## COPYRIGHT
       Copyright © 2001-2004 Ardo van Rangelrooij Copyright © 2012 Helmut Grohne

       This is free software; see the GNU General Public Licence version 2 or later for copying con‐
       ditions.  There is _no_ warranty.



Debian Project                                June 2004                            [UPDATE-CATALOG(8)](https://www.chedong.com/phpMan.php/man/UPDATE-CATALOG/8/markdown)