xmlcatalog(1)


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
   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 TYPE ORIG REPLACE
       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 --add option will not
       overwrite CATALOGFILE, outputting to stdout, unless --noout is
       used. The --add will always take three parameters even if some of
       the XML catalog constructs will have only a single argument.

   --add FILENAME
       If the --add option is used following the --sgml 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
       Create a new XML catalog. Outputs to stdout, ignoring filename
       unless --noout is used, in which case it creates a new catalog file
       filename.

   --del VALUE(S)
       Remove entries from CATALOGFILE matching VALUE(S). The --del option
       will not overwrite CATALOGFILE, outputting to stdout, unless
       --noout is used.

   --noout
       Save output to the named file rather than outputting to stdout.

   --no-super-update
       Do not update the SGML super catalog.

   --shell
       Run a shell allowing interactive queries on catalog file
       CATALOGFILE. For the set of available commands see the section
       called "SHELL COMMANDS".

   --sgml
       Uses SGML super catalogs for --add and --del options.

   -v, --verbose
       Output debugging information.

SHELL COMMANDS

   Invoking xmlcatalog with the --shell CATALOGFILE 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 TYPE ORIG REPLACE
       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 --add
       option will not overwrite CATALOGFILE, outputting to stdout, unless
       --noout is used. The --add will always take three parameters even
       if some of the XML catalog constructs will have only a single
       argument.

   debug
       Print debugging statements showing the steps xmlcatalog is
       executing.

   del VALUE(S)
       Remove the catalog entry corresponding to VALUE(S).

   dump
       Print the current catalog.

   exit
       Quit the shell.

   public PUBLIC-ID
       Execute a Formal Public Identifier look-up of the catalog entry for
       PUBLIC-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 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 http://www.xmlsoft.org/

   *   libxml(3) catalog support web page at
       http://www.xmlsoft.org/catalog.html

   *   James Clark's SGML catalog page
       http://www.jclark.com/sp/catalog.htm

   *   OASIS XML catalog specification
       http://www.oasis-open.org/committees/entity/spec.html

AUTHOR

   John Fleck <jfleck@inkstain.net>
       Author.

COPYRIGHT

   Copyright  2001, 2004





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.