[pkgsrc/trunk]: pkgsrc/doc/guide/files Add an id to all sect[123].

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/f6531c97a934
branches:  trunk
changeset: 494435:f6531c97a934
user:      wiz <wiz%pkgsrc.org@localhost>
date:      Tue May 24 12:14:42 2005 +0000

description:
Add an id to all sect[123].

diffstat:

 doc/guide/files/binary.xml       |  26 ++++++------
 doc/guide/files/build.xml        |   4 +-
 doc/guide/files/buildlink.xml    |  16 ++++----
 doc/guide/files/components.xml   |   8 ++--
 doc/guide/files/editing.xml      |   6 +-
 doc/guide/files/examples.xml     |  14 +++---
 doc/guide/files/faq.xml          |  26 ++++++------
 doc/guide/files/fixes.xml        |  76 ++++++++++++++++++++--------------------
 doc/guide/files/getting.xml      |   8 ++--
 doc/guide/files/introduction.xml |   4 +-
 doc/guide/files/makefile.xml     |  12 +++---
 doc/guide/files/options.xml      |   6 +-
 doc/guide/files/platforms.xml    |  24 ++++++------
 doc/guide/files/plist.xml        |  12 +++---
 doc/guide/files/submit.xml       |  10 ++--
 doc/guide/files/using.xml        |  18 ++++----
 16 files changed, 135 insertions(+), 135 deletions(-)

diffs (truncated from 1171 to 300 lines):

diff -r bbe613e29fb3 -r f6531c97a934 doc/guide/files/binary.xml
--- a/doc/guide/files/binary.xml        Tue May 24 11:31:03 2005 +0000
+++ b/doc/guide/files/binary.xml        Tue May 24 12:14:42 2005 +0000
@@ -1,9 +1,9 @@
-<!-- $NetBSD: binary.xml,v 1.12 2005/05/14 22:34:59 rillig Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.13 2005/05/24 12:14:42 wiz Exp $ -->
 
 <chapter id="binary">
   <title>Creating binary packages</title>
 
-  <sect1>
+  <sect1 id="building-a-single-binary-package">
     <title>Building a single binary package</title>
 
     <para>
@@ -38,7 +38,7 @@
       such a binary package.</para>
   </sect1>
 
-  <sect1>
+  <sect1 id="settings-for-creationg-of-binary-packages">
     <title>Settings for creation of binary packages</title>
 
     <para>See <xref linkend="build.helpful-targets"/>.</para>
@@ -81,7 +81,7 @@
 _ACCEPTABLE=    yes</programlisting>
       </sect3>
 
-      <sect3>
+      <sect3 id="build.conf">
        <title><filename>build.conf</filename></title>
 
        <para>In <filename>pkgsrc/mk/bulk</filename>, copy
@@ -94,7 +94,7 @@
          <command>cvs update</command>.</para>
       </sect3>
 
-      <sect3>
+      <sect3 id="pre-build.local">
        <title><filename>pre-build.local</filename></title>
 
        <para>It is possible to configure the bulk build to perform
@@ -114,7 +114,7 @@
       </sect3>
     </sect2>
 
-    <sect2>
+    <sect2 id="other-environmental-considerations">
       <title>Other environmental considerations</title>
 
       <para>As <filename>/usr/pkg</filename> will be completely
@@ -140,7 +140,7 @@
        gets rebooted or crashes. You have been warned! :)</para>
     </sect2>
 
-    <sect2>
+    <sect2 id="operation">
       <title>Operation</title>
 
       <para>Make sure you don't need any of the packages still
@@ -173,7 +173,7 @@
       </para> 
     </sect2>
 
-    <sect2>
+    <sect2 id="what-it-does">
       <title>What it does</title>
 
       <para>The bulk builds consist of three steps:</para>
@@ -231,7 +231,7 @@
       </para> 
     </sect2>
 
-    <sect2>
+    <sect2 id="disk-space-requirements">
       <title>Disk space requirements</title>
 
       <para>Currently, roughly the following requirements are valid for
@@ -267,7 +267,7 @@
       </para> 
     </sect2>
 
-    <sect2>
+    <sect2 id="setting-up-a-sandbox">
       <title>Setting up a sandbox for chroot'ed builds</title>
 
       <para>
@@ -403,7 +403,7 @@
         (wherever that points/mounts to/from).</para>
     </sect2>
 
-    <sect2>
+    <sect2 id="building-a-partial-set">
       <title>Building a partial set of packages</title>
 
       <para> In addition to building a complete set of all packages in
@@ -555,7 +555,7 @@
     </sect2>
   </sect1>
 
-  <sect1>
+  <sect1 id="creating-cdroms">
     <title>Creating a multiple CD-ROM packages collection</title>
 
     <para>
@@ -569,7 +569,7 @@
       package.
     </para>
 
-    <sect2>
+    <sect2 id="cdpack-example">
       <title>Example of cdpack</title>
 
       <para>
diff -r bbe613e29fb3 -r f6531c97a934 doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Tue May 24 11:31:03 2005 +0000
+++ b/doc/guide/files/build.xml Tue May 24 12:14:42 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.6 2005/05/24 11:11:24 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.7 2005/05/24 12:14:42 wiz Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -127,7 +127,7 @@
     </itemizedlist>
   </sect1>
 
-  <sect1>
+  <sect1 id="main-targets">
     <title>Main targets</title>
 
     <para>The main targets used during the build process defined in
diff -r bbe613e29fb3 -r f6531c97a934 doc/guide/files/buildlink.xml
--- a/doc/guide/files/buildlink.xml     Tue May 24 11:31:03 2005 +0000
+++ b/doc/guide/files/buildlink.xml     Tue May 24 12:14:42 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: buildlink.xml,v 1.3 2005/05/14 22:34:59 rillig Exp $ -->
+<!-- $NetBSD: buildlink.xml,v 1.4 2005/05/24 12:14:42 wiz Exp $ -->
 
 <chapter id="buildlink">
   <title>Buildlink methodology</title>
@@ -33,7 +33,7 @@
     designed to insulate the package build from non-system-supplied
     software. </para>
 
-  <sect1>
+  <sect1 id="converting-to-buildlink3">
     <title>Converting packages to use buildlink3</title>
 
     <para>The process of converting packages to use the buildlink3
@@ -137,7 +137,7 @@
       description of how to use them properly.</para>
   </sect1>
 
-  <sect1>
+  <sect1 id="creating-buildlink3.mk">
     <title>Writing <filename>buildlink3.mk</filename> files</title>
 
     <para> A package's <filename>buildlink3.mk</filename> file is
@@ -158,7 +158,7 @@
     <screen>&cprompt; <userinput>cd pkgsrc/<replaceable>category</replaceable>/<replaceable>pkgdir</replaceable>
 &cprompt; createbuildlink -3 &gt;buildlink3.mk</userinput></screen> 
 
-    <sect2>
+    <sect2 id="anatomy-of-bl3">
       <title>Anatomy of a buildlink3.mk file</title>
 
       <para>The following real-life example
@@ -343,7 +343,7 @@
            </para>
     </sect2>
 
-    <sect2>
+    <sect2 id="updating-buildlink-depends">
       <title>Updating <varname>BUILDLINK_DEPENDS.<replaceable>pkg</replaceable></varname> in <filename>buildlink3.mk</filename> files</title>
 
       <para>
@@ -388,7 +388,7 @@
     </sect2>
   </sect1>
 
-  <sect1>
+  <sect1 id="writing-builtin.mk">
     <title>Writing <filename>builtin.mk</filename> files</title>
 
     <para>
@@ -429,7 +429,7 @@
       </listitem>
     </orderedlist>
 
