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)