diff options
Diffstat (limited to 'doc/man/install-catalog.8')
-rw-r--r-- | doc/man/install-catalog.8 | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/doc/man/install-catalog.8 b/doc/man/install-catalog.8 new file mode 100644 index 0000000..8d36b8a --- /dev/null +++ b/doc/man/install-catalog.8 @@ -0,0 +1,112 @@ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "INSTALL-CATALOG" "8" "04 August 2000" "" "" +.SH NAME +install-catalog \- Manage a SGML or XML centralized catalog +.SH SYNOPSIS + +\fBinstall-catalog\fR [ \fBoption \fR] \fBaction \fR\fI ...\fR [ \fB [ -d] [ --delegate] \fR] [ \fB [ -a \fIcentralized\fB \fIordinary\fB] [ --add \fIcentralized\fB \fIordinary\fB] + + [ -r \fIcentralized\fB \fIordinary\fB] [ --remove \fIcentralized\fB \fIordinary\fB] + + [ -h] [ --help] + + [ -v] [ --version] \fR] + +.SH "DESCRIPTION" +.PP +This shell script allows to handle a centralized catalog +referencing other "ordinary" SGML or XML Open Catalogs. +.PP +An \fIOpen Catalog\fR contains +a set of directives defined by OASIS, mostly used +for defining equivalences between FPIs (Formal Public +Identifiers) and real file names (see TR9401:1997 on http://www.oasis-open.org <URL:http://www.oasis-open.org>). +The Open Catalogs usually reside in +\fI/usr/share/sgml\fR. +.PP +A \fIcentralized catalog\fR is a special +Open Catalog that includes only comments and CATALOG directives +pointing to other catalogs (or DELEGATE directives if supported). The +centralized catalog can be the key to all other SGML resources. It +usually resides in \fI/etc/sgml\fR. +.PP +The centralized catalog can be edited manually or through the +\fBinstall-catalog\fR script to add or remove +references to other ordinary catalogs. This script is mainly destined +to software package post-installation scripts. +.PP +An example of a typical call to install-catalog is: + +.nf + install-catalog --add \\ + /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog \\ + /etc/sgml/sgml-docbook-4.0.cat + +.fi +.PP +This call will install in +\fI/etc/sgml/sgml-docbook-4.0.cat\fR a reference to +\fI/usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog\fR. +.SH "OPTIONS" +.PP +Here is the list of options that can influence the way +\fBinstall-catalog\fR works: + + [ \fB [ -d] [ --delegate] \fR] + +.PP +Use DELEGATE instead of CATALOG directives to specify a pointer +.SH "ACTIONS" +.PP +Here is the list of actions that can be requested to +\fBinstall-catalog\fR: + + [ \fB [ -a \fIcentralized\fB \fIordinary\fB] [ --add \fIcentralized\fB \fIordinary\fB] \fR] + +.PP +Declare a new SGML package. + + [ \fB [ -r \fIcentralized\fB \fIordinary\fB] [ --remove \fIcentralized\fB \fIordinary\fB] \fR] + +.PP +Remove a previously installed SGML package. + + [ \fB [ -h] [ --help] \fR] + +.PP +Print a short help message and exit + + [ \fB [ -v] [ --version] \fR] + +.PP +Print the version identifier and exit +.SH "FILES" +\fI/etc/sgml/*\fR +.PP +The SGML centralized catalogs +.SH "AUTHORS" +Eric Bischoff <ebisch@cybercable.tm.fr> +.PP +Developper of install-catalog. +.SH "SEE ALSO" +\fBjw\fR(1) +.PP +conversion from DocBook to other file formats + +\fB\fR + +\fBnsgmls\fR(1) +.PP +a base component of \fBJade\fR DSSSL engine + +\fB\fR + +http://sourceware.cygnus.com/docbook-tools/ <URL:http://sourceware.cygnus.com/docbook-tools/> +.PP +the home page of the DocBook tools, a compendium of +all tools necessary to process DocBook files, including +the SGML-common stuff. |