[pkgsrc/trunk]: pkgsrc/doc/guide/files Fix some XML errors I introduced. Note...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/51f44455e647
branches:  trunk
changeset: 497725:51f44455e647
user:      wiz <wiz%pkgsrc.org@localhost>
date:      Wed Aug 03 16:34:19 2005 +0000

description:
Fix some XML errors I introduced. Noted by rpaulo@.

diffstat:

 doc/guide/files/components.xml  |  21 ++++++++++++---------
 doc/guide/files/configuring.xml |  31 +++++++++++++++++--------------
 2 files changed, 29 insertions(+), 23 deletions(-)

diffs (129 lines):

diff -r 19681cfb02d8 -r 51f44455e647 doc/guide/files/components.xml
--- a/doc/guide/files/components.xml    Wed Aug 03 14:31:54 2005 +0000
+++ b/doc/guide/files/components.xml    Wed Aug 03 16:34:19 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.10 2005/07/28 11:05:36 wiz Exp $ -->
+<!-- $NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
   <title>Package components - files, directories and contents</title>
@@ -130,13 +130,15 @@
 
     <para>The second section contains information about separately
       downloaded patches, if any.
-      <itemizedlist><varname>PATCHFILES</varname>
-       Name(s) of additional files that contain distribution patches.
-       There is no default. pkgsrc will look for them at
-       <varname>PATCH_SITES</varname>.
-       They will automatically be uncompressed before patching if
-       the names end with <filename>.gz</filename> or
-       <filename>.Z</filename>.
+      <itemizedlist>
+       <listitem><para><varname>PATCHFILES</varname>
+         Name(s) of additional files that contain distribution patches.
+         There is no default. pkgsrc will look for them at
+         <varname>PATCH_SITES</varname>.
+         They will automatically be uncompressed before patching if
+         the names end with <filename>.gz</filename> or
+         <filename>.Z</filename>.</para>
+       </listitem>
        <listitem><para><varname>PATCH_SITES</varname>:
          Primary location(s) for distribution patch files (see
          <varname>PATCHFILES</varname> below) if not found locally.</para>
@@ -180,6 +182,7 @@
            subdirectory.</para>
        </listitem>
       </itemizedlist>
+    </para>
     <para>Please pay attention to the following gotchas:</para>
 
     <itemizedlist>
@@ -388,7 +391,7 @@
       <varname>WRKDIR</varname>. It can be removed by running
       <command>make clean</command>. Besides the sources, this
       directory is also used to keep various timestamp files.
-      The directory gets <note>removed completely</note> on clean.
+      The directory gets <emphasis>removed completely</emphasis> on clean.
       The default is <filename>${.CURDIR}/work</filename>
       or <filename>${.CURDIR}/work.${MACHINE_ARCH}</filename>
       if <varname>OBJMACHINE</varname> is set.</para>
diff -r 19681cfb02d8 -r 51f44455e647 doc/guide/files/configuring.xml
--- a/doc/guide/files/configuring.xml   Wed Aug 03 14:31:54 2005 +0000
+++ b/doc/guide/files/configuring.xml   Wed Aug 03 16:34:19 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: configuring.xml,v 1.4 2005/07/28 11:05:36 wiz Exp $ -->
+<!-- $NetBSD: configuring.xml,v 1.5 2005/08/03 16:34:19 wiz Exp $ -->
 
 <chapter id="configuring">
   <title>Configuring pkgsrc</title>
@@ -9,7 +9,7 @@
     <para>In this section you can find some variables that apply all
       pkgsrc packages.  The preferred method of setting them is by
       setting them in <filename>/etc/mk.conf</filename>.
-      <unorderedlist>
+      <itemizedlist>
        <listitem><para><varname>LOCALBASE</varname>: Where
            packages will be installed. The default is
            <filename>/usr/pkg</filename>. Do not mix binary packages
@@ -46,14 +46,14 @@
        <listitem><para><varname>BINPKG_SITES</varname>:
            List of sites carrying binary pkgs.</para>
        </listitem>
-      </unorderedlist>
+      </itemizedlist>
     </para>
   </sect1>
 
-  <sect1 tag="general-configuration">
-    <title>General configuration</title>
+  <sect1 id="variables-affecting-build">
+    <title>Variables affecting the build process</title>
     <para>XXX
-      <unorderedlist>
+      <itemizedlist>
        <listitem><para><varname>PACKAGES</varname>: The top level
            directory for the binary packages. The default is
            <filename>${PKGSRCDIR}/packages</filename>.</para>
@@ -88,7 +88,7 @@
        </listitem>
        <!--    DISTDIR -->
        <!--    FAILOVER_FETCH -->
-      </unorderedlist>
+      </itemizedlist>
     </para>
   </sect1>
 
@@ -109,15 +109,18 @@
 
     <!--       IGNORE_RECOMMENDED -->
     <para>XXX
-      <unorderedlist>
+      <itemizedlist>
        <listitem><para><varname>PKG_DEVELOPER</varname>:
            Run some sanity checks that package developers want:
-           <unorderedlist>
-             <listitem>make sure patches apply with zero fuzz</listitem>
-             <listitem>run check-shlibs to see that all binaries will
-               find their shared libs.</listitem>
+           <itemizedlist>
+             <listitem><para>make sure patches apply with zero fuzz</para></listitem>
+             <listitem><para>run check-shlibs to see that all binaries will
+               find their shared libs.</para>
              <!-- XXX: some more stuff -->
-           </unorderedlist></para></listitem>
+             </listitem>
+           </itemizedlist>
+         </para>
+       </listitem>
        <listitem><para><varname>PKG_DEBUG_LEVEL</varname>:
            The level of debugging output which is displayed whilst
            making and installing the package.
@@ -128,7 +131,7 @@
            the shell commands before their invocation, and their
            actual execution progress with <command>set -x</command>
            will be displayed.</para></listitem>
-      </unorderedlist>
+      </itemizedlist>
     </para>
   </sect1>