[pkgsrc/trunk]: pkgsrc/doc/guide/files Reformat:

[jmmv <jmmv%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/7c25a77449ba
branches:  trunk
changeset: 495002:7c25a77449ba
user:      jmmv <jmmv%pkgsrc.org@localhost>
date:      Wed Jun 01 15:49:44 2005 +0000

description:
Reformat:
- Cut long lines wherever possible.
- Remove indentation of major sections (chapter and sections).
- Remove spaces between tags and CDATA (as in '<para>foo</para>').
- Some other minor fixes.

diffstat:

 doc/guide/files/faq.xml |  974 +++++++++++++++++++++++------------------------
 1 files changed, 483 insertions(+), 491 deletions(-)

diffs (truncated from 1094 to 300 lines):

diff -r 9b17ff1768d5 -r 7c25a77449ba doc/guide/files/faq.xml
--- a/doc/guide/files/faq.xml   Wed Jun 01 14:54:18 2005 +0000
+++ b/doc/guide/files/faq.xml   Wed Jun 01 15:49:44 2005 +0000
@@ -1,607 +1,599 @@
-<!-- $NetBSD: faq.xml,v 1.11 2005/05/29 17:16:28 jmmv Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.12 2005/06/01 15:49:44 jmmv Exp $ -->
 
 <chapter id="faq"> <?dbhtml filename="faq.html"?>
-  <title>Frequently Asked Questions</title>
+<title>Frequently Asked Questions</title>
 
-  <para> This section contains hints, tips &amp; tricks on special
-    things in pkgsrc that we didn't find a better place for in the
-    previous chapters, and it contains items for both pkgsrc users and
-    developers. </para>
+<para>This section contains hints, tips &amp; tricks on special things in
+pkgsrc that we didn't find a better place for in the previous chapters, and
+it contains items for both pkgsrc users and developers.</para>
+
+<!-- ================================================================== -->
+
+<sect1 id="mailing-list-pointers">
+<title>Are there any mailing lists for pkg-related discussion?</title>
 
-  <sect1 id="mailing-list-pointers">
-    <title>Are there any mailing lists for pkg-related discussion?</title>
+<para>The following mailing lists may be of interest to pkgsrc
+users:</para>
+
+<itemizedlist>
 
-    <para>
-      The following mailing lists may be of interest to pkgsrc users:
-    </para>
+  <listitem>
+    <para><ulink
+    url="http://www.NetBSD.org/MailingLists/index.html#pkgsrc-bugs";>pkgsrc-bugs</ulink>:
+    A list where problem reports related to pkgsrc are sent and
+    discussed.</para>
+  </listitem>
 
-    <itemizedlist>
-      <listitem>
-        <para>
-          <ulink url="http://www.NetBSD.org/MailingLists/index.html#pkgsrc-bugs";>pkgsrc-bugs</ulink>
-           -- a list where problem reports related to pkgsrc are sent and
-          discussed
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <ulink
-         url="http://www.NetBSD.org/MailingLists/index.html#pkgsrc-bulk";>pkgsrc-bulk</ulink>
-         -- a list where the results of pkgsrc bulk builds are sent and
-         discussed
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <ulink
-         url="http://www.NetBSD.org/MailingLists/index.html#pkgsrc-changes";>pkgsrc-changes</ulink>
-         -- a list where all commit messages to pkgsrc are sent
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <ulink
-         url="http://www.NetBSD.org/MailingLists/index.html#tech-pkg";>tech-pkg</ulink>
-         -- a general discussion list for all things related to pkgsrc
-        </para>
-      </listitem>
-    </itemizedlist>
+  <listitem>
+    <para><ulink
+    url="http://www.NetBSD.org/MailingLists/index.html#pkgsrc-bulk";>pkgsrc-bulk</ulink>:
+    A list where the results of pkgsrc bulk builds are sent and
+    discussed.</para>
+  </listitem>
+
+  <listitem>
+    <para><ulink
+    url="http://www.NetBSD.org/MailingLists/index.html#pkgsrc-changes";>pkgsrc-changes</ulink>:
+    A list where all commit messages to pkgsrc are sent.</para>
+  </listitem>
 
-    <para>
-      To subscribe, do:
-    </para>
+  <listitem>
+    <para><ulink
+    url="http://www.NetBSD.org/MailingLists/index.html#tech-pkg";>tech-pkg</ulink>:
+    A general discussion list for all things related to pkgsrc.</para>
+  </listitem>
+
+</itemizedlist>
 
-    <programlisting>&cprompt; echo subscribe <replaceable>listname</replaceable> | mail majordomo%NetBSD.org@localhost</programlisting>
+<para>To subscribe, do:</para>
+
+<programlisting>&cprompt; echo subscribe <replaceable>listname</replaceable> | mail majordomo%NetBSD.org@localhost</programlisting>
 
-    <para>
-      Archives for all these mailing lists are available from
-      <ulink url="http://mail-index.NetBSD.org/"/>.
-    </para>
+<para>Archives for all these mailing lists are available from
+<ulink url="http://mail-index.NetBSD.org/"/>.</para>
+
 </sect1>
 
+<!-- ================================================================== -->
 
 <sect1 id="pkgviews-docs">
-    <title>Where's the pkgviews documentation?</title>
+<title>Where's the pkgviews documentation?</title>
 
-    <para> Pkgviews is tightly integrated with buildlink. You can find a 
-      pkgviews User's guide in
-      <filename>pkgsrc/mk/buildlink3/PKGVIEWS_UG</filename>. 
-      </para>
+<para>Pkgviews is tightly integrated with buildlink.  You can find a
+pkgviews User's guide in
+<filename>pkgsrc/mk/buildlink3/PKGVIEWS_UG</filename>.</para>
+
 </sect1>
 
+<!-- ================================================================== -->
 
 <sect1 id="faq-pkgtools">
-    <title>Utilities for package management (pkgtools)</title>
+<title>Utilities for package management (pkgtools)</title>
+
+<para>The <filename>pkgsrc/pkgtools</filename> directory pkgtools contains
+a number of useful utilities for both users and developers of pkgsrc.  This
+section attempts only to make the reader aware of the utilities and when
+they might be useful, and not to duplicate the documentation that comes
+with each package.</para>
+
+<para>Utilities used by pkgsrc (automatically installed when needed):</para>
+
+<itemizedlist>
+
+  <listitem>
+    <para><pkg>pkgtools/x11-links</pkg>: Symlinks for use by
+    buildlink.</para>
+  </listitem>
+
+</itemizedlist>
+
+<para>OS tool augmentation (automatically installed when needed):</para>
+
+<itemizedlist>
+
+  <listitem>
+    <para><pkg>pkgtools/digest</pkg>: Calculates various kinds of
+    checksums (including SHA1).</para>
+  </listitem>
+
+  <listitem>
+    <para><pkg>pkgtools/libnbcompat</pkg>: Compatibility library for
+    pkgsrc tools.</para>
+  </listitem>
 
-    <para>
-      The <filename>pkgsrc/pkgtools</filename> directory pkgtools
-      contains a number of useful utilities for both users and
-      developers of pkgsrc.  This section attempts only to make the
-      reader aware of the utilities and when they might be useful, and
-      not to duplicate the documentation that comes with each package.
-      </para>
+  <listitem>
+    <para><pkg>pkgtools/mtree</pkg>: Installed on non-BSD systems due to
+    lack of native mtree.
+  </para>
+  </listitem>
+
+  <listitem>
+    <para><pkg>pkgtools/pkg_install</pkg>: Up-to-date replacement for
+    <filename>/usr/sbin/pkg_install</filename>, or for use on operating
+    systems where pkg_install is not present.</para>
+  </listitem>
+
+</itemizedlist>
+
+<para>Utilities used by pkgsrc (not automatically installed):</para>
+
+<itemizedlist>
+
+  <listitem>
+    <para><pkg>pkgtools/pkg_tarup</pkg>: Create a binary package from an
+    already-installed package.  Used by <command>make replace</command> to
+    save the old package.</para>
+  </listitem>
+
+  <listitem>
+    <para><pkg>pkgtools/dfdisk</pkg>: Adds extra functionality to pkgsrc,
+    allowing it to fetch distfiles from multiple locations.  It currently
+    supports the following methods: multiple CD-ROMs and network FTP/HTTP
+    connections.</para>
+  </listitem>
+
+  <listitem>
+    <para><pkg>pkgtools/xpkgwedge</pkg>: Put X11 packages someplace else
+    (enabled by default).</para>
+  </listitem>
+
+  <listitem>
+    <para><pkg>devel/cpuflags</pkg>: Determine the best compiler flags
+    to optimise code for your current CPU and compiler.</para>
+  </listitem>
+
+</itemizedlist>
 
-    <para>
-      Utilities used by pkgsrc (automatically installed when needed):
-      </para>
-      
-    <itemizedlist>
-      <listitem>
-        <para> <pkg>pkgtools/x11-links</pkg>: symlinks for use by
-          buildlink </para>
-      </listitem>
-    </itemizedlist>
-    
-    <para> OS tool augmentation (automatically installed when needed):
-      </para>
-      
-    <itemizedlist>
-      <listitem>
-        <para> <pkg>pkgtools/digest</pkg>:
-          calculates various kinds of checksums (including SHA1)
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/libnbcompat</pkg>:
-          compatibility library for pkgsrc tools
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/mtree</pkg>:
-          installed on non-BSD systems due to lack of native mtree
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/pkg_install</pkg>:
-          up-to-date replacement for /usr/sbin/pkg_install, or for
-          use on operating systems where pkg_install is not present
-        </para>
-      </listitem>
-    </itemizedlist>
-    
-    <para>    Utilities used by pkgsrc (not automatically installed):
-      </para> 
-    
-    <itemizedlist>
-      <listitem>
-        <para> <pkg>pkgtools/pkg_tarup</pkg>:
-          create a binary package from an already-installed package.
-          used by <command>make replace</command> to save the old package
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/dfdisk</pkg>:
-          adds extra functionality to pkgsrc, allowing it to fetch
-          distfiles from multiple locations. It currently supports the
-          following methods: multiple CD-ROMs and network FTP/HTTP
-          connections. 
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/xpkgwedge</pkg>:
-          put X11 packages someplace else (enabled by default)
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>devel/cpuflags</pkg>:
-          will determine the best compiler flags to optimise code for
-          your current CPU and compiler. 
-        </para>
-      </listitem>
-    </itemizedlist>
-    
-    <para> Utilities for keeping track of installed packages, being up
-      to date, etc: </para> 
-    
-    <itemizedlist>
-      <listitem>
-        <para> <pkg>pkgtools/pkg_chk</pkg>:
-          reports on packages whose installed
-          versions do not match the latest pkgsrc entries
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/pkgdep</pkg>:
-          makes dependency graphs of packages, to aid in choosing a
-          strategy for updating
-        </para>
-      </listitem>
-      <listitem>
-        <para> <pkg>pkgtools/pkgdepgraph</pkg>: