summaryrefslogtreecommitdiff
path: root/doc/xmlcatalog.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/xmlcatalog.1')
-rw-r--r--doc/xmlcatalog.1297
1 files changed, 204 insertions, 93 deletions
diff --git a/doc/xmlcatalog.1 b/doc/xmlcatalog.1
index 2f9287e..b4a6b22 100644
--- a/doc/xmlcatalog.1
+++ b/doc/xmlcatalog.1
@@ -1,120 +1,160 @@
-.\" ** You probably do not want to edit this file directly **
-.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
-.\" Instead of manually editing it, you probably should edit the DocBook XML
-.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "XMLCATALOG" "1" "$Date$" "libxml2" ""
+'\" t
+.\" Title: xmlcatalog
+.\" Author: John Fleck <jfleck@inkstain.net>
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\" Date: $Date$
+.\" Manual: xmlcatalog Manual
+.\" Source: libxml2
+.\" Language: English
+.\"
+.TH "XMLCATALOG" "1" "$Date$" "libxml2" "xmlcatalog Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
.SH "NAME"
-xmlcatalog \- Command line tool to parse and manipulate XML or SGML catalog files.
+xmlcatalog \- Command line tool to parse and manipulate XML or SGML catalog files\&.
.SH "SYNOPSIS"
-.HP 11
-\fBxmlcatalog\fR [\fB\-\-sgml\fR \fB\-\-shell\fR \fB\-\-create\fR \fB\-\-del\ \fR\fB\fIVALUE(S)\fR\fR [\ \fB\-\-add\ \fR\fB\fITYPE\fR\fR\fB\ \fR\fB\fIORIG\fR\fR\fB\ \fR\fB\fIREPLACE\fR\fR\fB\ \fR\ \fB\-\-add\ \fR\fB\fIFILENAME\fR\fR] \fB\-\-noout\fR \fB\-\-no\-super\-update\fR [\fB\-v\fR\ \fB\-\-verbose\fR]] {\fICATALOGFILE\fR} {\fIENTITIES\fR...}
+.HP \w'\fBxmlcatalog\fR\ 'u
+\fBxmlcatalog\fR [\fB\-\-sgml\fR | \fB\-\-shell\fR | \fB\-\-create\fR | \fB\-\-del\ \fR\fB\fIVALUE(S)\fR\fR | [\ \fB\-\-add\ \fR\fB\fITYPE\fR\fR\fB\ \fR\fB\fIORIG\fR\fR\fB\ \fR\fB\fIREPLACE\fR\fR\fB\ \fR\ |\ \fB\-\-add\ \fR\fB\fIFILENAME\fR\fR] | \fB\-\-noout\fR | \fB\-\-no\-super\-update\fR | [\fB\-v\fR\ |\ \fB\-\-verbose\fR]] {\fICATALOGFILE\fR} {\fIENTITIES\fR...}
.SH "DESCRIPTION"
.PP
+
\fBxmlcatalog\fR
is a command line application allowing users to monitor and manipulate
XML
and
SGML
-catalogs. It is included in
-\fBlibxml\fR(3).
+catalogs\&. It is included in
+\fBlibxml\fR(3)\&.
.PP
-Its functions can be invoked from a single command from the command line, or it can perform multiple functions in interactive mode. It can operate on both
+Its functions can be invoked from a single command from the command line, or it can perform multiple functions in interactive mode\&. It can operate on both
XML
and
SGML
-files.
+files\&.
.SH "OPTIONS"
.PP
+
\fBxmlcatalog\fR
accepts the following options (in alphabetical order):
-.TP
+.PP
\fB\-\-add \fR\fB\fITYPE\fR\fR\fB \fR\fB\fIORIG\fR\fR\fB \fR\fB\fIREPLACE\fR\fR\fB \fR
+.RS 4
Add an entry to
-\fICATALOGFILE\fR.
+CATALOGFILE\&.
\fITYPE\fR
-indicates the type of entry. Possible types are:
-\fIpublic\fR, \fIsystem\fR, \fIrewriteSystem\fR, \fIrewriteURI\fR, \fIdelegatePublic\fR, \fIdelegateSystem\fR, \fInextCatalog\fR.
+indicates the type of entry\&. Possible types are:
+\fIpublic\fR, \fIsystem\fR, \fIuri\fR, \fIrewriteSystem\fR, \fIrewriteURI\fR, \fIdelegatePublic\fR, \fIdelegateSystem\fR, \fIdelegateURI\fR, \fInextCatalog\fR\&.
\fIORIG\fR
is the original reference to be replaced, and
\fIREPLACE\fR
is the
URI
-of the replacement entity to be used. The
+of the replacement entity to be used\&. The
\fB\-\-add\fR
option will not overwrite
-\fICATALOGFILE\fR, outputting to
-\fIstdout\fR, unless
+CATALOGFILE, outputting to
+stdout, unless
\fB\-\-noout\fR
-is used. The
+is used\&. The
\fB\-\-add\fR
will always take three parameters even if some of the
XML
-catalog constructs will have only a single argument.
-.TP
+catalog constructs will have only a single argument\&.
+.RE
+.PP
\fB\-\-add \fR\fB\fIFILENAME\fR\fR
+.RS 4
If the
\fB\-\-add\fR
option is used following the
\fB\-\-sgml\fR
option, only a single argument, a
-\fIFILENAME\fR, is used. This is used to add the name of a catalog file to an
+\fIFILENAME\fR, is used\&. This is used to add the name of a catalog file to an
SGML
supercatalog, a file that contains references to other included
SGML
-catalog files.
-.TP
+catalog files\&.
+.RE
+.PP
\fB\-\-create\fR
+.RS 4
Create a new
XML
-catalog. Outputs to
-\fIstdout\fR, ignoring
+catalog\&. Outputs to
+stdout, ignoring
\fIfilename\fR
unless
\fB\-\-noout\fR
is used, in which case it creates a new catalog file
-\fIfilename\fR.
-.TP
+\fIfilename\fR\&.
+.RE
+.PP
\fB\-\-del \fR\fB\fIVALUE(S)\fR\fR
+.RS 4
Remove entries from
\fICATALOGFILE\fR
matching
-\fIVALUE(S)\fR. The
+\fIVALUE(S)\fR\&. The
\fB\-\-del\fR
option will not overwrite
\fICATALOGFILE\fR, outputting to
-\fIstdout\fR, unless
+stdout, unless
\fB\-\-noout\fR
-is used.
-.TP
+is used\&.
+.RE
+.PP
\fB\-\-noout\fR
+.RS 4
Save output to the named file rather than outputting to
-\fIstdout\fR.
-.TP
+stdout\&.
+.RE
+.PP
\fB\-\-no\-super\-update\fR
+.RS 4
Do not update the
SGML
-super catalog.
-.TP
+super catalog\&.
+.RE
+.PP
\fB\-\-shell\fR
+.RS 4
Run a shell allowing interactive queries on catalog file
-\fICATALOGFILE\fR. For the set of available commands see
-the section called \(lqSHELL COMMANDS\(rq.
-.TP
+\fICATALOGFILE\fR\&. For the set of available commands see
+the section called \(lqSHELL COMMANDS\(rq\&.
+.RE
+.PP
\fB\-\-sgml\fR
+.RS 4
Uses
SGML
super catalogs for
\fB\-\-add\fR
and
\fB\-\-del\fR
-options.
-.TP
+options\&.
+.RE
+.PP
\fB\-v\fR, \fB\-\-verbose\fR
-Output debugging information.
+.RS 4
+Output debugging information\&.
+.RE
.SH "SHELL COMMANDS"
.PP
Invoking
@@ -122,108 +162,179 @@ Invoking
with the
\fB\-\-shell \fR\fB\fICATALOGFILE\fR\fR
option opens a command line shell allowing interactive access to the catalog file identified by
-\fICATALOGFILE\fR. Invoking the shell provides a command line prompt after which the following commands (described in alphabetical order) can be entered.
-.TP
+\fICATALOGFILE\fR\&. Invoking the shell provides a command line prompt after which the following commands (described in alphabetical order) can be entered\&.
+.PP
\fBadd \fR\fB\fITYPE\fR\fR\fB \fR\fB\fIORIG\fR\fR\fB \fR\fB\fIREPLACE\fR\fR\fB \fR
-Add an entry to the catalog file.
+.RS 4
+Add an entry to the catalog file\&.
\fITYPE\fR
-indicates the type of entry. Possible types are:
-\fIpublic\fR, \fIsystem\fR, \fIrewriteSystem\fR, \fIrewriteURI\fR, \fIdelegatePublic\fR, \fIdelegateSystem\fR, \fInextCatalog\fR.
+indicates the type of entry\&. Possible types are:
+\fIpublic\fR, \fIsystem\fR, \fIuri\fR, \fIrewriteSystem\fR, \fIrewriteURI\fR, \fIdelegatePublic\fR, \fIdelegateSystem\fR, \fIdelegateURI\fR, \fInextCatalog\fR\&.
\fIORIG\fR
is the original reference to be replaced, and
\fIREPLACE\fR
is the
URI
-of the replacement entity to be used. The
+of the replacement entity to be used\&. The
\fB\-\-add\fR
option will not overwrite
-\fICATALOGFILE\fR, outputting to
-\fIstdout\fR, unless
+CATALOGFILE, outputting to
+stdout, unless
\fB\-\-noout\fR
-is used. The
+is used\&. The
\fB\-\-add\fR
will always take three parameters even if some of the
XML
-catalog constructs will have only a single argument.
-.TP
+catalog constructs will have only a single argument\&.
+.RE
+.PP
\fBdebug\fR
+.RS 4
Print debugging statements showing the steps
\fBxmlcatalog\fR
-is executing.
-.TP
+is executing\&.
+.RE
+.PP
\fBdel \fR\fB\fIVALUE(S)\fR\fR
+.RS 4
Remove the catalog entry corresponding to
-\fIVALUE(S)\fR.
-.TP
+\fIVALUE(S)\fR\&.
+.RE
+.PP
\fBdump\fR
-Print the current catalog.
-.TP
+.RS 4
+Print the current catalog\&.
+.RE
+.PP
\fBexit\fR
-Quit the shell.
-.TP
+.RS 4
+Quit the shell\&.
+.RE
+.PP
\fBpublic \fR\fB\fIPUBLIC\-ID\fR\fR
+.RS 4
Execute a Formal Public Identifier look\-up of the catalog entry for
-\fIPUBLIC\-ID\fR. The corresponding entry will be output to the command line.
-.TP
+\fIPUBLIC\-ID\fR\&. The corresponding entry will be output to the command line\&.
+.RE
+.PP
\fBquiet\fR
-Stop printing debugging statements.
-.TP
+.RS 4
+Stop printing debugging statements\&.
+.RE
+.PP
\fBsystem \fR\fB\fISYSTEM\-ID\fR\fR
+.RS 4
Execute a Formal Public Identifier look\-up of the catalog entry for
-\fISYSTEM\-ID\fR. The corresponding entry will be output to the command line.
+\fISYSTEM\-ID\fR\&. The corresponding entry will be output to the command line\&.
+.RE
.SH "ENVIRONMENT"
-.TP
+.PP
\fBXML_CATALOG_FILES\fR
+.RS 4
XML
-catalog behavior can be changed by redirecting queries to the user's own set of catalogs. This can be done by setting the
+catalog behavior can be changed by redirecting queries to the user\*(Aqs own set of catalogs\&. This can be done by setting the
\fBXML_CATALOG_FILES\fR
-environment variable to a list of catalogs. An empty one should deactivate loading the default
-\fI/etc/xml/catalog\fR
-catalog.
+environment variable to a list of catalogs\&. An empty one should deactivate loading the default
+/etc/xml/catalog
+catalog\&.
+.RE
.SH "DIAGNOSTICS"
.PP
+
\fBxmlcatalog\fR
-return codes provide information that can be used when calling it from scripts.
-.TP
+return codes provide information that can be used when calling it from scripts\&.
+.PP
\fB0\fR
+.RS 4
No error
-.TP
+.RE
+.PP
\fB1\fR
+.RS 4
Failed to remove an entry from the catalog
-.TP
+.RE
+.PP
\fB2\fR
+.RS 4
Failed to save to the catalog, check file permissions
-.TP
+.RE
+.PP
\fB3\fR
+.RS 4
Failed to add an entry to the catalog
-.TP
+.RE
+.PP
\fB4\fR
+.RS 4
Failed to look up an entry in the catalog
+.RE
.SH "SEE ALSO"
.PP
\fBlibxml\fR(3)
.PP
More information can be found at
-.TP 3
-\(bu
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
\fBlibxml\fR(3)
web page
-\fI\%http://www.xmlsoft.org/\fR
-.TP
-\(bu
+\m[blue]\fB\%http://www.xmlsoft.org/\fR\m[]
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
\fBlibxml\fR(3)
catalog support web page at
-\fI\%http://www.xmlsoft.org/catalog.html\fR
-.TP
-\(bu
-James Clark's
+\m[blue]\fB\%http://www.xmlsoft.org/catalog.html\fR\m[]
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+James Clark\*(Aqs
SGML
catalog page
-\fI\%http://www.jclark.com/sp/catalog.htm\fR
-.TP
-\(bu
-OASISXML
+\m[blue]\fB\%http://www.jclark.com/sp/catalog.htm\fR\m[]
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+OASIS
+XML
catalog specification
-\fI\%http://www.oasis\-open.org/committees/entity/spec.html\fR
+\m[blue]\fB\%http://www.oasis-open.org/committees/entity/spec.html\fR\m[]
+.RE
+.sp
.SH "AUTHOR"
-John Fleck <jfleck@inkstain.net>.
+.PP
+\fBJohn Fleck\fR <\&jfleck@inkstain\&.net\&>
+.RS 4
+Author.
+.RE
+.SH "COPYRIGHT"
+.br
+Copyright \(co 2001, 2004
+.br