From 35a201cc8ef0c3f5b2df88d2e528aabee1048348 Mon Sep 17 00:00:00 2001 From: Wojtek Kosior Date: Fri, 30 Apr 2021 18:47:09 +0200 Subject: Initial/Final commit --- libxml2-2.9.10/doc/xmlcatalog_man.xml | 465 ++++++++++++++++++++++++++++++++++ 1 file changed, 465 insertions(+) create mode 100644 libxml2-2.9.10/doc/xmlcatalog_man.xml (limited to 'libxml2-2.9.10/doc/xmlcatalog_man.xml') diff --git a/libxml2-2.9.10/doc/xmlcatalog_man.xml b/libxml2-2.9.10/doc/xmlcatalog_man.xml new file mode 100644 index 0000000..b3ce8b2 --- /dev/null +++ b/libxml2-2.9.10/doc/xmlcatalog_man.xml @@ -0,0 +1,465 @@ + + +xmlcatalog"> +]> + + + + + xmlcatalog Manual + libxml2 + + 2001 + 2004 + + + John + Fleck + +
+ jfleck@inkstain.net +
+ + + + $Date$ + + + + + + + xmlcatalog + 1 + + + + xmlcatalog + + Command line tool to parse and manipulate XML + or SGML catalog files. + + + + + + xmlcatalog + + + + + + + + + + + + + + + + + + + + + + + CATALOGFILE + ENTITIES + + + + + DESCRIPTION + + &xmlcatalog; is a command line application allowing users to monitor and + manipulate XML and SGML 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 XML and SGML files. + + + + + OPTIONS + + &xmlcatalog; accepts the following options (in alphabetical order): + + + + + + + + + + + Add an entry to CATALOGFILE. TYPE + indicates the type of entry. Possible types are: + public + system + uri + rewriteSystem + rewriteURI + delegatePublic + delegateSystem + delegateURI + nextCatalog + . ORIG is the original + reference to be replaced, and REPLACE + is the URI of the replacement entity to be + used. The option will not overwrite + CATALOGFILE, outputting + to stdout, unless + is used. The will + always take three parameters even if some of the XML + catalog constructs will have only a single argument. + + + + + + + + + + If the option is used following + the option, only a single argument, + a FILENAME, 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. + + + + + + + + + Create a new XML catalog. Outputs + to stdout, + ignoring filename unless is + used, in which case it creates a new catalog + file filename. + + + + + + + + + Remove entries from CATALOGFILE + matching VALUE(S). The + option will not overwrite CATALOGFILE, + outputting to stdout, + unless is used. + + + + + + + + + Save output to the named file rather than outputting + to stdout. + + + + + + + + + Do not update the SGML super catalog. + + + + + + + + + Run a shell allowing interactive queries on catalog + file CATALOGFILE. For the set of available + commands see . + + + + + + + + + Uses SGML super catalogs for + and options. + + + + + + + + + Output debugging information. + + + + + + + Invoking &xmlcatalog; non-interactively without a designated action + (imposed with options like ) will result in a lookup + of the catalog entry for ENTITIES in the + catalog denoted with CATALOGFILE. The + corresponding entries will be output to the command line. This mode of + operation, together with mode and non-modifying + (i.e. without ) direct actions, allows for + a special shortcut of the void CATALOGFILE + 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. + + + + + SHELL COMMANDS + + Invoking &xmlcatalog; with + the option opens + a command line shell allowing interactive access to the catalog file + identified by CATALOGFILE. Invoking the shell + provides a command line prompt after which the following commands (described in + alphabetical order) can be entered. + + + + + + + + + + + Add an entry to the catalog file. TYPE + indicates the type of entry. Possible types are: + public + system + uri + rewriteSystem + rewriteURI + delegatePublic + delegateSystem + delegateURI + nextCatalog + . ORIG is the original + reference to be replaced, and REPLACE + is the URI of the replacement entity to be + used. The option will not overwrite + CATALOGFILE, outputting + to stdout, unless + is used. The will + always take three parameters even if some of the XML + catalog constructs will have only a single argument. + + + + + + + + + Print debugging statements showing the steps &xmlcatalog; is executing. + + + + + + + + + Remove the catalog entry corresponding to VALUE(S). + + + + + + + + Print the current catalog. + + + + + + + Quit the shell. + + + + + + + + Execute a Formal Public Identifier lookup of the catalog entry + for PUBLIC-ID. The corresponding entry will be + output to the command line. + + + + + + + + Stop printing debugging statements. + + + + + + + + Execute a Formal Public Identifier lookup of the catalog entry + for SYSTEM-ID. The corresponding entry will be + output to the command line. + + + + + + + + + ENVIRONMENT + + + + XML_CATALOG_FILES + + XML catalog behavior can be changed by redirecting + queries to the user's own set of catalogs. This can be done by setting + the XML_CATALOG_FILES environment variable to a list + of catalogs. An empty one should deactivate loading the + default /etc/xml/catalog catalog. + + + + + + + + + DIAGNOSTICS + + &xmlcatalog; return 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 page + + + + + libxml + 3 + catalog support web page + at + + + + James Clark's SGML catalog + page + + + + OASIS XML catalog specification + + + + + + + + -- cgit v1.2.3