2001-09-03 19:14:19 +04:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
< html >
< head >
< meta content = "text/html; charset=ISO-8859-1" http-equiv = "Content-Type" >
< title > xmlcatalog< / title >
< meta name = "generator" content = "DocBook XSL Stylesheets V1.41" >
< / head >
< body bgcolor = "white" text = "black" link = "#0000FF" vlink = "#840084" alink = "#0000FF" > < div class = "refentry" >
< h1 class = "title" >
2001-10-07 02:30:16 +04:00
< a name = "id2703858" > < / a > xmlcatalog< / h1 >
2001-09-03 19:14:19 +04:00
< div class = "refnamediv" >
2001-10-07 02:30:16 +04:00
< a name = "id2707811" > < / a > < h2 > Name< / h2 > xmlcatalog — Command line tool to parse and manipulate XML or
2001-09-03 19:14:19 +04:00
SGML catalog files.< / div >
< div class = "refsynopsisdiv" >
2001-10-07 02:30:16 +04:00
< a name = "id2707831" > < / a > < h2 > Synopsis< / h2 >
< div class = "cmdsynopsis" id = "id2707834" >
< a name = "id2707834" > < / a > < tt > xmlcatalog< / tt > [--shell | --create | --add < i > < tt > type< / tt > < / i >
2001-09-03 19:14:19 +04:00
< i > < tt > orig< / tt > < / i > < i > < tt > replace< / tt > < / i > | --del < i > < tt > values< / tt > < / i > | --noout | --verbose] [< tt > < i > < tt > catalogfile< / tt > < / i > < / tt > ] [< tt > < i > < tt > entities< / tt > < / i > < / tt > ]< / div >
< / div >
< div class = "refsect1" >
< a name = "introduction" > < / a > < h2 >
< a name = "introduction" > < / a > Introduction< / h2 >
< p >
xmlcatalog is a command line application
allowing users to monitor and manipulate XML and
SGML catalogs. It is included in
libxml2.
< / p >
< p >
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.
< / p >
< / div >
< div class = "refsect1" >
< a name = "cloptions" > < / a > < h2 >
< a name = "cloptions" > < / a > Command Line Options< / h2 >
2001-10-07 02:30:16 +04:00
< div class = "variablelist" > < dl >
< dt >
< a name = "id2705356" > < / a > < span class = "term" > < tt > --shell< / tt > < i > < tt > filename< / tt > < / i > < / span >
< / dt >
< dd > < p >
< a name = "id2705369" > < / a >
Run a shell
allowing interactive queries on catalog file
< i > < tt > filename< / tt > < / i > .
< / p > < / 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 >
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 >
< 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 >
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',
'delegatePublic' and 'delegateSystem'. < i > < tt > 'orig'< / tt > < / i >
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
< 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.
2001-09-03 19:14:19 +04:00
2001-10-07 02:30:16 +04:00
< / p > < / dd >
< dt >
< a name = "id2708138" > < / 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 >
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 >
< dt >
< a name = "id2708187" > < / a > < span class = "term" > < tt > --noout< / tt > < / span >
< / dt >
< dd > < p >
< a name = "id2708196" > < / a >
Save output to the named file rather than
outputing to stdout.
< / p > < / dd >
< dt >
< a name = "id2708207" > < / a > < span class = "term" > < tt > -v< / tt > or < tt > --verbose< / tt > < / span >
< / dt >
< dd > < p >
< a name = "id2708220" > < / a >
output debugging
information.
< / p > < / dd >
< / dl > < / div >
2001-09-03 19:14:19 +04:00
< / div >
< div class = "refsect1" >
< a name = "shell" > < / a > < h2 >
< a name = "shell" > < / a > Shell Commands< / h2 >
< p > Invoking xmlcatalog with the
< tt > --shell< / tt > < i > < tt > filename< / tt > < / i > option opens
a command line shell allowing interactive access to the catalog file
identified by < i > < tt > filename< / tt > < / i > . Invoking the shell
provides a command line prompt after which commands can be entered.
< / p >
2001-10-07 02:30:16 +04:00
< div class = "variablelist" > < dl >
< dt >
< a name = "id2708274" > < / a > < span class = "term" > < tt > public< / tt > < i > < tt > 'PublicID'< / tt > < / i > < / span >
< / dt >
< dd > < p >
< a name = "id2708287" > < / a >
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 >
< dt >
< a name = "id2708302" > < / a > < span class = "term" > < tt > system< / tt > < i > < tt > 'SystemID'< / tt > < / i > < / span >
< / dt >
< dd > < p >
< a name = "id2708315" > < / a >
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 >
< 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 >
< / dt >
< dd > < p >
< a name = "id2708352" > < / a >
Add an entry to the catalog
file. < i > < tt > type< / tt > < / i > indicates the type of
entry. Possible types are 'public', 'system', 'rewriteSystem',
'delegatePublic' and 'delegateSystem'. < i > < tt > 'orig'< / tt > < / i >
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 >
< dt >
< a name = "id2708383" > < / a > < span class = "term" > < tt > del< / tt > < i > < tt > 'values'< / tt > < / i > < / span >
< / dt >
< dd > < p >
< a name = "id2708396" > < / a >
Remove the
catalog entry corresponding to < i > < tt > 'values'< / tt > < / i > .
< / p > < / dd >
< dt >
< a name = "id2705468" > < / a > < span class = "term" > < tt > dump< / tt > < / span >
< / dt >
< dd > < p >
< a name = "id2705478" > < / a >
Print the current catalog.
< / p > < / dd >
< dt >
< a name = "id2708682" > < / a > < span class = "term" > < tt > debug< / tt > < / span >
< / dt >
< dd > < p >
< a name = "id2708691" > < / a >
Print debugging statements showing the steps
xmlcatalog is executing.
< / p > < / dd >
< dt >
< a name = "id2708708" > < / a > < span class = "term" > < tt > quiet< / tt > < / span >
< / dt >
< dd > < p >
< a name = "id2708717" > < / a >
Stop printing debugging statements.
< / p > < / dd >
< dt >
< a name = "id2708728" > < / a > < span class = "term" > < tt > exit< / tt > < / span >
< / dt >
< dd > < p >
< a name = "id2708737" > < / a >
Quit the shell.
< / p > < / dd >
< / dl > < / div >
2001-09-03 19:14:19 +04:00
< / div >
< div class = "refsect1" >
< a name = "references" > < / a > < h2 >
< a name = "references" > < / a > References< / h2 >
2001-10-07 02:30:16 +04:00
< div class = "variablelist" > < dl >
< dt >
< a name = "id2708766" > < / 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 >
< / 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 >
< / 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 >
< / 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 >
< / dd >
< / dl > < / div >
2001-09-03 19:14:19 +04:00
< / div >
< / div > < / body >
< / html >