Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

update-catalog(8) [debian man page]

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 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 (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)

Check Out this Related Man Page

UPDATE-XMLCATALOG(8)						     xml-core						      UPDATE-XMLCATALOG(8)

NAME
update-xmlcatalog - maintain XML catalog files SYNOPSIS
update-xmlcatalog --add --root --package package --type type --id id update-xmlcatalog --del --root --package package --type type --id id update-xmlcatalog --add --package package --local local --type type --id id update-xmlcatalog --del --package package --local local --type type --id id update-xmlcatalog --add --local local --file file --type type --id id update-xmlcatalog --del --local local --file file --type type --id id update-xmlcatalog --help DESCRIPTION
update-xmlcatalog add entries to and removes entries from the root XML catalog file, a package XML catalog file or a local XML catalog file. OPTIONS
--add Adds the entry to the root XML catalog file, a package XML catalog file or a local XML catalog file. If the XML catalog file does not exist yet, it is automatically created. --del Deletes the entry from the root XML catalog file, the package XML catalog file or the local XML catalog file. A resulting empty XML catalog is not automatically deleted from the filesystem. --file file Indicates a local filename. --id id Indicates the XML catalog file entry identifier. --local local Indicates a local XML catalog file. --package package Indicates a package XML catalog file. --root Indicates the root XML catalog file. --type type Indicates the XML catalog file entry type (public, system, uri). --help Displays the usage information. NOTES
update-xmlcatalog is the de-facto standard tool to be used to maintain XML catalog files on a Debian system, similar to that update-catalog(8) is the standard tool to be used to main SGML catalog files on a Debian system. A Debian XML Policy document to this effect is currently under development. update-xmlcatalog and xmlcatalog(1) are incompatible. The former has an internal database of all the entries in all the XML catalog files it maintains and regenerates the indicated XML catalog file completely from scratch upon an update. The latter updates the indicated XML catalog file directly. This means that any change made to an XML catalog file using xmlcatalog(1) is overwritten the next time that XML catalog file is updated using update-xmlcatalog. SEE ALSO
/usr/share/doc/xml-core/README.Debian AUTHOR
Ardo van Rangelrooij <ardo@debian.org> perl v5.10.0 2008-10-14 UPDATE-XMLCATALOG(8)
Man Page