update-catalog

UPDATE-CATALOG(8)                   Debian                   UPDATE-CATALOG(8)

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 central-
       ized 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  re-
       move  (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_cata-
              log.

       --remove
              Removes the entry for the  ordinary_catalog  from  the  central-
              ized_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 modi-
       fied.   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  re-
       moved from the super catalog.

AUTHOR
       Ardo van Rangelrooij <ardo@debian.org>

COPYRIGHT
       Copyright  (C) 2001-2004 Ardo van Rangelrooij Copyright (C) 2012 Helmut
       Grohne

       This is free software; see the GNU General Public Licence version 2  or
       later for copying conditions.  There is no warranty.

Debian Project                     June 2004                 UPDATE-CATALOG(8)