FM / libxml2-devel

/usr/share/doc/libxml2-devel

Name	Size	Mode	Actions
examples/	-	0755	rm
html/	-	0755	rm
tutorial/	-	0755	rm
APIchunk0.html	30273	0644	edit dl rm
APIchunk1.html	37493	0644	edit dl rm
APIchunk2.html	40658	0644	edit dl rm
APIchunk3.html	36193	0644	edit dl rm
APIchunk4.html	36188	0644	edit dl rm
APIchunk5.html	29904	0644	edit dl rm
APIchunk6.html	29020	0644	edit dl rm
APIchunk7.html	32847	0644	edit dl rm
APIchunk8.html	30225	0644	edit dl rm
APIchunk9.html	28698	0644	edit dl rm
APIchunk10.html	64326	0644	edit dl rm
APIchunk11.html	33227	0644	edit dl rm
APIchunk12.html	87887	0644	edit dl rm
APIchunk13.html	61787	0644	edit dl rm
APIchunk14.html	45412	0644	edit dl rm
APIchunk15.html	44236	0644	edit dl rm
APIchunk16.html	36364	0644	edit dl rm
APIchunk17.html	54153	0644	edit dl rm
APIchunk18.html	42840	0644	edit dl rm
APIchunk19.html	36657	0644	edit dl rm
APIchunk20.html	32781	0644	edit dl rm
APIchunk21.html	37791	0644	edit dl rm
APIchunk22.html	57957	0644	edit dl rm
APIchunk23.html	63797	0644	edit dl rm
APIchunk24.html	94529	0644	edit dl rm
APIchunk25.html	41730	0644	edit dl rm
APIchunk26.html	32181	0644	edit dl rm
APIchunk27.html	33982	0644	edit dl rm
APIchunk28.html	58059	0644	edit dl rm
APIchunk29.html	13413	0644	edit dl rm
APIconstructors.html	59500	0644	edit dl rm
APIfiles.html	328329	0644	edit dl rm
APIfunctions.html	216982	0644	edit dl rm
APIsymbols.html	325569	0644	edit dl rm
architecture.html	6863	0644	edit dl rm
bugs.html	10245	0644	edit dl rm
catalog.gif	6105	0644	edit dl rm
catalog.html	23646	0644	edit dl rm
contribs.html	7678	0644	edit dl rm
docs.html	7625	0644	edit dl rm
DOM.gif	3166	0644	edit dl rm
DOM.html	6617	0644	edit dl rm
downloads.html	8269	0644	edit dl rm
encoding.html	19414	0644	edit dl rm
entities.html	9443	0644	edit dl rm
example.html	13105	0644	edit dl rm
FAQ.html	21140	0644	edit dl rm
guidelines.html	17662	0644	edit dl rm
help.html	6321	0644	edit dl rm
index.html	10669	0644	edit dl rm
interface.html	8211	0644	edit dl rm
intro.html	7207	0644	edit dl rm
library.html	14995	0644	edit dl rm
libxml.gif	7692	0644	edit dl rm
libxml2-api.xml.gz	161757	0644	edit dl rm
Libxml2-Logo-90x34.gif	3070	0644	edit dl rm
Libxml2-Logo-180x168.gif	8195	0644	edit dl rm
namespaces.html	8337	0644	edit dl rm
news.html	167305	0644	edit dl rm
python.html	19936	0644	edit dl rm
redhat.gif	697	0644	edit dl rm
searches.html	7559	0644	edit dl rm
smallfootonly.gif	2772	0644	edit dl rm
structure.gif	5559	0644	edit dl rm
threads.html	7113	0644	edit dl rm
tree.html	7911	0644	edit dl rm
upgrade.html	12664	0644	edit dl rm
w3c.png	2028	0644	edit dl rm
xml.html	308976	0644	edit dl rm
xmlcatalog_man.html	13923	0644	edit dl rm
xmldtd.html	13645	0644	edit dl rm
XMLinfo.html	6797	0644	edit dl rm
xmlio.html	12795	0644	edit dl rm
xmllint.html	23275	0644	edit dl rm
xmlmem.html	14441	0644	edit dl rm
xmlreader.html	20139	0644	edit dl rm
XSLT.html	5775	0644	edit dl rm

