summaryrefslogtreecommitdiff
path: root/doc/man/install-catalog.8
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/install-catalog.8')
-rw-r--r--doc/man/install-catalog.8112
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.