From linimon@lonesome.com  Tue Jun 17 13:37:38 2003
Return-Path: <linimon@lonesome.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id A22B337B401
	for <FreeBSD-gnats-submit@FreeBSD.org>; Tue, 17 Jun 2003 13:37:38 -0700 (PDT)
Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 459CF43FD7
	for <FreeBSD-gnats-submit@FreeBSD.org>; Tue, 17 Jun 2003 13:37:37 -0700 (PDT)
	(envelope-from linimon@lonesome.com)
Received: from lonesome.lonesome.com (cs242746-11.austin.rr.com [24.27.46.11])
	(using TLSv1 with cipher EDH-RSA-DES-CBC3-SHA (168/168 bits))
	(No client certificate requested)
	by mail.soaustin.net (Postfix) with ESMTP id B320C140CD
	for <FreeBSD-gnats-submit@FreeBSD.org>; Tue, 17 Jun 2003 15:37:34 -0500 (CDT)
Received: from lonesome.lonesome.com (localhost.lonesome.com [127.0.0.1])
	by lonesome.lonesome.com (8.12.9/8.12.3) with ESMTP id h5HKflNa027229
	for <FreeBSD-gnats-submit@FreeBSD.org>; Tue, 17 Jun 2003 15:41:47 -0500 (CDT)
	(envelope-from linimon@lonesome.lonesome.com)
Received: (from linimon@localhost)
	by lonesome.lonesome.com (8.12.9/8.12.6/Submit) id h5HKfkPR027228;
	Tue, 17 Jun 2003 15:41:46 -0500 (CDT)
	(envelope-from linimon)
Message-Id: <200306172041.h5HKfkPR027228@lonesome.lonesome.com>
Date: Tue, 17 Jun 2003 15:41:46 -0500 (CDT)
From: Mark Linimon <linimon@lonesome.com>
Reply-To:
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:
Subject: [patch] rework of parts of Porter's Handbook part 1 of 5: style fixes
X-Send-Pr-Version: 3.113.1
X-GNATS-Notify:

>Number:         53420
>Category:       docs
>Synopsis:       [patch] rework of parts of Porter's Handbook part 1 of 5: style fixes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ceri
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 17 13:40:03 PDT 2003
>Closed-Date:    Fri Oct 17 10:34:19 PDT 2003
>Last-Modified:  Fri Oct 17 10:34:19 PDT 2003
>Originator:     Mark Linimon
>Release:        FreeBSD-4.7
>Organization:
FreeBSD
>Environment:
System: FreeBSD lonesome.lonesome.com 4.7-STABLE FreeBSD 4.7-STABLE #0: Fri Nov 8 23:46:29 CST 2002 root@lonesome.lonesome.com:/usr/src/sys/compile/MULTIMEDIA i386
>Description:
	The Porter's Handbook is insufficiently clear in some places, and
	needs expanding in others.  As requested I have tried to break
	out the rework that I did into several pieces.  This first piece
	fixes existing style bugs only.
>How-To-Repeat:
	n/a
>Fix:

--- book.sgml.dist	Sun May 11 18:41:11 2003
+++ book.sgml	Mon May 12 20:51:50 2003
@@ -67,8 +67,8 @@
 	  This file uses a non-standard tab setting.
 	  <application>Emacs</application> and
 	  <application>Vim</application> should recognize the setting on
-	  loading the file.  Both <command>vi</command> and
-	  <command>ex</command> can be set to use the correct value by
+	  loading the file.  Both &man.vi.1; and
+	  &man.ex.1; can be set to use the correct value by
 	  typing <command>:set tabstop=4</command> once the file has been
 	  loaded.</para>
       </note>
@@ -470,7 +470,7 @@
           actions are done.</para>
 
         <para>For example, if you have a <maketarget>post-extract</maketarget>
-          target defined in your Makefile, and a file
+          target defined in your <filename>Makefile</filename>, and a file
           <filename>pre-build</filename> in the <filename>scripts</filename>
           subdirectory, the <maketarget>post-extract</maketarget> target will
           be called after the regular extraction actions, and the
@@ -581,8 +581,8 @@
         <title>Patching</title>
 
         <para>In the preparation of the port, files that have been added or
-          changed can be picked up with a recursive diff for later feeding to
-          patch.  Each set of patches you wish to apply should be collected
+          changed can be picked up with a recursive &man.diff.1; for later feeding to
+          &man.patch.1;.  Each set of patches you wish to apply should be collected
           into a file named
           <filename>patch-<replaceable>*</replaceable></filename> where
           <replaceable>*</replaceable> denotes the sequence in which the
@@ -609,10 +609,10 @@
           <literal>&dollar;RCS</literal>.</para>
 
         <para>Using the recurse (<option>-r</option>) option to
-          <command>diff</command> to generate patches is fine, but please take
+          &man.diff.1; to generate patches is fine, but please take
           a look at the resulting patches to make sure you do not have any
           unnecessary junk in there.  In particular, diffs between two backup
-          files, <filename>Makefiles</filename> when the port uses
+          files, <filename>Makefile</filename>s when the port uses
           <command>Imake</command> or GNU <command>configure</command>, etc.,
           are unnecessary and should be deleted.  If you had to edit
           <filename>configure.in</filename> and run
@@ -643,7 +643,7 @@
         <title>Handling user input</title>
 
         <para>If your port requires user input to build, configure, or install,
-          then set <makevar>IS_INTERACTIVE</makevar> in your Makefile.  This
+          then set <makevar>IS_INTERACTIVE</makevar> in your <filename>Makefile</filename>.  This
           will allow <quote>overnight builds</quote> to skip your port if the
           user sets the variable <envar>BATCH</envar> in his environment (and
           if the user sets the variable <envar>INTERACTIVE</envar>, then
@@ -661,7 +661,7 @@
     <chapter id="makefile">
       <title>Configuring the Makefile</title>
 
-      <para>Configuring the Makefile is pretty simple, and again we suggest
+      <para>Configuring the <filename>Makefile</filename> is pretty simple, and again we suggest
         that you look at existing examples before starting. Also, there is a
         <link linkend="porting-samplem">sample Makefile</link> in this
         handbook, so take a look and please follow the ordering of variables
@@ -669,7 +669,7 @@
         read.</para>
 
       <para>Now, consider the following problems in sequence as you design
-        your new Makefile:</para>
+        your new <filename>Makefile</filename>:</para>
 
       <sect1 id="makefile-source">
         <title>The original source</title>
@@ -726,7 +726,7 @@
 	    affects the content or structure of the derived
 	    package.</para>
 
-	  <para>Examples of when PORTREVISION should be bumped:</para>
+	  <para>Examples of when <makevar>PORTREVISION</makevar> should be bumped:</para>
 
 	  <itemizedlist>
 	    <listitem>
@@ -736,7 +736,7 @@
 	    </listitem>
 
 	    <listitem>
-	      <para>Changes to the port makefile to enable or disable
+	      <para>Changes to the port <filename>Makefile</filename> to enable or disable
 		compile-time options in the package.</para>
 	    </listitem>
 
@@ -808,7 +808,7 @@
 	    enhancement, fix, or by virtue that the new package will
 	    actually work for them). If yes, the
 	    <makevar>PORTREVISION</makevar> should be bumped so that
-	    automated tools (e.g.  <command>pkg_version</command>)
+	    automated tools (e.g.  &man.pkg.version.1;)
 	    will highlight the fact that a new package is
 	    available.</para>
 	</sect3>
@@ -862,8 +862,8 @@
 	  <title>Example of <makevar>PORTREVISION</makevar> and
 	    <makevar>PORTEPOCH</makevar> usage</title>
 
-	  <para>The gtkmumble port, version 0.10, is committed to the
-	    ports collection.</para>
+	  <para>The <literal>gtkmumble</literal> port, version <literal>0.10</literal>, is committed to the
+	    ports collection:</para>
 
 	  <programlisting>PORTNAME=	gtkmumble
 PORTVERSION=	0.10</programlisting>
@@ -893,7 +893,7 @@
 	    force the new package to be detected as <quote>newer</quote>. Since it
 	    is a new vendor release of the code,
 	    <makevar>PORTREVISION</makevar> is reset to 0 (or removed
-	    from the makefile).</para>
+	    from the <filename>Makefile</filename>).</para>
 
 	  <programlisting>PORTNAME=	gtkmumble
 PORTVERSION=	0.2
@@ -916,8 +916,8 @@
           <note>
             <para>If <makevar>PORTEPOCH</makevar> were reset
               to <literal>0</literal> with this upgrade, someone who had
-              installed the gtkmumble-0.10_1 package would not detect
-              the gtkmumble-0.3 package as newer, since
+              installed the <literal>gtkmumble-0.10_1</literal> package would not detect
+              the <literal>gtkmumble-0.3</literal> package as newer, since
               <literal>3</literal> is still numerically less than
               <literal>10</literal>.</para>
 	  </note>
@@ -939,7 +939,7 @@
           hyphen (<literal>-</literal>) in
           <makevar>PORTVERSION</makevar>.  Also, if the package name
           has the <replaceable>language-</replaceable> or the
-          <replaceable>compiled.specifics</replaceable> part, use
+          <replaceable>-compiled.specifics</replaceable> part, use
           <makevar>PKGNAMEPREFIX</makevar> and
           <makevar>PKGNAMESUFFIX</makevar>, respectively.  Do not make
           them part of <makevar>PORTNAME</makevar>.</para>
@@ -985,7 +985,7 @@
             should be lowercase.  (The rest of the name can contain
             capital letters, so use your own discretion when you are
             converting a software name that has some capital letters in it.)
-            There is a tradition of naming Perl 5 modules by
+            There is a tradition of naming <literal>perl 5</literal> modules by
             prepending <literal>p5-</literal> and converting the double-colon
             separator to a hyphen; for example, the
             <literal>Data::Dumper</literal> module becomes
@@ -1002,7 +1002,7 @@
             the compiled-in defaults (the hyphen is optional).  Examples are
             papersize and font units.</para>
 
-          <para>The <replaceable>compiled.specifics</replaceable> part
+          <para>The <replaceable>-compiled.specifics</replaceable> part
             should be set in the <makevar>PKGNAMESUFFIX</makevar>
             variable.</para>
         </listitem>
@@ -1180,7 +1180,7 @@
       <para>If there is absolutely no trace of version information in the
         original source and it is unlikely that the original author will ever
         release another version, just set the version string to