-    <sect2>
+    <sect2 id="anatomy-of-builtin.mk">
       <title>Anatomy of a <filename>builtin.mk</filename> file</title>
 
       <para>The following is the recommended template for builtin.mk
@@ -527,7 +527,7 @@
         </para> 
     </sect2>
     
-    <sect2>
+    <sect2 id="native-or-pkgsrc-preference">
       <title>Global preferences for native or pkgsrc software</title>
 
       <para>
diff -r bbe613e29fb3 -r f6531c97a934 doc/guide/files/components.xml
--- a/doc/guide/files/components.xml    Tue May 24 11:31:03 2005 +0000
+++ b/doc/guide/files/components.xml    Tue May 24 12:14:42 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.7 2005/05/15 20:24:17 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.8 2005/05/24 12:14:42 wiz Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
   <title>Package components - files, directories and contents</title>
@@ -268,7 +268,7 @@
       <emphasis>they are applied after pkgsrc patches are applied</emphasis>.</para>
   </sect1>
 
-  <sect1>
+  <sect1 id="other-mandatory-files">
     <title>Other mandatory files</title>
 
     <variablelist>
@@ -350,7 +350,7 @@
     </variablelist>
   </sect1>
 
-  <sect1>
+  <sect1 id="work-dir">
     <title><filename>work*</filename></title>
 
     <para>When you type <command>make</command> the distribution files are
@@ -385,7 +385,7 @@
       <filename>work.sparc</filename>. </para>
   </sect1>
 
-  <sect1>
+  <sect1 id="files-dir">
     <title><filename>files/*</filename></title>
 
     <para>If you have any files that you wish to be placed in the package prior
diff -r bbe613e29fb3 -r f6531c97a934 doc/guide/files/editing.xml
--- a/doc/guide/files/editing.xml       Tue May 24 11:31:03 2005 +0000
+++ b/doc/guide/files/editing.xml       Tue May 24 12:14:42 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: editing.xml,v 1.6 2005/05/07 22:28:47 wiz Exp $ -->
+<!-- $NetBSD: editing.xml,v 1.7 2005/05/24 12:14:42 wiz Exp $ -->
 
 <appendix id="editing">
   <title>Editing guidelines for the pkgsrc guide</title>
@@ -8,7 +8,7 @@
     itself.
   </para>
 
-  <sect1>
+  <sect1 id="targets">
     <title>Targets</title>
   
     <para>
@@ -56,7 +56,7 @@
     </itemizedlist>
   </sect1>
 
-  <sect1>
+  <sect1 id="procedure">
     <title>Procedure</title>
     
     <para>
diff -r bbe613e29fb3 -r f6531c97a934 doc/guide/files/examples.xml
--- a/doc/guide/files/examples.xml      Tue May 24 11:31:03 2005 +0000
+++ b/doc/guide/files/examples.xml      Tue May 24 12:14:42 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: examples.xml,v 1.4 2005/05/14 22:34:59 rillig Exp $ -->
+<!-- $NetBSD: examples.xml,v 1.5 2005/05/24 12:14:42 wiz Exp $ -->
 
 <appendix id="examples">
   <title>A simple example package: bison</title>
@@ -9,10 +9,10 @@
     present in the tree is beyond us, but it's useful for the purposes of
     this exercise.</para>
 
-  <sect1>
+  <sect1 id="example-files">
     <title>files</title>
 
-    <sect2>
+    <sect2 id="example-Makefile">
       <title>Makefile</title>
 
       <programlisting># &#36;NetBSD&#36;
@@ -32,7 +32,7 @@
 .include "../../mk/bsd.pkg.mk"</programlisting>
     </sect2>
 
-    <sect2>
+    <sect2 id="example-descr">
       <title>DESCR</title>
 
       <programlisting>GNU version of yacc.  Can make re-entrant parsers, and numerous other
@@ -40,7 +40,7 @@
 of the &os; source tree is beyond me.</programlisting>