lintian doesn't like orphan packages with uploaders...
[debian/amanda] / man / xml-source / amtoc.8.xml
index 66b319660f04611ed9413631b39152ef78c74221..fa36822aa491e464bd16c1b8885c2fe37d8b9d58 100644 (file)
@@ -3,7 +3,7 @@
                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
 [
   <!-- entities files to use -->
-  <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
+  <!ENTITY % global_entities SYSTEM 'global.entities'>
   %global_entities;
 ]>
 
 <refmeta>
 <refentrytitle>amtoc</refentrytitle>
 <manvolnum>8</manvolnum>
+&rmi.source;
+&rmi.version;
+&rmi.manual.8;
 </refmeta>
 <refnamediv>
 <refname>amtoc</refname>
-<refpurpose>generate TOC (Table Of Contents) for an &A; run</refpurpose>
+<refpurpose>generate TOC (Table Of Contents) for an Amanda run</refpurpose>
 </refnamediv>
+<refentryinfo>
+&author.nm;
+&author.sgw.xml;
+</refentryinfo>
 <!-- body begins here -->
 <refsynopsisdiv>
 <cmdsynopsis>
@@ -35,7 +42,7 @@
 
 <refsect1><title>DESCRIPTION</title>
 <para><emphasis remap='I'>Amtoc</emphasis>
-generates a table of contents for an &A; run.
+generates a table of contents for an Amanda run.
 It's a perl script (if you don't have perl, install it first!).</para>
 </refsect1>
 
@@ -108,8 +115,7 @@ option is equivalent to
 <refsect1><title>OUTPUT FORMAT</title>
 <para>The standard output has five fields separated by two spaces:</para>
 
-<!-- .RS -->
-<literallayout remap='.nf'>
+<programlisting>
 #  Server:/partition  date  level  size[Kb]
 0  daily-05:  19991005  -  -
 1  cuisun15:/cuisun15/home  19991005  1  96
@@ -117,12 +123,10 @@ option is equivalent to
   ...
 103  cuisg11:/  19991005  0  4139136
 103  total:  -  -  16716288
-<!-- .RE -->
-
-</literallayout><para>In tabular format (-t), this would look like:</para>
+</programlisting>
+<para>In tabular format (-t), this would look like:</para>
 
-<!-- .RS -->
-<literallayout remap='.nf'>
+<programlisting>
   #  Server:/partition           date      lev  size[Kb]
   0  daily-05:                   19991005    -         -
   1  cuisun15:/cuisun15/home     19991005    1        96
@@ -130,8 +134,7 @@ option is equivalent to
   ...
 103  cuisg11:/                   19991005    0   4139136
 103  total:                      -           -  16716288
-<!-- .RE -->
-</literallayout></refsect1>
+</programlisting></refsect1>
 
 <refsect1><title>USAGE</title>
 <para>The easiest way to use it is to run
@@ -142,9 +145,9 @@ in the
 <emphasis remap='I'>cron job:</emphasis></para>
 
 <!-- .RS -->
-<literallayout remap='.nf'>
+<programlisting>
 amdump daily ; logdir=`amgetconf daily logdir` ; log=`ls -1t $logdir/log.*.[0-9] | head -1` ; amtoc -a $log
-</literallayout> <!-- .fi -->
+</programlisting>
 
 <para>which will generate /usr/local/etc/amanda//daily/<emphasis remap='I'>tape_label</emphasis>.toc.
 You may also want to call
@@ -153,18 +156,12 @@ after an
 <emphasis remap='I'>amflush</emphasis>.</para>
 </refsect1>
 
-<refsect1><title>SEE ALSO</title>
-<para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amdump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amflush</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-<citerefentry><refentrytitle>amgetconf</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-cron,
-perl</para>
-</refsect1>
+<seealso>
+<manref name="amdump" vol="8"/>,
+<manref name="amflush" vol="8"/>,
+<manref name="amgetconf" vol="8"/>
+</seealso>
+
 
-<refsect1><title>AUTHOR</title>
-<para>Nicolas Mayencourt <email>Nicolas.Mayencourt@cui.unige.ch</email>, University of Geneva/Switzerland : Original text</para>
-<para>&maintainer.sgw;: XML-conversion</para>
-</refsect1>
 </refentry>