Date: Tue, 17 Jun 2003 15:43:54 -0500 (CDT) From: Mark Linimon <linimon@lonesome.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/53421: [patch] rework of parts of Porter's Handbook part 2 of 5: whitespace fixes Message-ID: <200306172043.h5HKhs1J027304@lonesome.lonesome.com> Resent-Message-ID: <200306172040.h5HKe4eV003293@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200306172043.h5HKhs1J027304>