UPDATE-CATALOG
Section: Debian (8)
Updated: June 2004
Index
Return to Main Contents
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.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- SUPER CATALOG
-
- AUTHOR
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 02:38:24 GMT, April 19, 2024