-        <literal>1.0</literal> (like the piewm example above).  Otherwise, ask
+        <literal>1.0</literal> (like the <literal>piewm</literal> example above).  Otherwise, ask
         the original author or use the date string
         (<literal><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
 	as the version.</para>
@@ -1493,7 +1493,7 @@
 
               <row>
                 <entry><filename>perl5*</filename></entry>
-                <entry>Ports that require perl version 5 to run.</entry>
+                <entry>Ports that require <literal>perl</literal> version 5 to run.</entry>
               </row>
 
               <row>
@@ -1629,7 +1629,7 @@
               <row>
                 <entry><filename>windowmaker*</filename></entry>
                 <entry>Ports to support the WindowMaker window
-                  manager</entry>
+                  manager.</entry>
               </row>
 
               <row>
@@ -2596,7 +2596,7 @@
 
         <note>
           <para>This does not affect the <makevar>MASTER_SITES</makevar> you
-            define in your Makefile.</para>
+            define in your <filename>Makefile</filename>.</para>
         </note>
       </sect2>
     </sect1>
@@ -2665,7 +2665,7 @@
             <maketarget>extract</maketarget> target and then from within the
             <maketarget>install</maketarget> target.  Also, the name of the
             dependency is put into the package so that
-            <command>pkg_add</command> will automatically install it if it is
+            &man.pkg.add.1; will automatically install it if it is
             not on the user's system.</para>
         </sect2>
 
@@ -2710,7 +2710,7 @@
           <para>The dependency is checked from within the
             <maketarget>install</maketarget> target.  Also, the name of the
             dependency is put into the  package so that
-            <command>pkg_add</command> will automatically install it if it is
+            &man.pkg.add.1; will automatically install it if it is
             not on the user's system.  The <replaceable>target</replaceable>
             part can be omitted if it is the same as
             <makevar>DEPENDS_TARGET</makevar>.</para>
@@ -2814,9 +2814,9 @@
 	      <row>
 		<entry><makevar>USE_PERL5</makevar></entry>
 
-		<entry>The port requires Perl 5 to build and install.  See
+		<entry>The port requires <literal>perl 5</literal> to build and install.  See
 		  <xref linkend="using-perl"> for additional variables that
-		  can be set relating to Perl.</entry>
+		  can be set relating to <literal>perl</literal>.</entry>
 	      </row>
 
 	      <row>
@@ -2888,8 +2888,8 @@
             GNU autoconf to be run.  Define <literal>USE_QT=yes</literal> if
             your port uses the latest qt toolkit.  Use
             <literal>USE_PERL5=yes</literal> if your port requires version 5
-            of the perl language.  (The last is especially important since
-            some versions of FreeBSD have perl5 as part of the base system
+            of the <literal>perl</literal> language.  (The last is especially important since
+            some versions of FreeBSD have <literal>perl5</literal> as part of the base system
             while others do not.)</para>
         </sect2>
 
@@ -2920,7 +2920,7 @@
 
             <programlisting>BUILD_DEPENDS=   ${NONEXISTENT}:${PORTSDIR}/graphics/jpeg:extract</programlisting>
 
-            will always descend to the JPEG port and extract it.</para>
+            will always descend to the <literal>jpeg</literal> port and extract it.</para>
 
           <para>Do not use <makevar>DEPENDS</makevar> unless there is no other
             way the behavior you want can be accomplished.  It will cause the
@@ -3191,10 +3191,10 @@
     </sect1>
 
     <sect1 id="using-perl">
-      <title>Using Perl</title>
+      <title>Using <literal>perl</literal></title>
 
       <table frame="none">
-	<title>Variables for ports that use Perl</title>
+	<title>Variables for ports that use <literal>perl</literal></title>
 
 	<tgroup cols="2">
 	  <thead>
@@ -3209,7 +3209,7 @@
 	    <row>
 	      <entry><makevar>USE_PERL5</makevar></entry>
 
-	      <entry>Says that the port uses Perl 5 to build and run.</entry>
+	      <entry>Says that the port uses <literal>perl 5</literal> to build and run.</entry>
 	    </row>
 	    
 	    <row>
@@ -3219,28 +3219,28 @@
 	    <row>
 	      <entry><makevar>PERL_VERSION</makevar></entry>
 	      
-	      <entry>The full version of Perl installed (e.g.,
+	      <entry>The full version of <literal>perl</literal> installed (e.g.,
 		<literal>5.00503</literal>).</entry>
 	    </row>
 	    
 	    <row>
 	      <entry><makevar>PERL_VER</makevar></entry>
 	      
-	      <entry>The short version of Perl installed (e.g.,
+	      <entry>The short version of <literal>perl</literal> installed (e.g.,
 		<literal>5.005</literal>).</entry>
 	    </row>
 
             <row>
               <entry><makevar>PERL_LEVEL</makevar></entry>
 
-              <entry>The installed Perl version as an integer of the form MNNNPP
+              <entry>The installed <literal>perl</literal> version as an integer of the form <literal>MNNNPP</literal>
                 (e.g., <literal>500503</literal>).</entry>
 	    </row>
 	    
 	    <row>
 	      <entry><makevar>PERL_ARCH</makevar></entry>
 	      
-	      <entry>Where Perl stores architecture dependent libraries.
+	      <entry>Where <literal>perl</literal> stores architecture dependent libraries.
 		Defaults to <literal>${ARCH}-freebsd</literal>.</entry>
 	    </row>
 	  </tbody>
@@ -3710,7 +3710,7 @@
       <sect1>
         <title><makevar>LIB_DEPENDS</makevar></title>
 
-        <para>All port Makefiles are edited to remove minor numbers from
+        <para>All port <filename>Makefile</filename>s are edited to remove minor numbers from
           <makevar>LIB_DEPENDS</makevar>, and also to have the regexp support
           removed.  (E.g., <literal>foo\\.1\\.\\(33|40\\)</literal> becomes
           <literal>foo.2</literal>.)  They will be matched using <command>grep
@@ -3741,7 +3741,7 @@
       <sect1>
         <title><literal>ldconfig</literal></title>
 
-        <para>The <literal>ldconfig</literal> line in Makefiles should
+        <para>The <literal>ldconfig</literal> line in <filename>Makefile</filename>s should
           read:</para>
 
         <programlisting>${SETENV} OBJFORMAT=${PORTOBJFORMAT} ${LDCONFIG} -m ....</programlisting>
@@ -3768,7 +3768,7 @@
         make it easier for users to see what to do, but try to share as many
         files as possible between ports.  Typically you only need a very short
         <filename>Makefile</filename> in all but one of the directories if you
-        use variables cleverly.  In the sole <filename>Makefiles</filename>,
+        use variables cleverly.  In the sole <filename>Makefile</filename>,
         you can use <makevar>MASTERDIR</makevar> to specify the directory
         where the rest of the files are.  Also, use a variable as part of
         <link linkend="porting-pkgname"><makevar>PKGNAMESUFFIX</makevar></link> so
@@ -3891,7 +3891,7 @@
       <para>If your port anchors its man tree somewhere other than
         <makevar>PREFIX</makevar>, you can use the
         <makevar>MANPREFIX</makevar> to set it.  Also, if only manpages in
-        certain sections go in a non-standard place, such as some Perl modules
+        certain sections go in a non-standard place, such as some <literal>perl</literal> modules
         ports, you can set individual man paths using
         <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar> (where
         <replaceable>sect</replaceable> is one of <literal>1-9</literal>,
@@ -3945,7 +3945,7 @@
         <title><makevar>USE_MOTIF</makevar></title>
 
         <para>If your port requires Motif, define this variable in the
-          Makefile.  This will prevent people who do not own a copy of Motif
+          <filename>Makefile</filename>.  This will prevent people who do not own a copy of Motif
           from even attempting to build it.</para>
       </sect1>
 
@@ -4217,7 +4217,7 @@
           <para>Edit <filename>pkg-plist</filename> and add equivalent
             <literal>@exec</literal> statements and also
             <literal>@unexec</literal> for
-            <command>pkg_delete</command>.</para>
+            &man.pkg.delete.1;.</para>
 
           <programlisting>Index: pkg-plist
 ===================================================================
@@ -4274,7 +4274,7 @@
         <para>If you need to display a message to the installer, you may place
           the message in <filename>pkg-message</filename>.  This capability is
           often useful to display additional installation steps to be taken
-          after a <command>pkg_add</command> or to display licensing
+          after a &man.pkg.add.1; or to display licensing
           information.</para>
 
         <note>
@@ -4290,10 +4290,10 @@
         <title><filename>pkg-install</filename></title>
 
         <para>If your port needs to execute commands when the binary package
-          is installed with <command>pkg_add</command> you can do this via the
+          is installed with &man.pkg.add.1; you can do this via the
           <filename>pkg-install</filename> script.  This script will
           automatically be added to the package, and will be run twice by
-          <command>pkg_add</command>.  The first time as
+          &man.pkg.add.1;.  The first time as
           <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME}
           PRE-INSTALL</literal> and the second time as
           <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME} POST-INSTALL</literal>. 
@@ -4321,10 +4321,10 @@
           installation/deinstallation should proceed.</para>
 
         <para>The script will be run at installation time by
-          <command>pkg_add</command> as
+          &man.pkg.add.1; as
           <literal>pkg-req &dollar;{PKGNAME} INSTALL</literal>.
           At deinstallation time it will be run by
-          <command>pkg_delete</command> as
+          &man.pkg.delete.1; as
           <literal>pkg-req &dollar;{PKGNAME} DEINSTALL</literal>.</para>
       </sect1>
 
@@ -4332,17 +4332,17 @@
         <title>Changing <filename>pkg-plist</filename> based on make
           variables</title>
 
-        <para>Some ports, particularly the p5- ports, need to change their
+        <para>Some ports, particularly the <literal>p5-</literal> ports, need to change their
           <filename>pkg-plist</filename> depending on what options they are
-          configured with (or version of perl, in the case of p5- ports).  To
+          configured with (or version of <literal>perl</literal>, in the case of <literal>p5-</literal> ports).  To
           make this easy, any instances in the <filename>pkg-plist</filename> of
           <literal>%%OSREL%%</literal>, <literal>%%PERL_VER%%</literal>, and
           <literal>%%PERL_VERSION%%</literal> will be substituted for
           appropriately.  The value of <literal>%%OSREL%%</literal> is the
           numeric revision of the operating system (e.g.,
           <literal>2.2.7</literal>).  <literal>%%PERL_VERSION%%</literal> is
-          the full version number of perl (e.g., <literal>5.00502</literal>)
-          and <literal>%%PERL_VER%%</literal> is the perl version number minus
+          the full version number of <literal>perl</literal> (e.g., <literal>5.00502</literal>)
+          and <literal>%%PERL_VER%%</literal> is the <literal>perl</literal> version number minus
           the patchlevel (e.g., <literal>5.005</literal>).</para>
 
         <para>If you need to make other substitutions, you can set the
@@ -4477,7 +4477,7 @@
           automatic; otherwise, this can often be done by simply replacing the
           occurrences of <filename>/usr/local</filename> (or
           <filename>/usr/X11R6</filename> for X ports that do not use imake)
-          in the various scripts/Makefiles in the port to read
+          in the various <filename>scripts/Makefile</filename>s in the port to read
           <makevar>PREFIX</makevar>, as this variable is automatically passed
           down to every stage of the build and install processes.</para>
 
@@ -4505,7 +4505,7 @@
         <para>The variable <makevar>PREFIX</makevar> can be reassigned in your
           <filename>Makefile</filename> or in the user's environment.
           However, it is strongly discouraged for individual ports to set this
-          variable explicitly in the <filename>Makefiles</filename>.</para>
+          variable explicitly in the <filename>Makefile</filename>s.</para>
 
         <para>Also, refer to programs/files from other ports with the
           variables mentioned above, not explicit pathnames.  For instance, if
@@ -4521,7 +4521,7 @@
           if this is an X port, instead of
           <literal>-DPAGER=\"/usr/local/bin/less\"</literal>. This way it will
           have a better chance of working if the system administrator has
-          moved the whole `/usr/local' tree somewhere else.</para>
+          moved the whole <filename>/usr/local</filename> tree somewhere else.</para>
       </sect1>
 
       <sect1 id="testing-freshports">
@@ -4534,11 +4534,11 @@
 	  testing of your commits.</para>
 
 	<para>If you wish to use this service, all you need is a FreshPorts
-	  account.  If your registered email address is @FreeBSD.org,
+	  account.  If your registered email address is <literal>@FreeBSD.org</literal>,
 	  you'll see the opt-in link on the right hand side of the webpages.
 	  For those of you who already have a FreshPorts account, but are not
-	  using your @FreeBSD.org email address, just change your email to
-	  @FreeBSD.org, subscribe, then change it back again.</para>
+	  using your <literal>@FreeBSD.org</literal> email address, just change your email to
+	  <literal>@FreeBSD.org</literal>, subscribe, then change it back again.</para>
       </sect1>
   </chapter>
 
@@ -5699,8 +5699,8 @@
 
         <note>
           <para>You need to include either the
-            <filename>pre.mk</filename>/<filename>post.mk</filename> pair or
-            <filename>bsd.port.mk</filename> only; do not mix these two.</para>
+            <filename>bsd.port.pre.mk</filename>/<filename>bsd.port.post.mk</filename> pair or
+            <filename>bsd.port.mk</filename> only; do not mix these two usages.</para>
         </note>
 
         <para><filename>bsd.port.pre.mk</filename> only defines a few
@@ -5867,7 +5867,7 @@
           (executables started internally), <filename>sbin</filename>
           (executables for superusers/managers), <filename>info</filename>
           (documentation for info browser) or  <filename>share</filename>
-          (architecture independent files).  See man &man.hier.7; for details,
+          (architecture independent files).  See &man.hier.7; for details;
           the rules governing
           <filename>/usr</filename> pretty much apply to
           <filename>/usr/local</filename> too.  The exception are ports
@@ -5901,7 +5901,7 @@
         <programlisting>@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</programlisting>
 
         <para>This will neither print any error messages nor cause
-          <command>pkg_delete</command> to exit abnormally even if
+          &man.pkg.delete.1; to exit abnormally even if
           <filename><makevar>PREFIX</makevar>/share/doc/gimp</filename> is not
           empty due to other ports installing some files in there.</para>
       </sect1>
@@ -6037,7 +6037,7 @@
           <filename><makevar>PREFIX</makevar>/etc</filename>, do
           <emphasis>not</emphasis> just install them and list them in
           <filename>pkg-plist</filename>.  That will cause
-          <command>pkg_delete</command> to delete files carefully edited by
+          &man.pkg.delete.1; to delete files carefully edited by
           the user and a new installation to wipe them out.</para>
 
         <para>Instead, install sample files with a suffix
@@ -6082,7 +6082,7 @@
 	Please use the correct <command>make</command> variable as
 	each make variable conveys radically different meanings to
 	both users, and to automated systems that parse
-	<filename>Makefiles</filename>.</para>
+	<filename>Makefile</filename>s.</para>
 
 	<itemizedlist>
 	  <listitem>
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->ceri 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Wed Jun 18 16:19:02 PDT 2003 
Responsible-Changed-Why:  
Force myself to deal with these. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=53420 

From: Mark Linimon <linimon@lonesome.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: ceri@FreeBSD.org
Subject: Re: docs/53420: [patch] rework of parts of Porter's Handbook part 1 of 5: style fixes
Date: Fri, 10 Oct 2003 00:32:48 -0500

 Here is an updated patchfile for this change.
 
 --- book.sgml.dist	Sun Sep 28 11:32:24 2003
 +++ book.sgml	Fri Oct 10 00:18:49 2003
 @@ -69,8 +69,8 @@
  	  This file uses a non-standard tab setting.
  	  <application>Emacs</application> and
  	  <application>Vim</application> should recognize the setting on
 -	  loading the file.  Both <command>vi</command> and
 -	  <command>ex</command> can be set to use the correct value by
 +	  loading the file.  Both &man.vi.1; and
 +	  &man.ex.1; can be set to use the correct value by
  	  typing <command>:set tabstop=4</command> once the file has been
  	  loaded.</para>
        </note>
 @@ -472,7 +472,7 @@
            actions are done.</para>
  
          <para>For example, if you have a <maketarget>post-extract</
 maketarget>
 -          target defined in your Makefile, and a file
 +          target defined in your <filename>Makefile</filename>, and a file
            <filename>pre-build</filename> in the <filename>scripts</filename>
            subdirectory, the <maketarget>post-extract</maketarget> target will
            be called after the regular extraction actions, and the
 @@ -583,8 +583,8 @@
          <title>Patching</title>
  
          <para>In the preparation of the port, files that have been added or
 -          changed can be picked up with a recursive diff for later feeding to
 -          patch.  Each set of patches you wish to apply should be collected
 +          changed can be picked up with a recursive &man.diff.1; for later 
 feeding to
 +          &man.patch.1;.  Each set of patches you wish to apply should be 
 collected
            into a file named
            <filename>patch-<replaceable>*</replaceable></filename> where
            <replaceable>*</replaceable> denotes the sequence in which the
 @@ -611,10 +611,10 @@
            <literal>&dollar;RCS</literal>.</para>
  
          <para>Using the recurse (<option>-r</option>) option to
 -          <command>diff</command> to generate patches is fine, but please 
 take
 +          &man.diff.1; to generate patches is fine, but please take
            a look at the resulting patches to make sure you do not have any
            unnecessary junk in there.  In particular, diffs between two backup
 -          files, <filename>Makefiles</filename> when the port uses
 +          files, <filename>Makefile</filename>s when the port uses
            <command>Imake</command> or GNU <command>configure</command>, etc.,
            are unnecessary and should be deleted.  If you had to edit
            <filename>configure.in</filename> and run
 @@ -645,7 +645,7 @@
          <title>Handling user input</title>
  
          <para>If your port requires user input to build, configure, or 
 install,
 -          then set <makevar>IS_INTERACTIVE</makevar> in your Makefile.  This
 +          then set <makevar>IS_INTERACTIVE</makevar> in your 
 <filename>Makefile</filename>.  This
            will allow <quote>overnight builds</quote> to skip your port if the
            user sets the variable <envar>BATCH</envar> in his environment (and
            if the user sets the variable <envar>INTERACTIVE</envar>, then
 @@ -663,7 +663,7 @@
      <chapter id="makefile">
        <title>Configuring the Makefile</title>
  
 -      <para>Configuring the Makefile is pretty simple, and again we suggest
 +      <para>Configuring the <filename>Makefile</filename> is pretty simple, 
 and again we suggest
          that you look at existing examples before starting. Also, there is a
          <link linkend="porting-samplem">sample Makefile</link> in this
          handbook, so take a look and please follow the ordering of variables
 @@ -671,7 +671,7 @@
          read.</para>
  
        <para>Now, consider the following problems in sequence as you design
 -        your new Makefile:</para>
 +        your new <filename>Makefile</filename>:</para>
  
        <sect1 id="makefile-source">
          <title>The original source</title>
 @@ -728,7 +728,7 @@
  	    affects the content or structure of the derived
  	    package.</para>
  
 -	  <para>Examples of when PORTREVISION should be bumped:</para>
 +	  <para>Examples of when <makevar>PORTREVISION</makevar> should be bumped:</
 para>
  
  	  <itemizedlist>
  	    <listitem>
 @@ -738,7 +738,7 @@
  	    </listitem>
  
  	    <listitem>
 -	      <para>Changes to the port makefile to enable or disable
 +	      <para>Changes to the port <filename>Makefile</filename> to enable or 
 disable
  		compile-time options in the package.</para>
  	    </listitem>
  
 @@ -810,7 +810,7 @@
  	    enhancement, fix, or by virtue that the new package will
  	    actually work for them). If yes, the
  	    <makevar>PORTREVISION</makevar> should be bumped so that
 -	    automated tools (e.g.  <command>pkg_version</command>)
 +	    automated tools (e.g.  &man.pkg.version.1;)
  	    will highlight the fact that a new package is
  	    available.</para>
  	</sect3>
 @@ -864,8 +864,8 @@
  	  <title>Example of <makevar>PORTREVISION</makevar> and
  	    <makevar>PORTEPOCH</makevar> usage</title>
  
 -	  <para>The gtkmumble port, version 0.10, is committed to the
 -	    ports collection.</para>
 +	  <para>The <literal>gtkmumble</literal> port, version <literal>0.10</
 literal>, is committed to the
 +	    ports collection:</para>
  
  	  <programlisting>PORTNAME=	gtkmumble
  PORTVERSION=	0.10</programlisting>
 @@ -895,7 +895,7 @@
  	    force the new package to be detected as <quote>newer</quote>. Since it
  	    is a new vendor release of the code,
  	    <makevar>PORTREVISION</makevar> is reset to 0 (or removed
 -	    from the makefile).</para>
 +	    from the <filename>Makefile</filename>).</para>
  
  	  <programlisting>PORTNAME=	gtkmumble
  PORTVERSION=	0.2
 @@ -918,8 +918,8 @@
            <note>
              <para>If <makevar>PORTEPOCH</makevar> were reset
                to <literal>0</literal> with this upgrade, someone who had
 -              installed the gtkmumble-0.10_1 package would not detect
 -              the gtkmumble-0.3 package as newer, since
 +              installed the <literal>gtkmumble-0.10_1</literal> package would 
 not detect
 +              the <literal>gtkmumble-0.3</literal> package as newer, since
                <literal>3</literal> is still numerically less than
                <literal>10</literal>.</para>
  	  </note>
 @@ -941,7 +941,7 @@
            hyphen (<literal>-</literal>) in
            <makevar>PORTVERSION</makevar>.  Also, if the package name
            has the <replaceable>language-</replaceable> or the
 -          <replaceable>compiled.specifics</replaceable> part, use
 +          <replaceable>-compiled.specifics</replaceable> part, use
            <makevar>PKGNAMEPREFIX</makevar> and
            <makevar>PKGNAMESUFFIX</makevar>, respectively.  Do not make
            them part of <makevar>PORTNAME</makevar>.</para>
 @@ -987,7 +987,7 @@
              should be lowercase.  (The rest of the name can contain
              capital letters, so use your own discretion when you are
              converting a software name that has some capital letters in it.)
 -            There is a tradition of naming Perl 5 modules by
 +            There is a tradition of naming <literal>perl 5</literal> modules 
 by
              prepending <literal>p5-</literal> and converting the double-colon
              separator to a hyphen; for example, the
              <literal>Data::Dumper</literal> module becomes
 @@ -1004,7 +1004,7 @@
              the compiled-in defaults (the hyphen is optional).  Examples are
              papersize and font units.</para>
  
 -          <para>The <replaceable>compiled.specifics</replaceable> part
 +          <para>The <replaceable>-compiled.specifics</replaceable> part
              should be set in the <makevar>PKGNAMESUFFIX</makevar>
              variable.</para>
          </listitem>
 @@ -1182,7 +1182,7 @@
        <para>If there is absolutely no trace of version information in the
          original source and it is unlikely that the original author will ever
          release another version, just set the version string to
 -        <literal>1.0</literal> (like the piewm example above).  Otherwise, 
 ask
 +        <literal>1.0</literal> (like the <literal>piewm</literal> example 
 above).  Otherwise, ask
          the original author or use the date string
          (<literal><replaceable>yyyy</replaceable>.<replaceable>mm</
 replaceable>.<replaceable>dd</replaceable></literal>)
  	as the version.</para>
 @@ -1500,7 +1500,7 @@
  
                <row>
                  <entry><filename>perl5*</filename></entry>
 -                <entry>Ports that require perl version 5 to run.</entry>
 +                <entry>Ports that require <literal>perl</literal> version 5 
 to run.</entry>
                </row>
  
                <row>
 @@ -1641,7 +1641,7 @@
                <row>
                  <entry><filename>windowmaker*</filename></entry>
                  <entry>Ports to support the WindowMaker window
 -                  manager</entry>
 +                  manager.</entry>
                </row>
  
                <row>
 @@ -2608,7 +2608,7 @@
  
          <note>
            <para>This does not affect the <makevar>MASTER_SITES</makevar> you
 -            define in your Makefile.</para>
 +            define in your <filename>Makefile</filename>.</para>
          </note>
        </sect2>
      </sect1>
 @@ -2680,7 +2680,7 @@
              <maketarget>extract</maketarget> target and then from within the
              <maketarget>install</maketarget> target.  Also, the name of the
              dependency is put into the package so that
 -            <command>pkg_add</command> will automatically install it if it is
 +            &man.pkg.add.1; will automatically install it if it is
              not on the user's system.</para>
          </sect2>
  
 @@ -2725,7 +2725,7 @@
            <para>The dependency is checked from within the
              <maketarget>install</maketarget> target.  Also, the name of the
              dependency is put into the  package so that
 -            <command>pkg_add</command> will automatically install it if it is
 +            &man.pkg.add.1; will automatically install it if it is
              not on the user's system.  The <replaceable>target</replaceable>
              part can be omitted if it is the same as
              <makevar>DEPENDS_TARGET</makevar>.</para>
 @@ -2829,9 +2829,9 @@
  	      <row>
  		<entry><makevar>USE_PERL5</makevar></entry>
  
 -		<entry>The port requires Perl 5 to build and install.  See
 +		<entry>The port requires <literal>perl 5</literal> to build and install.  
 See
  		  <xref linkend="using-perl"> for additional variables that
 -		  can be set relating to Perl.</entry>
 +		  can be set relating to <literal>perl</literal>.</entry>
  	      </row>
  
  	      <row>
 @@ -2903,8 +2903,8 @@
              GNU autoconf to be run.  Define <literal>USE_QT=yes</literal> if
              your port uses the latest qt toolkit.  Use
              <literal>USE_PERL5=yes</literal> if your port requires version 5
 -            of the perl language.  (The last is especially important since
 -            some versions of FreeBSD have perl5 as part of the base system
 +            of the <literal>perl</literal> language.  (The last is especially 
 important since
 +            some versions of FreeBSD have <literal>perl5</literal> as part of 
 the base system
              while others do not.)</para>
          </sect2>
  
 @@ -2935,7 +2935,7 @@
  
              <programlisting>BUILD_DEPENDS=   ${NONEXISTENT}:${PORTSDIR}/
 graphics/jpeg:extract</programlisting>
  
 -            will always descend to the JPEG port and extract it.</para>
 +            will always descend to the <literal>jpeg</literal> port and 
 extract it.</para>
  
            <para>Do not use <makevar>DEPENDS</makevar> unless there is no 
 other
              way the behavior you want can be accomplished.  It will cause the
 @@ -3219,10 +3219,10 @@
      </sect1>
  
      <sect1 id="using-perl">
 -      <title>Using Perl</title>
 +      <title>Using <literal>perl</literal></title>
  
        <table frame="none">
 -	<title>Variables for ports that use Perl</title>
 +	<title>Variables for ports that use <literal>perl</literal></title>
  
  	<tgroup cols="2">
  	  <thead>
 @@ -3237,7 +3237,7 @@
  	    <row>
  	      <entry><makevar>USE_PERL5</makevar></entry>
  
 -	      <entry>Says that the port uses Perl 5 to build and run.</entry>
 +	      <entry>Says that the port uses <literal>perl 5</literal> to build and 
 run.</entry>
  	    </row>
  
  	    <row>
 @@ -3260,28 +3260,28 @@
  	    <row>
  	      <entry><makevar>PERL_VERSION</makevar></entry>
  	      
 -	      <entry>The full version of Perl installed (e.g.,
 +	      <entry>The full version of <literal>perl</literal> installed (e.g.,
  		<literal>5.00503</literal>).</entry>
  	    </row>
  	    
  	    <row>
  	      <entry><makevar>PERL_VER</makevar></entry>
  	      
 -	      <entry>The short version of Perl installed (e.g.,
 +	      <entry>The short version of <literal>perl</literal> installed (e.g.,
  		<literal>5.005</literal>).</entry>
  	    </row>
  
              <row>
                <entry><makevar>PERL_LEVEL</makevar></entry>
  
 -              <entry>The installed Perl version as an integer of the form 
 MNNNPP
 +              <entry>The installed <literal>perl</literal> version as an 
 integer of the form <literal>MNNNPP</literal>
                  (e.g., <literal>500503</literal>).</entry>
  	    </row>
  	    
  	    <row>
  	      <entry><makevar>PERL_ARCH</makevar></entry>
  	      
 -	      <entry>Where Perl stores architecture dependent libraries.
 +	      <entry>Where <literal>perl</literal> stores architecture dependent 
 libraries.
  		Defaults to <literal>${ARCH}-freebsd</literal>.</entry>
  	    </row>
  	  </tbody>
 @@ -3751,7 +3751,7 @@
        <sect1>
          <title><makevar>LIB_DEPENDS</makevar></title>
  
 -        <para>All port Makefiles are edited to remove minor numbers from
 +        <para>All port <filename>Makefile</filename>s are edited to remove 
 minor numbers from
            <makevar>LIB_DEPENDS</makevar>, and also to have the regexp support
            removed.  (E.g., <literal>foo\\.1\\.\\(33|40\\)</literal> becomes
            <literal>foo.2</literal>.)  They will be matched using 
 <command>grep
 @@ -3782,7 +3782,7 @@
        <sect1>
          <title><literal>ldconfig</literal></title>
  
 -        <para>The <literal>ldconfig</literal> line in Makefiles should
 +        <para>The <literal>ldconfig</literal> line in <filename>Makefile</
 filename>s should
            read:</para>
  
          <programlisting>${SETENV} OBJFORMAT=${PORTOBJFORMAT} ${LDCONFIG} 
 -m ....</programlisting>
 @@ -3809,7 +3809,7 @@
          make it easier for users to see what to do, but try to share as many
          files as possible between ports.  Typically you only need a very 
 short
          <filename>Makefile</filename> in all but one of the directories if 
 you
 -        use variables cleverly.  In the sole <filename>Makefiles</filename>,
 +        use variables cleverly.  In the sole <filename>Makefile</filename>,
          you can use <makevar>MASTERDIR</makevar> to specify the directory
          where the rest of the files are.  Also, use a variable as part of
          <link linkend="porting-pkgname"><makevar>PKGNAMESUFFIX</makevar></
 link> so
 @@ -3932,7 +3932,7 @@
        <para>If your port anchors its man tree somewhere other than
          <makevar>PREFIX</makevar>, you can use the
          <makevar>MANPREFIX</makevar> to set it.  Also, if only manpages in
 -        certain sections go in a non-standard place, such as some Perl 
 modules
 +        certain sections go in a non-standard place, such as some 
 <literal>perl</literal> modules
          ports, you can set individual man paths using
          <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar> (where
          <replaceable>sect</replaceable> is one of <literal>1-9</literal>,
 @@ -3986,7 +3986,7 @@
          <title><makevar>USE_MOTIF</makevar></title>
  
          <para>If your port requires Motif, define this variable in the
 -          Makefile.  This will prevent people who do not own a copy of Motif
 +          <filename>Makefile</filename>.  This will prevent people who do not 
 own a copy of Motif
            from even attempting to build it.</para>
        </sect1>
  
 @@ -4059,7 +4059,7 @@
          <para>If you need to display a message to the installer, you may 
 place
            the message in <filename>pkg-message</filename>.  This capability 
 is
            often useful to display additional installation steps to be taken
 -          after a <command>pkg_add</command> or to display licensing
 +          after a &man.pkg.add.1; or to display licensing
            information.</para>
  
          <note>
 @@ -4075,10 +4075,10 @@
          <title><filename>pkg-install</filename></title>
  
          <para>If your port needs to execute commands when the binary package
 -          is installed with <command>pkg_add</command> you can do this via 
 the
 +          is installed with &man.pkg.add.1; you can do this via the
            <filename>pkg-install</filename> script.  This script will
            automatically be added to the package, and will be run twice by
 -          <command>pkg_add</command>.  The first time as
 +          &man.pkg.add.1;.  The first time as
            <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME}
            PRE-INSTALL</literal> and the second time as
            <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME} POST-INSTALL</
 literal>. 
 @@ -4119,7 +4119,7 @@
            installation/deinstallation should proceed.</para>
  
          <para>The script will be run at installation time by
 -          <command>pkg_add</command> as
 +          &man.pkg.add.1; as
            <literal>pkg-req &dollar;{PKGNAME} INSTALL</literal>.
            At deinstallation time it will be run by
            &man.pkg.delete.1; as
 @@ -4130,17 +4130,17 @@
          <title>Changing <filename>pkg-plist</filename> based on make
            variables</title>
  
 -        <para>Some ports, particularly the p5- ports, need to change their
 +        <para>Some ports, particularly the <literal>p5-</literal> ports, need 
 to change their
            <filename>pkg-plist</filename> depending on what options they are
 -          configured with (or version of perl, in the case of p5- ports).  To
 +          configured with (or version of <literal>perl</literal>, in the case 
 of <literal>p5-</literal> ports).  To
            make this easy, any instances in the <filename>pkg-plist</filename> 
 of
            <literal>%%OSREL%%</literal>, <literal>%%PERL_VER%%</literal>, and
            <literal>%%PERL_VERSION%%</literal> will be substituted for
            appropriately.  The value of <literal>%%OSREL%%</literal> is the
            numeric revision of the operating system (e.g.,
            <literal>2.2.7</literal>).  <literal>%%PERL_VERSION%%</literal> is
 -          the full version number of perl (e.g., <literal>5.00502</literal>)
 -          and <literal>%%PERL_VER%%</literal> is the perl version number 
 minus
 +          the full version number of <literal>perl</literal> (e.g., 
 <literal>5.00502</literal>)
 +          and <literal>%%PERL_VER%%</literal> is the <literal>perl</literal> 
 version number minus
            the patchlevel (e.g., <literal>5.005</literal>).</para>
  
          <para>If you need to make other substitutions, you can set the
 @@ -4280,7 +4280,7 @@
            automatic; otherwise, this can often be done by simply replacing 
 the
            occurrences of <filename>/usr/local</filename> (or
            <filename>/usr/X11R6</filename> for X ports that do not use imake)
 -          in the various scripts/Makefiles in the port to read
 +          in the various <filename>scripts/Makefile</filename>s in the port 
 to read
            <makevar>PREFIX</makevar>, as this variable is automatically passed
            down to every stage of the build and install processes.</para>
  
 @@ -4308,7 +4308,7 @@
          <para>The variable <makevar>PREFIX</makevar> can be reassigned in 
 your
            <filename>Makefile</filename> or in the user's environment.
            However, it is strongly discouraged for individual ports to set 
 this
 -          variable explicitly in the <filename>Makefiles</filename>.</para>
 +          variable explicitly in the <filename>Makefile</filename>s.</para>
  
          <para>Also, refer to programs/files from other ports with the
            variables mentioned above, not explicit pathnames.  For instance, 
 if
 @@ -4324,7 +4324,7 @@
            if this is an X port, instead of
            <literal>-DPAGER=\"/usr/local/bin/less\"</literal>. This way it 
 will
            have a better chance of working if the system administrator has
 -          moved the whole `/usr/local' tree somewhere else.</para>
 +          moved the whole <filename>/usr/local</filename> tree somewhere 
 else.</para>
        </sect1>
  
        <sect1 id="testing-freshports">
 @@ -4337,11 +4337,11 @@
  	  testing of your commits.</para>
  
  	<para>If you wish to use this service, all you need is a FreshPorts
 -	  account.  If your registered email address is @FreeBSD.org,
 +	  account.  If your registered email address is <literal>@FreeBSD.org</
 literal>,
  	  you'll see the opt-in link on the right hand side of the webpages.
  	  For those of you who already have a FreshPorts account, but are not
 -	  using your @FreeBSD.org email address, just change your email to
 -	  @FreeBSD.org, subscribe, then change it back again.</para>
 +	  using your <literal>@FreeBSD.org</literal> email address, just change your 
 email to
 +	  <literal>@FreeBSD.org</literal>, subscribe, then change it back again.</
 para>
        </sect1>
    </chapter>
  
 @@ -5588,8 +5588,8 @@
  
          <note>
            <para>You need to include either the
 -            <filename>pre.mk</filename>/<filename>post.mk</filename> pair or
 -            <filename>bsd.port.mk</filename> only; do not mix these two.</
 para>
 +            <filename>bsd.port.pre.mk</filename>/<filename>bsd.port.post.mk</
 filename> pair or
 +            <filename>bsd.port.mk</filename> only; do not mix these two 
 usages.</para>
          </note>
  
          <para><filename>bsd.port.pre.mk</filename> only defines a few
 @@ -5776,7 +5776,7 @@
            (executables started internally), <filename>sbin</filename>
            (executables for superusers/managers), <filename>info</filename>
            (documentation for info browser) or  <filename>share</filename>
 -          (architecture independent files).  See man &man.hier.7; for 
 details,
 +          (architecture independent files).  See &man.hier.7; for details;
            the rules governing
            <filename>/usr</filename> pretty much apply to
            <filename>/usr/local</filename> too.  The exception are ports
 @@ -5810,7 +5810,7 @@
          <programlisting>@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</
 programlisting>
  
          <para>This will neither print any error messages nor cause
 -          <command>pkg_delete</command> to exit abnormally even if
 +          &man.pkg.delete.1; to exit abnormally even if
            <filename><makevar>PREFIX</makevar>/share/doc/gimp</filename> is 
 not
            empty due to other ports installing some files in there.</para>
        </sect1>
 @@ -5953,7 +5953,7 @@
            <filename><makevar>PREFIX</makevar>/etc</filename>, do
            <emphasis>not</emphasis> just install them and list them in
            <filename>pkg-plist</filename>.  That will cause
 -          <command>pkg_delete</command> to delete files carefully edited by
 +          &man.pkg.delete.1; to delete files carefully edited by
            the user and a new installation to wipe them out.</para>
  
          <para>Instead, install sample files with a suffix
 @@ -5998,7 +5998,7 @@
  	Please use the correct <command>make</command> variable as
  	each make variable conveys radically different meanings to
  	both users, and to automated systems that parse
 -	<filename>Makefiles</filename>.</para>
 +	<filename>Makefile</filename>s.</para>
  
  	<itemizedlist>
  	  <listitem>
 
State-Changed-From-To: open->closed 
State-Changed-By: ceri 
State-Changed-When: Fri Oct 17 10:34:03 PDT 2003 
State-Changed-Why:  
Committed.  Blimey. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=53420 
>Unformatted:
