Lots of tagging and sgml'ification.

svn path=/head/; revision=14206

en_US.ISO8859-1/articles/releng-packages/article.sgml

@@ -179,7 +179,7 @@
         <listitem><para>This script removes lines from an <filename>INDEX</filename> file
           for packages that aren't present.  It also removes the
           XFree86 dependencies.  NOTE: you'll need to tweak the value
-          of the xdep variable to make sure the version number is
+          of the <varname>xdep</varname> variable to make sure the version number is
           correct.</para></listitem>
       </varlistentry>
 
@@ -201,7 +201,7 @@
         them want to contain packages, distfiles, both, or
         neither.</para></listitem>
 
-      <listitem><para>Make sure you remove the gen directory if
+      <listitem><para>Make sure you remove the <varname>gen</varname> directory if
         there's an old one laying around.  This directory contains
         working files that will only be valid for the current
         split.</para></listitem>
@@ -210,9 +210,9 @@
         fake the copying of packages and distfiles.  This will save
         both time and diskspace while you do a couple of trial runs to
         make sure things fit, etc.  In the
-        <filename>oneshot.pl</filename> set the fake variable
+        <filename>oneshot.pl</filename> set the <varname>fake</varname> variable
         to 1 and instead of actually copying the files it will
-        &man.touch.1; them.  Be sure you turn this off or set fake to
+        &man.touch.1; them.  Be sure you turn this off or set <varname>fake</varname> to
         0 before you give the resultant discs to the person that will
         be mastering the discs otherwise they'll get a directory full
         of zero-sized files.</para></listitem>
@@ -236,7 +236,7 @@
     <orderedlist>
 
       <listitem><para>Grab a copy of <filename>ports.tar.gz</filename>
-        and extract it into the ports directory alongside
+        and extract it into the <filename>ports</filename> directory alongside
         <filename>doit.sh</filename> and the
         <Filename>scripts</filename> directory.</para></listitem>
 
@@ -276,8 +276,8 @@
         non-cdromable packages/distfiles.  Most of the time you'll
         want to answer (y)es here.</para></listitem>
 
-      <listitem><para>Copies the <filename>INDEX</filename> from the ports directory to the
-        gen directory.  In doing so it removes the lines for ports
+      <listitem><para>Copies the <filename>INDEX</filename> from the <filename>ports</filename> directory to the
+        <filename>gen</filename> directory.  In doing so it removes the lines for ports
         where the packages don't exist.  It also checks to make sure
         that all of the required dependency packages are
         present.</para></listitem>
@@ -288,7 +288,7 @@
       <listitem><para>Asks you if you'd like to populate the discs.
         After populating each disc it will check for missing
         dependencies, scrub the <filename>INDEX</filename> file, and create the
-        CHECKSUM.MD5 file.</para></listitem>
+        <filename>CHECKSUM.MD5</filename> file.</para></listitem>
 
       <listitem><para>Check to make sure the required packages made it
         on each disc and gives you a summary of the sizes of each
@@ -297,18 +297,18 @@
 
     <para>After going through this the first time if you are lucky
       enough that all of the required packages built and fit on each
-      disc.  All you need to do is set fake to 0 in
+      disc.  All you need to do is set <varname>fake</varname> to 0 in
       <Filename>oneshot.pl</filename> and re-run
       <command>./doit.sh</command>.  The second and subsequent times
       around it will skip steps 1-5 above.  If you want to re-run any
-      of those steps refer to doit.sh for which files need to be
+      of those steps refer to <filename>doit.sh</filename> for which files need to be
       removed to not short-circuit those steps.  If you want to repeat
       all of these steps then the easiest way is to <command>rm -rf
       gen</command>.</para>
 
     <para>Upon successful completion the packages/distfiles will be in
       the <filename>disc*</filename> directories and the leftover will
-      be in the scratch directory.</para>
+      be in the <filename>scratch</filename> directory.</para>
 
     <para>What to do if things go wrong?  Here's some common gotchas
       and workarounds.</para>
@@ -320,7 +320,7 @@
         <listitem><para>This is a pretty common occurrence.  You'll
           either need to wait for a new set of packages where the
           missing packages were built or get someone to re-start the
-          package build for you.  DO NOT attempt to build the missing
+          package build for you.  <emphasis>Do not</emphasis> attempt to build the missing
           packages on your own machine and add them into the fray.
           While you might be able to get away with this if you are
           extremely careful the vast majority of the time you'll miss
@@ -333,9 +333,9 @@
         <term>Required packages won't fit</term>
 
         <listitem><para>This happens on occasion too and is relatively
-          easy to fix.  Simply edit print-cdrom-packages.sh to move
+          easy to fix.  Simply edit <filename>print-cdrom-packages.sh</filename> to move
           packages around until they fit.  Yes this is an iterative
-          process and one of the reasons why you should enable fake in
+          process and one of the reasons why you should enable <varname>fake</varname> in
           <filename>oneshot.pl</filename> until you have gotten
           things the way you want them.  Re-run
           <command>./doit.sh</command> after you made your