SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Mandriva 2010 libxml2-utils-2.7.7-1mdv2010.1.i586.rpm

XMLCATALOG

Section: (1)
Updated: $Date$
Index 

NAME

xmlcatalog - Command line tool to parse and manipulate XML or SGML catalog files. 

SYNOPSIS

xmlcatalog [--sgml --shell --create --del VALUE(S)--add TYPE ORIG REPLACE  --add FILENAME] --noout --no-super-update [-v --verbose]] {CATALOGFILE} {ENTITIES...}
 

DESCRIPTION

xmlcatalog

is a command line application allowing users to monitor and manipulateXMLandSGMLcatalogs. It is included inlibxml(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 bothXMLandSGMLfiles. 

OPTIONS

xmlcatalogaccepts the following options (in alphabetical order):

--add TYPE ORIG REPLACE
Add an entry toCATALOGFILE.TYPEindicates the type of entry. Possible types are:public, system, rewriteSystem, rewriteURI, delegatePublic, delegateSystem, nextCatalog.ORIGis the original reference to be replaced, andREPLACEis theURIof the replacement entity to be used. The--addoption will not overwriteCATALOGFILE, outputting tostdout, unless--nooutis used. The--addwill always take three parameters even if some of theXMLcatalog constructs will have only a single argument.
--add FILENAME
If the--addoption is used following the--sgmloption, only a single argument, aFILENAME, is used. This is used to add the name of a catalog file to anSGMLsupercatalog, a file that contains references to other includedSGMLcatalog files.
--create
Create a newXMLcatalog. Outputs tostdout, ignoringfilenameunless--nooutis used, in which case it creates a new catalog filefilename.
--del VALUE(S)
Remove entries fromCATALOGFILEmatchingVALUE(S). The--deloption will not overwriteCATALOGFILE, outputting tostdout, unless--nooutis used.
--noout
Save output to the named file rather than outputting tostdout.
--no-super-update
Do not update theSGMLsuper catalog.
--shell
Run a shell allowing interactive queries on catalog fileCATALOGFILE. For the set of available commands seethe section called lqSHELL COMMANDSrq.
--sgml
UsesSGMLsuper catalogs for--addand--deloptions.
-v, --verbose
Output debugging information.
 

SHELL COMMANDS

Invokingxmlcatalogwith the--shell CATALOGFILEoption opens a command line shell allowing interactive access to the catalog file identified byCATALOGFILE. Invoking the shell provides a command line prompt after which the following commands (described in alphabetical order) can be entered.

add TYPE ORIG REPLACE
Add an entry to the catalog file.TYPEindicates the type of entry. Possible types are:public, system, rewriteSystem, rewriteURI, delegatePublic, delegateSystem, nextCatalog.ORIGis the original reference to be replaced, andREPLACEis theURIof the replacement entity to be used. The--addoption will not overwriteCATALOGFILE, outputting tostdout, unless--nooutis used. The--addwill always take three parameters even if some of theXMLcatalog constructs will have only a single argument.
debug
Print debugging statements showing the stepsxmlcatalogis executing.
del VALUE(S)
Remove the catalog entry corresponding toVALUE(S).
dump
Print the current catalog.
exit
Quit the shell.
public PUBLIC-ID
Execute a Formal Public Identifier look-up of the catalog entry forPUBLIC-ID. The corresponding entry will be output to the command line.
quiet
Stop printing debugging statements.
system SYSTEM-ID
Execute a Formal Public Identifier look-up of the catalog entry forSYSTEM-ID. The corresponding entry will be output to the command line.
 

ENVIRONMENT

XML_CATALOG_FILES
XMLcatalog behavior can be changed by redirecting queries to the user's own set of catalogs. This can be done by setting theXML_CATALOG_FILESenvironment variable to a list of catalogs. An empty one should deactivate loading the default/etc/xml/catalogcatalog.
 

DIAGNOSTICS

xmlcatalogreturn codes provide information that can be used when calling it from scripts.

0
No error
1
Failed to remove an entry from the catalog
2
Failed to save to the catalog, check file permissions
3
Failed to add an entry to the catalog
4
Failed to look up an entry in the catalog
 

SEE ALSO

libxml(3)

More information can be found at

*
libxml(3)web pagehttp://www.xmlsoft.org/
*
libxml(3)catalog support web page athttp://www.xmlsoft.org/catalog.html
*
James Clark'sSGMLcatalog pagehttp://www.jclark.com/sp/catalog.htm
*
OASISXMLcatalog specificationhttp://www.oasis-open.org/committees/entity/spec.html
 

AUTHOR

John Fleck <jfleckAATTinkstain.net>.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SHELL COMMANDS
ENVIRONMENT
DIAGNOSTICS
SEE ALSO
AUTHOR

This document was created byman2html,using the manual pages.