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.