Edit: /usr/share/doc/libxml2-devel/xmlcatalog_man.html (13923B)

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xmlcatalog</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="idm45940765506544"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2>xmlcatalog &#8212; 
		Command line tool to parse and manipulate <acronym class="acronym">XML</acronym>
		or <acronym class="acronym">SGML</acronym> catalog files.
	</div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><code class="command">xmlcatalog</code> [ <code class="option">--sgml</code> | <code class="option">--shell</code> | <code class="option">--create</code> | <code class="option">--del <code>VALUE(S)</code></code> | 
			[ 
					<code class="option">--add
					 <code>TYPE</code>
					 <code>ORIG</code>
					 <code>REPLACE</code>
					</code>
				 | <code class="option">--add <code>FILENAME</code></code> ]		
		 | <code class="option">--noout</code> | <code class="option">--no-super-update</code> | 
			[ <code class="option">-v</code> | <code class="option">--verbose</code> ]
		 ] {<code>CATALOGFILE</code>} {<code>ENTITIES</code>...}</div></div><div class="refsect1"><a name="description"></a><h2>DESCRIPTION</h2>
		xmlcatalog is a command line application allowing users to monitor and
		manipulate <acronym class="acronym">XML</acronym> and <acronym class="acronym">SGML</acronym> catalogs. It
		is included in libxml(3).
	
		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 <acronym class="acronym">XML</acronym> and <acronym class="acronym">SGML</acronym> files.
	</div><div class="refsect1"><a name="options"></a><h2>OPTIONS</h2>
		xmlcatalog accepts the following options (in alphabetical order):
	<div class="variablelist"><dl class="variablelist"><dt>
		<code class="option">--add
		 <code>TYPE</code>
		 <code>ORIG</code>
		 <code>REPLACE</code>
		</code>
	</dt><dd>
			Add an entry to <code class="filename">CATALOGFILE</code>. <code>TYPE</code>
			indicates the type of entry. Possible types are: <code>public</code>, <code>system</code>, <code>uri</code>, <code>rewriteSystem</code>, <code>rewriteURI</code>, <code>delegatePublic</code>, <code>delegateSystem</code>, <code>delegateURI</code>, <code>nextCatalog</code>. <code>ORIG</code> is the original
			reference to be replaced, and <code>REPLACE</code>
			is the <acronym class="acronym">URI</acronym> of the replacement entity to be
			used. The <code class="option">--add</code> option will not overwrite
			<code class="filename">CATALOGFILE</code>, outputting
			to <code class="filename">stdout</code>, unless
			<code class="option">--noout</code> is used. The <code class="option">--add</code> will
			always take three parameters even if some of the <acronym class="acronym">XML</acronym>
			catalog constructs will have only a single argument.
		</dd><dt><code class="option">--add <code>FILENAME</code></code></dt><dd>
			If the <code class="option">--add</code> option is used following
			the <code class="option">--sgml</code> option, only a single argument,
			a <code>FILENAME</code>, is used. This is used to add
			the name of a catalog file to an <acronym class="acronym">SGML</acronym> supercatalog,
			a file that contains references to other included <acronym class="acronym">SGML</acronym>
			catalog files.
		</dd><dt><code class="option">--create</code></dt><dd>
			Create a new <acronym class="acronym">XML</acronym> catalog. Outputs
			to <code class="filename">stdout</code>,
			ignoring <code>filename</code> unless <code class="option">--noout</code> is
			used, in which case it creates a new catalog
			file <code>filename</code>.
		</dd><dt><code class="option">--del <code>VALUE(S)</code></code></dt><dd>
			Remove entries from <code>CATALOGFILE</code>
			matching <code>VALUE(S)</code>. The <code class="option">--del</code>
			option will not overwrite <code>CATALOGFILE</code>,
			outputting to <code class="filename">stdout</code>,
			unless <code class="option">--noout</code> is used.
		</dd><dt><code class="option">--noout</code></dt><dd>
			Save output to the named file rather than outputting
			to <code class="filename">stdout</code>.
		</dd><dt><code class="option">--no-super-update</code></dt><dd>
			Do not update the <acronym class="acronym">SGML</acronym> super catalog.
		</dd><dt><code class="option">--shell</code></dt><dd>
			Run a shell allowing interactive queries on catalog
			file <code>CATALOGFILE</code>. For the set of available
			commands see <a class="xref" href="#shell" title="SHELL COMMANDS">the section called &#8220;SHELL COMMANDS&#8221;</a>.
		</dd><dt><code class="option">--sgml</code></dt><dd>
			Uses <acronym class="acronym">SGML</acronym> super catalogs for <code class="option">--add</code>
			and <code class="option">--del</code> options.
		</dd><dt><code class="option">-v</code>, <code class="option">--verbose</code></dt><dd>Output debugging information.</dd></dl></div>
		Invoking xmlcatalog non-interactively without a designated action
		(imposed with options like <code class="option">--add</code>) will result in a lookup
		of the catalog entry for <code>ENTITIES</code> in the
		catalog denoted with <code>CATALOGFILE</code>. The
		corresponding entries will be output to the command line. This mode of
		operation, together with <code class="option">--shell</code> mode and non-modifying
		(i.e. without <code class="option">--noout</code>) direct actions, allows for
		a special shortcut of the void <code>CATALOGFILE</code>
		specification (possibly expressed as "" in the shell
		environment) appointing the default system catalog. That simplifies the
		handling when its exact location is irrelevant but the respective built-in
		still needs to be consulted.
	</div><div class="refsect1"><a name="shell"></a><h2>SHELL COMMANDS</h2>
		Invoking xmlcatalog with
		the <code class="option">--shell <code>CATALOGFILE</code></code> option opens
		a command line shell allowing interactive access to the catalog file
		identified by <code>CATALOGFILE</code>. Invoking the shell
		provides a command line prompt after which the following commands (described in
		alphabetical order) can be entered.
	<div class="variablelist"><dl class="variablelist"><dt>
		<code class="option">add
		 <code>TYPE</code>
		 <code>ORIG</code>
		 <code>REPLACE</code>
		</code>
	</dt><dd>
			Add an entry to the catalog file. <code>TYPE</code>
			indicates the type of entry. Possible types are: <code>public</code>, <code>system</code>, <code>uri</code>, <code>rewriteSystem</code>, <code>rewriteURI</code>, <code>delegatePublic</code>, <code>delegateSystem</code>, <code>delegateURI</code>, <code>nextCatalog</code>. <code>ORIG</code> is the original
			reference to be replaced, and <code>REPLACE</code>
			is the <acronym class="acronym">URI</acronym> of the replacement entity to be
			used. The <code class="option">--add</code> option will not overwrite
			<code class="filename">CATALOGFILE</code>, outputting
			to <code class="filename">stdout</code>, unless
			<code class="option">--noout</code> is used. The <code class="option">--add</code> will
			always take three parameters even if some of the <acronym class="acronym">XML</acronym>
			catalog constructs will have only a single argument.
		</dd><dt><code class="option">debug</code></dt><dd>
			Print debugging statements showing the steps xmlcatalog is executing.
		</dd><dt><code class="option">del <code>VALUE(S)</code></code></dt><dd>
			Remove the catalog entry corresponding to <code>VALUE(S)</code>.
		</dd><dt><code class="option">dump</code></dt><dd>Print the current catalog.</dd><dt><code class="option">exit</code></dt><dd>Quit the shell.</dd><dt><code class="option">public <code>PUBLIC-ID</code></code></dt><dd>
			Execute a Formal Public Identifier lookup of the catalog entry
			for <code>PUBLIC-ID</code>. The corresponding entry will be
			output to the command line.
		</dd><dt><code class="option">quiet</code></dt><dd>Stop printing debugging statements.</dd><dt><code class="option">system <code>SYSTEM-ID</code></code></dt><dd>
			Execute a Formal Public Identifier lookup of the catalog entry
			for <code>SYSTEM-ID</code>. The corresponding entry will be
			output to the command line.
		</dd></dl></div></div><div class="refsect1"><a name="environment"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl class="variablelist"><dt><code class="envar">XML_CATALOG_FILES</code></dt><dd><acronym class="acronym">XML</acronym> catalog behavior can be changed by redirecting
			queries to the user's own set of catalogs. This can be done by setting
			the <code class="envar">XML_CATALOG_FILES</code> environment variable to a list
			of catalogs. An empty one should deactivate loading the
			default <code class="filename">/etc/xml/catalog</code> catalog.
		</dd></dl></div></div><div class="refsect1"><a name="diagnostics"></a><h2>DIAGNOSTICS</h2>
		xmlcatalog return codes provide information that can be used when
		calling it from scripts.
	<div class="variablelist"><dl class="variablelist"><dt>0</dt><dd>No error</dd><dt>1</dt><dd>Failed to remove an entry from the catalog</dd><dt>2</dt><dd>Failed to save to the catalog, check file permissions</dd><dt>3</dt><dd>Failed to add an entry to the catalog</dd><dt>4</dt><dd>Failed to look up an entry in the catalog</dd></dl></div></div><div class="refsect1"><a name="seealso"></a><h2>SEE ALSO</h2>libxml(3)
	
		More information can be found at
		<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">libxml(3) web page <a class="ulink" href="http://www.xmlsoft.org/" target="_top">http://www.xmlsoft.org/</a>
				</li><li class="listitem">libxml(3) catalog support web page
					at <a class="ulink" href="http://www.xmlsoft.org/catalog.html" target="_top">http://www.xmlsoft.org/catalog.html</a>
				</li><li class="listitem">James Clark's <acronym class="acronym">SGML</acronym> catalog
					page <a class="ulink" href="http://www.jclark.com/sp/catalog.htm" target="_top">http://www.jclark.com/sp/catalog.htm</a>
				</li><li class="listitem"><acronym class="acronym">OASIS</acronym> <acronym class="acronym">XML</acronym> catalog specification
					<a class="ulink" href="http://www.oasis-open.org/committees/entity/spec.html" target="_top">http://www.oasis-open.org/committees/entity/spec.html</a>
				</li></ul></div>
	</div></div></body></html>

cmd: