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 directory 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
       .disabled  are  not considered.  Before adding a catalog to the super catalog it is parsed
       and verified in order to not corrupt the  super  catalog.   All  referenced  catalogs  are
       verified  to  actually  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
       conditions.  There is no warranty.