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

add an example, a script, a trick and tips

: email address (won't be displayed)
: name

Step 2

Thanks for this example ! - It will be moderated and published shortly.

Feel free to post other examples Oops ! There is a tiny cockup. A damn 404 cockup. Please contact the loosy team who maintains and develops this wonderful site by clicking in the mighty feedback button on the side of the page. Say what happened. Thanks!

examples

no example yet ...

... Feel free to add your own example above to help other Linux-lovers !

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.

copyright

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

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[:at:]debian[:dot:]org>