man-pages/man8/update-xmlcatalog.8.html
2021-03-31 01:06:50 +01:00

165 lines
5.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of UPDATE-XMLCATALOG</TITLE>
</HEAD><BODY>
<H1>UPDATE-XMLCATALOG</H1>
Section: xml-core (8)<BR>Updated: 2019-02-27<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
update-xmlcatalog - maintain XML catalog files
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>update-xmlcatalog</B> <B>--add</B> <B>--root</B> <B>--package</B>&nbsp;<I>package</I>
<B>--type</B>&nbsp;<I>type</I> <B>--id</B>&nbsp;<I>id</I>
<P>
<B>update-xmlcatalog</B> <B>--del</B> <B>--root</B> <B>--package</B>&nbsp;<I>package</I>
<B>--type</B>&nbsp;<I>type</I> <B>--id</B>&nbsp;<I>id</I>
<P>
<B>update-xmlcatalog</B> <B>--add</B> <B>--package</B>&nbsp;<I>package</I> <B>--local</B>&nbsp;<I>local</I> <B>--type</B>&nbsp;<I>type</I> <B>--id</B>&nbsp;<I>id</I>
<P>
<B>update-xmlcatalog</B> <B>--del</B> <B>--package</B>&nbsp;<I>package</I> <B>--local</B>&nbsp;<I>local</I> <B>--type</B>&nbsp;<I>type</I> <B>--id</B>&nbsp;<I>id</I>
<P>
<B>update-xmlcatalog</B> <B>--add</B> <B>--local</B>&nbsp;<I>local</I> <B>--file</B>&nbsp;<I>file</I> <B>--type</B>&nbsp;<I>type</I> <B>--id</B>&nbsp;<I>id</I>
<P>
<B>update-xmlcatalog</B> <B>--del</B> <B>--local</B>&nbsp;<I>local</I> <B>--file</B>&nbsp;<I>file</I> <B>--type</B>&nbsp;<I>type</I> <B>--id</B>&nbsp;<I>id</I>
<P>
<B>update-xmlcatalog</B> <B>--help</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>update-xmlcatalog</B> add entries to and removes entries from the root
<FONT SIZE="-1">XML</FONT> catalog file, a package <FONT SIZE="-1">XML</FONT> catalog file or a local <FONT SIZE="-1">XML</FONT> catalog
file.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>--add</B><DD>
Adds the entry to the root <FONT SIZE="-1">XML</FONT> catalog file, a package <FONT SIZE="-1">XML</FONT> catalog
file or a local <FONT SIZE="-1">XML</FONT> catalog file. If the <FONT SIZE="-1">XML</FONT> catalog file does not
exist yet, it is automatically created.
<DT id="2"><B>--del</B><DD>
Deletes the entry from the root <FONT SIZE="-1">XML</FONT> catalog file, the package <FONT SIZE="-1">XML</FONT>
catalog file or the local <FONT SIZE="-1">XML</FONT> catalog file. A resulting empty <FONT SIZE="-1">XML</FONT>
catalog is not automatically deleted from the filesystem.
<DT id="3"><B>--file</B> <I>file</I><DD>
Indicates a local filename.
<DT id="4"><B>--id</B> <I>id</I><DD>
Indicates the <FONT SIZE="-1">XML</FONT> catalog file entry identifier.
<DT id="5"><B>--local</B> <I>local</I><DD>
Indicates a local <FONT SIZE="-1">XML</FONT> catalog file.
<DT id="6"><B>--package</B> <I>package</I><DD>
Indicates a package <FONT SIZE="-1">XML</FONT> catalog file.
<DT id="7"><B>--root</B><DD>
Indicates the root <FONT SIZE="-1">XML</FONT> catalog file.
<DT id="8"><B>--type</B> <I>type</I><DD>
Indicates the <FONT SIZE="-1">XML</FONT> catalog file entry type (public, system, uri).
<DT id="9"><B>--help</B><DD>
Displays the usage information.
<DT id="10"><B>--verbose</B><DD>
Optional switch to make a verbose output.
<DT id="11"><B>--sort</B><DD>
Optional switch to sort the manipulated catalog content.
<P>
Tip: To sort a catalog without adding or removing an item,
just add an already existing item to the catalog.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>NOTES</H2>
<B>update-xmlcatalog</B> is the de-facto standard tool to be used to
maintain <FONT SIZE="-1">XML</FONT> catalog files on a Debian system, similar to that
<B><A HREF="/cgi-bin/man/man2html?8+update-catalog">update-catalog</A></B>(8) is the standard tool to be used to main <FONT SIZE="-1">SGML</FONT>
catalog files on a Debian system. A Debian <FONT SIZE="-1">XML</FONT> Policy document to
this effect is currently under development.
<P>
<B>update-xmlcatalog</B> and <B><A HREF="/cgi-bin/man/man2html?1+xmlcatalog">xmlcatalog</A></B>(1) are incompatible. The
former has an internal database of all the entries in all the <FONT SIZE="-1">XML</FONT>
catalog files it maintains and regenerates the indicated <FONT SIZE="-1">XML</FONT> catalog
file completely from scratch upon an update. The latter updates the
indicated <FONT SIZE="-1">XML</FONT> catalog file directly. This means that any change made
to an <FONT SIZE="-1">XML</FONT> catalog file using <B><A HREF="/cgi-bin/man/man2html?1+xmlcatalog">xmlcatalog</A></B>(1) is overwritten the next
time that <FONT SIZE="-1">XML</FONT> catalog file is updated using <B>update-xmlcatalog</B>.
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<I>/usr/share/doc/xml-core/README.Debian</I>
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
<B>Ardo van Rangelrooij</B> &lt;<A HREF="mailto:ardo@debian.org">ardo@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
<DT id="13"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="14"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="15"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="16"><A HREF="#lbAF">NOTES</A><DD>
<DT id="17"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="18"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:18 GMT, March 31, 2021
</BODY>
</HTML>