docs/53421: [patch] rework of parts of Porter's Handbook part 2 of 5: whitespace fixes

Mark Linimon linimon at lonesome.com
Tue Jun 17 20:40:07 UTC 2003


>Number:         53421
>Category:       docs
>Synopsis:       [patch] rework of parts of Porter's Handbook part 2 of 5: whitespace fixes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 17 13:40:04 PDT 2003
>Closed-Date:
>Last-Modified:
>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 at 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 second piece
	fixes whitespace issues; translators should be able to ignore.
>How-To-Repeat:
	n/a
>Fix:

--- book.sgml.style_only	Mon May 12 20:48:38 2003
+++ book.sgml	Mon May 12 21:54:56 2003
@@ -581,9 +582,9 @@
         <title>Patching</title>
 
         <para>In the preparation of the port, files that have been added or
-          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
+          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
           patches will be applied — these are done in
@@ -726,7 +727,8 @@
 	    affects the content or structure of the derived
 	    package.</para>
 
-	  <para>Examples of when <makevar>PORTREVISION</makevar> should be bumped:</para>
+	  <para>Examples of when <makevar>PORTREVISION</makevar>
+	    should be bumped:</para>
 
 	  <itemizedlist>
 	    <listitem>
@@ -862,7 +864,8 @@
 	  <title>Example of <makevar>PORTREVISION</makevar> and
 	    <makevar>PORTEPOCH</makevar> usage</title>
 
-	  <para>The <literal>gtkmumble</literal> port, version <literal>0.10</literal>, is committed to the
+	  <para>The <literal>gtkmumble</literal> port,
+	    version <literal>0.10</literal>, is committed to the
 	    ports collection:</para>
 
 	  <programlisting>PORTNAME=	gtkmumble
@@ -4332,17 +4335,21 @@
         <title>Changing <filename>pkg-plist</filename> based on make
           variables</title>
 
-        <para>Some ports, particularly the <literal>p5-</literal> 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 <literal>perl</literal>, in the case of <literal>p5-</literal> 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 <literal>perl</literal> (e.g., <literal>5.00502</literal>)
-          and <literal>%%PERL_VER%%</literal> is the <literal>perl</literal> 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
@@ -4534,10 +4541,12 @@
 	  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 <literal>@FreeBSD.org</literal>,
+	  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 <literal>@FreeBSD.org</literal> email address, just change your email to
+	  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>
@@ -4666,7 +4678,8 @@
         <para>Do not write anything to files outside
           <makevar>WRKDIR</makevar>.  <makevar>WRKDIR</makevar> is the only
           place that is guaranteed to be writable during the port build (see
-          <ulink url="../handbook/ports-using.html#PORTS-CD">compiling ports from CDROM</ulink> for an
+          <ulink url="../handbook/ports-using.html#PORTS-CD">
+          compiling ports from CDROM</ulink> for an
           example of building ports from a read-only tree).  If you need to
           modify one of the <filename>pkg-<replaceable>*</replaceable></filename>
           files, do so by <link
>Release-Note:
>Audit-Trail:
>Unformatted:



More information about the freebsd-doc mailing list