From owner-freebsd-doc@FreeBSD.ORG Tue Jun 17 13:40:07 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2557B37B401 for ; Tue, 17 Jun 2003 13:40:07 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 93C0343FB1 for ; Tue, 17 Jun 2003 13:40:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h5HKe4Up003294 for ; Tue, 17 Jun 2003 13:40:04 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h5HKe4eV003293; Tue, 17 Jun 2003 13:40:04 -0700 (PDT) Resent-Date: Tue, 17 Jun 2003 13:40:04 -0700 (PDT) Resent-Message-Id: <200306172040.h5HKe4eV003293@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Mark Linimon Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CD7C637B401 for ; Tue, 17 Jun 2003 13:39:43 -0700 (PDT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0705943FA3 for ; Tue, 17 Jun 2003 13:39:43 -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 47DC4140CD for ; Tue, 17 Jun 2003 15:39:42 -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 h5HKhtNa027305 for ; Tue, 17 Jun 2003 15:43:55 -0500 (CDT) (envelope-from linimon@lonesome.lonesome.com) Received: (from linimon@localhost) by lonesome.lonesome.com (8.12.9/8.12.6/Submit) id h5HKhs1J027304; Tue, 17 Jun 2003 15:43:54 -0500 (CDT) (envelope-from linimon) Message-Id: <200306172043.h5HKhs1J027304@lonesome.lonesome.com> Date: Tue, 17 Jun 2003 15:43:54 -0500 (CDT) From: Mark Linimon To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113.1 Subject: docs/53421: [patch] rework of parts of Porter's Handbook part 2 of 5: whitespace fixes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jun 2003 20:40:07 -0000 >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 @@ Patching 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 patch-* where * 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. - Examples of when PORTREVISION should be bumped: + Examples of when PORTREVISION + should be bumped: @@ -862,7 +864,8 @@ Example of <makevar>PORTREVISION</makevar> and <makevar>PORTEPOCH</makevar> usage - The gtkmumble port, version 0.10, is committed to the + The gtkmumble port, + version 0.10, is committed to the ports collection: PORTNAME= gtkmumble @@ -4332,17 +4335,21 @@ Changing <filename>pkg-plist</filename> based on make variables - Some ports, particularly the p5- ports, need to change their + Some ports, particularly the p5- ports, + need to change their pkg-plist depending on what options they are - configured with (or version of perl, in the case of p5- ports). To + configured with (or version of perl, in the case + of p5- ports). To make this easy, any instances in the pkg-plist of %%OSREL%%, %%PERL_VER%%, and %%PERL_VERSION%% will be substituted for appropriately. The value of %%OSREL%% is the numeric revision of the operating system (e.g., 2.2.7). %%PERL_VERSION%% is - the full version number of perl (e.g., 5.00502) - and %%PERL_VER%% is the perl version number minus + the full version number of perl (e.g., + 5.00502) + and %%PERL_VER%% is the perl + version number minus the patchlevel (e.g., 5.005). If you need to make other substitutions, you can set the @@ -4534,10 +4541,12 @@ testing of your commits. 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 + @FreeBSD.org, 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 + using your @FreeBSD.org email address, + just change your email to @FreeBSD.org, subscribe, then change it back again. @@ -4666,7 +4678,8 @@ Do not write anything to files outside WRKDIR. WRKDIR is the only place that is guaranteed to be writable during the port build (see - compiling ports from CDROM for an + + compiling ports from CDROM for an example of building ports from a read-only tree). If you need to modify one of the pkg-* files, do so by Release-Note: >Audit-Trail: >Unformatted: