mirror/libxml2
2
0
Fork 0
mirror of https://github.com/GNOME/libxml2.git synced 2025-04-06 19:20:23 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc/xmlcatalog_man.xml, xmlcatalog.1, xmlcatalog_man.html adding

Browse Source 
Mon Oct  8 20:38:27 MDT 2001 John Fleck <jfleck@inkstain.net>

	* doc/xmlcatalog_man.xml, xmlcatalog.1, xmlcatalog_man.html
	adding documentation for DV's supercatalog support
This commit is contained in:
MDT 2001 John Fleck 2001-10-09 02:41:50 +00:00 committed by John Fleck
parent 82d7533880
commit 60416fa46e
4 changed files with 73 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
Mon Oct 8 20:38:27 MDT 2001 John Fleck <jfleck@inkstain.net>
* doc/xmlcatalog_man.xml, xmlcatalog.1, xmlcatalog_man.html
adding documentation for DV's supercatalog support
Mon Oct 8 17:00:16 CEST 2001 Daniel Veillard <daniel@veillard.com>
* include/libxml/catalog.h catalog.c xmlcatalog.c: adding SGML

5
doc/xmlcatalog.1
View File

@ -47,7 +47,10 @@ Create a new XML catalog. Outputs to stdout, ignoring \fIfilename\fR unless \fB-
.TP
\fB--add\fR \fI'type'\fR \fI'orig'\fR \fI'replace'\fR \fIfilename\fR
Add an entry to catalog file \fIfilename\fR. \fItype\fR indicates the type of entry. Possible types are 'public', 'system', 'rewriteSystem', 'delegatePublic' and 'delegateSystem'. \fI'orig'\fR is the original reference to be replaced, and \fI'replace'\fR is the URI of the replacement entity to be used. The \fB-add\fR option will not overwrite \fIfilename\fR, outputing to stdout, unless \fB--noout\fR 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.
Add an entry to catalog file \fIfilename\fR. \fItype\fR indicates the type of entry. Possible types are 'public', 'system', 'rewriteSystem', 'delegatePublic' and 'delegateSystem'. \fI'orig'\fR is the original reference to be replaced, and \fI'replace'\fR is the URI of the replacement entity to be used. The \fB--add\fR option will not overwrite \fIfilename\fR, outputing to stdout, unless \fB--noout\fR 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.
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 SGML supercatalog, a file that contains references to other included SGML catalog files.
.TP
\fB--del\fR \fI'values'\fR \fIfilename\fR

114
doc/xmlcatalog_man.html
View File

@ -9,7 +9,7 @@
<h1 class="title">
<a name="id2703858"></a>xmlcatalog</h1>
<div class="refnamediv">
<a name="id2707811"></a><h2>Name</h2>xmlcatalog &#x2014; Command line tool to parse and manipulate XML or
<a name="id2707811"></a><h2>Name</h2>xmlcatalog &#8212; Command line tool to parse and manipulate XML or
SGML catalog files.</div>
<div class="refsynopsisdiv">
<a name="id2707831"></a><h2>Synopsis</h2>
@ -39,28 +39,26 @@
<dt>
<a name="id2705356"></a><span class="term"><tt>--shell</tt> <i><tt>filename</tt></i></span>
</dt>
<dd><p>
<a name="id2705369"></a>
<dd>
Run a shell
allowing interactive queries on catalog file
<i><tt>filename</tt></i>.
</p></dd>
</dd>
<dt>
<a name="id2705383"></a><span class="term"><tt>--create</tt> <i><tt>filename</tt></i></span>
</dt>
<dd><p>
<a name="id2705396"></a>
<dd>
Create a new
XML catalog. Outputs to stdout, ignoring
<i><tt>filename</tt></i> unless <tt>--noout</tt> is
used, in which case it creates a new catalog file
<i><tt>filename</tt></i>.
</p></dd>
</dd>
<dt>
<a name="id2705423"></a><span class="term"><tt>--add</tt> <i><tt>'type'</tt></i> <i><tt>'orig'</tt></i> <i><tt>'replace'</tt></i> <i><tt>filename</tt></i></span>
</dt>
<dd><p>
<a name="id2705448"></a>
<dd>
<p>
Add an entry to catalog file
<tt>filename</tt>. <i><tt>type</tt></i> indicates
the type of entry. Possible types are 'public', 'system', 'rewriteSystem',
@ -68,40 +66,46 @@
is the original reference to
be replaced, and <i><tt>'replace'</tt></i> is the
URI of the replacement entity to be used. The
<tt>-add</tt> option will not overwrite
<tt>--add</tt> option will not overwrite
<i><tt>filename</tt></i>, outputing to stdout, unless
<tt>--noout</tt> is used. The <tt>--add</tt> will always
take three parameters even if some of the XML catalog
constructs will have only a single argument.
</p></dd>
</p>
<p>
If the <tt>--add</tt> option is used following the
<tt>--sgml</tt> option, only a single argument, a
<i><tt>filename</tt></i>, 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.
</p>
</dd>
<dt>
<a name="id2708138"></a><span class="term"><tt>--del</tt> <i><tt>'values'</tt></i> <i><tt>filename</tt></i></span>
<a name="id2708168"></a><span class="term"><tt>--del</tt> <i><tt>'values'</tt></i> <i><tt>filename</tt></i></span>
</dt>
<dd><p>
<a name="id2708155"></a>
<dd>
Remove entries from the catalog file
<i><tt>filename</tt></i> matching
<i><tt>'values'</tt></i>. The <tt>--del</tt> option
will not overwrite <i><tt>filename</tt></i>, outputing to
stdout, unless <tt>--noout</tt> is used.
</p></dd>
</dd>
<dt>
<a name="id2708187"></a><span class="term"><tt>--noout</tt></span>
<a name="id2708217"></a><span class="term"><tt>--noout</tt></span>
</dt>
<dd><p>
<a name="id2708196"></a>
<dd>
Save output to the named file rather than
outputing to stdout.
</p></dd>
</dd>
<dt>
<a name="id2708207"></a><span class="term"><tt>-v</tt> or <tt>--verbose</tt></span>
<a name="id2708237"></a><span class="term"><tt>-v</tt> or <tt>--verbose</tt></span>
</dt>
<dd><p>
<a name="id2708220"></a>
<dd>
output debugging
information.
</p></dd>
</dd>
</dl></div>
</div>
<div class="refsect1">
@ -115,30 +119,27 @@
</p>
<div class="variablelist"><dl>
<dt>
<a name="id2708274"></a><span class="term"><tt>public</tt> <i><tt>'PublicID'</tt></i></span>
<a name="id2708304"></a><span class="term"><tt>public</tt> <i><tt>'PublicID'</tt></i></span>
</dt>
<dd><p>
<a name="id2708287"></a>
<dd>
Execute a
public identifier lookup of the catalog entry for
<i><tt>'PublicID'</tt></i>. The corresponding entry will be
output to the command line.
</p></dd>
</dd>
<dt>
<a name="id2708302"></a><span class="term"><tt>system</tt> <i><tt>'SystemID'</tt></i></span>
<a name="id2708332"></a><span class="term"><tt>system</tt> <i><tt>'SystemID'</tt></i></span>
</dt>
<dd><p>
<a name="id2708315"></a>
<dd>
Execute a
public identifier lookup of the catalog entry for
<i><tt>'SystemID'</tt></i>. The corresponding entry will be
output to the command line.
</p></dd>
</dd>
<dt>
<a name="id2708331"></a><span class="term"><tt>add </tt> <i><tt>'type'</tt></i> <i><tt>'orig'</tt></i> <i><tt>'replace'</tt></i></span>
<a name="id2708361"></a><span class="term"><tt>add </tt> <i><tt>'type'</tt></i> <i><tt>'orig'</tt></i> <i><tt>'replace'</tt></i></span>
</dt>
<dd><p>
<a name="id2708352"></a>
<dd>
Add an entry to the catalog
file. <i><tt>type</tt></i> indicates the type of
entry. Possible types are 'public', 'system', 'rewriteSystem',
@ -146,44 +147,39 @@
is the original reference to be replaced, and
<i><tt>'replace'</tt></i> is the URI of the
replacement entity to be used.
</p></dd>
</dd>
<dt>
<a name="id2708383"></a><span class="term"><tt>del</tt> <i><tt>'values'</tt></i></span>
<a name="id2708681"></a><span class="term"><tt>del</tt> <i><tt>'values'</tt></i></span>
</dt>
<dd><p>
<a name="id2708396"></a>
<dd>
Remove the
catalog entry corresponding to <i><tt>'values'</tt></i>.
</p></dd>
</dd>
<dt>
<a name="id2705468"></a><span class="term"><tt>dump</tt></span>
<a name="id2708708"></a><span class="term"><tt>dump</tt></span>
</dt>
<dd><p>
<a name="id2705478"></a>
<dd>
Print the current catalog.
</p></dd>
</dd>
<dt>
<a name="id2708682"></a><span class="term"><tt>debug</tt></span>
<a name="id2708728"></a><span class="term"><tt>debug</tt></span>
</dt>
<dd><p>
<a name="id2708691"></a>
<dd>
Print debugging statements showing the steps
xmlcatalog is executing.
</p></dd>
</dd>
<dt>
<a name="id2708708"></a><span class="term"><tt>quiet</tt></span>
<a name="id2708755"></a><span class="term"><tt>quiet</tt></span>
</dt>
<dd><p>
<a name="id2708717"></a>
<dd>
Stop printing debugging statements.
</p></dd>
</dd>
<dt>
<a name="id2708728"></a><span class="term"><tt>exit</tt></span>
<a name="id2708774"></a><span class="term"><tt>exit</tt></span>
</dt>
<dd><p>
<a name="id2708737"></a>
<dd>
Quit the shell.
</p></dd>
</dd>
</dl></div>
</div>
<div class="refsect1">
@ -191,25 +187,25 @@
<a name="references"></a>References</h2>
<div class="variablelist"><dl>
<dt>
<a name="id2708766"></a><span class="term">libxml web page:</span>
<a name="id2708813"></a><span class="term">libxml web page:</span>
</dt>
<dd>
<a href="http://www.xmlsoft.org/" target="_top">http://www.xmlsoft.org/</a>
</dd>
<dt>
<a name="id2708794"></a><span class="term">libxml catalog support web page:</span>
<a name="id2708841"></a><span class="term">libxml catalog support web page:</span>
</dt>
<dd>
<a href="http://www.xmlsoft.org/catalog.html" target="_top">http://www.xmlsoft.org/catalog.html</a>
</dd>
<dt>
<a name="id2708828"></a><span class="term">James Clark's SGML catalog page:</span>
<a name="id2708875"></a><span class="term">James Clark's SGML catalog page:</span>
</dt>
<dd>
<a href="http://www.jclark.com/sp/catalog.htm" target="_top">http://www.jclark.com/sp/catalog.htm</a>
</dd>
<dt>
<a name="id2708861"></a><span class="term">OASIS XML catalog specification:</span>
<a name="id2708909"></a><span class="term">OASIS XML catalog specification:</span>
</dt>
<dd>
<a href="http://www.oasis-open.org/committees/entity/spec.html" target="_top">http://www.oasis-open.org/committees/entity/spec.html</a>

10
doc/xmlcatalog_man.xml
View File

@ -110,7 +110,7 @@
is the original reference to
be replaced, and <replaceable>'replace'</replaceable> is the
<acronym>URI</acronym> of the replacement entity to be used. The
<option>-add</option> option will not overwrite
<option>--add</option> option will not overwrite
<replaceable>filename</replaceable>, outputing to stdout, unless
<option>--noout</option> is used. The <option>--add</option> will always
take three parameters even if some of the <acronym>XML</acronym> catalog
@ -119,6 +119,14 @@
FIXME - Is my list of possible types correct? Are SGML types the same?
-->
</simpara>
<simpara>
If the <option>--add</option> option is used following the
<option>--sgml</option> option, only a single argument, a
<replaceable>filename</replaceable>, is used. This is used to add
the name of a catalog file to an <acronym>SGML</acronym>
supercatalog, a file that contains references to other included
<acronym>SGML</acronym> catalog files.
</simpara>
</listitem>
</varlistentry>
<varlistentry>