Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / libxml2 / 8bda20f73c908fc08b40ad7a1d1df2c35a8d362d / . / doc / xmlcatalog.1
blob: ff31fb7085eee6891b8b6a3425b89bacc2c7fbae [file] [log] [blame]
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]1.\"Generated by db2man.xsl. Don't modify this, modify the source.
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]2.de Sh \" Subsection
3.br
4.if t .Sp
5.ne 5
6.PP
7\fB\\$1\fR
8.PP
9..
10.de Sp \" Vertical space (when we can't use .PP)
11.if t .sp .5v
12.if n .sp
13..
14.de Ip \" List item
15.br
16.ie \\n(.$>=3 .ne \\$3
17.el .ne 3
18.IP "\\$1" \\$2
19..
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]20.TH "XMLCATALOG" 1 "" "" "xmlcatalog Manual"
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]21.SH NAME
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]22xmlcatalog \- Command line tool to parse and manipulate XML or SGML catalog files.
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]23.SH "SYNOPSIS"
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]24.ad l
25.hy 0
26.HP 11
27\fBxmlcatalog\fR [\fB\-\-shell\fR | \fB\-\-create\fR | \fB\-\-add\ \fItype\fR\ \fIorig\fR\ \fIreplace\fR\fR | \fB\-\-del\ \fIvalues\fR\fR | \fB\-\-noout\fR | \fB\-\-verbose\fR] [\fB\fIcatalogfile\fR\fR] [\fB\fIentities\fR\fR]
28.ad
29.hy
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]30
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]31.SH "INTRODUCTION"
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]32
33.PP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]34 xmlcatalog is a command line application allowing users to monitor and manipulate XML and SGML catalogs\&. It is included in libxml2\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]35
36.PP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]37Its 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\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]38
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]39.SH "COMMAND LINE OPTIONS"
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]40
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]41.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]42\fB\-\-shell\fR \fIfilename\fR
43Run a shell allowing interactive queries on catalog file \fIfilename\fR\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]44
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]45.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]46\fB\-\-create\fR \fIfilename\fR
47Create a new XML catalog\&. Outputs to stdout, ignoring \fIfilename\fR unless \fB\-\-noout\fR is used, in which case it creates a new catalog file \fIfilename\fR\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]48
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]49.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]50\fB\-\-add\fR \fI'type'\fR \fI'orig'\fR \fI'replace'\fR \fIfilename\fR
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]51Add an entry to catalog file \fIfilename\fR\&. \fItype\fR indicates the type of entry\&. Possible types are 'public', 'system', 'rewriteSystem', 'rewriteURI', 'delegatePublic', 'delegateSystem', and 'nextCatalog'\&. \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, outputting 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\&.
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]52
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]53If 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\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]54
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]55.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]56\fB\-\-del\fR \fI'values'\fR \fIfilename\fR
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]57Remove entries from the catalog file \fIfilename\fR matching \fI'values'\fR\&. The \fB\-\-del\fR option will not overwrite \fIfilename\fR, outputting to stdout, unless \fB\-\-noout\fR is used\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]58
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]59.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]60\fB\-\-noout\fR
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]61Save output to the named file rather than outputting to stdout\&.
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]62
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]63.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]64\fB\-\-sgml\fR
65Uses SGML Super catalogs for \-\-add and \-\-del options
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]66
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]67.TP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]68\fB\-v\fR or \fB\-\-verbose\fR
69output debugging information\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]70
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]71.SH "SHELL COMMANDS"
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]72
73.PP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]74Invoking xmlcatalog with the \fB\-\-shell\fR \fIfilename\fR option opens a command line shell allowing interactive access to the catalog file identified by \fIfilename\fR\&. Invoking the shell provides a command line prompt after which commands can be entered\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]75
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]76.TP
77\fBpublic\fR \fI'PublicID'\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]78Execute a public identifier lookup of the catalog entry for \fI'PublicID'\fR\&. The corresponding entry will be output to the command line\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]79
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]80.TP
81\fBsystem\fR \fI'SystemID'\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]82Execute a public identifier lookup of the catalog entry for \fI'SystemID'\fR\&. The corresponding entry will be output to the command line\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]83
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]84.TP
85\fBadd \fR \fI'type'\fR \fI'orig'\fR \fI'replace'\fR
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]86Add an entry to the catalog file\&. \fItype\fR indicates the type of entry\&. Possible types are 'public', 'system', 'rewriteSystem', 'rewriteURI', 'delegatePublic', 'delegateSystem', and 'nextCatalog'\&. \fI'orig'\fR is the original reference to be replaced, and \fI'replace'\fR is the URI of the replacement entity to be used\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]87
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]88.TP
89\fBdel\fR \fI'values'\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]90Remove the catalog entry corresponding to \fI'values'\fR\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]91
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]92.TP
93\fBdump\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]94Print the current catalog\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]95
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]96.TP
97\fBdebug\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]98Print debugging statements showing the steps xmlcatalog is executing\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]99
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]100.TP
101\fBquiet\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]102Stop printing debugging statements\&.
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]103
MDT 2001 John Fleckac941e32001-10-06 22:30:16 +0000[diff] [blame]104.TP
105\fBexit\fR
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]106Quit the shell\&.
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]107
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]108.SH "RETURN VALUES"
109
110.PP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]111xmlcatalog's return codes provide information that can be used when calling it from scripts\&.
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]112
113.PP
1140: normal
115
116.PP
1171: Failed to remove an entry from the catalog
118
119.PP
1202: Failed to save to the catalog, check file permissions
121
122.PP
1233: Failed to add an entry to the catalog
124
125.PP
1264: Failed to lookup and entry in the catalog
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]127
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]128.SH "CATALOGS"
129
130.PP
131Catalog behavior can be changed by redirecting queries to the user's own set of catalogs\&. This can be done by setting the \fIXML_CATALOG_FILES\fR environment variable to a list of catalogs\&. An empty one should deactivate loading the default \fI/etc/xml/catalog\fR default catalog\&.
132
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]133.SH "REFERENCES"
MDT 2001 John Fleck5bd39dc2001-09-03 15:14:19 +0000[diff] [blame]134
MST 2001 John Fleck3fc555e2001-12-11 04:41:24 +0000[diff] [blame]135.PP
MST 2004 John Flecke42ae6f2004-02-27 03:26:30 +0000[diff] [blame]136libxml web page: \fIhttp://www.xmlsoft.org/\fR
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]137
MST 2001 John Fleck3fc555e2001-12-11 04:41:24 +0000[diff] [blame]138.PP
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]139libxml catalog support web page: \fIhttp://www.xmlsoft.org/catalog.html\fR
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]140
MST 2001 John Fleck3fc555e2001-12-11 04:41:24 +0000[diff] [blame]141.PP
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]142James Clark's SGML catalog page: \fIhttp://www.jclark.com/sp/catalog.htm\fR
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]143
MST 2001 John Fleck3fc555e2001-12-11 04:41:24 +0000[diff] [blame]144.PP
MDT 2004 John Fleckb7fe1042004-06-24 02:21:27 +0000[diff] [blame]145OASIS XML catalog specification: \fIhttp://www.oasis-open.org/committees/entity/spec.html\fR
MDT 2001 John Fleck0e229932001-10-07 22:46:00 +0000[diff] [blame]146
MDT 2001 John Fleck9f82dc62001-10-06 02:40:10 +0000[diff] [blame]147.SH AUTHOR
MST 2003 John Fleck937362d2003-01-27 00:04:32 +0000[diff] [blame]148John Fleck.