From owner-freebsd-doc@FreeBSD.ORG Fri Feb 29 14:40:03 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E33B11065672 for ; Fri, 29 Feb 2008 14:40:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D0C0C8FC24 for ; Fri, 29 Feb 2008 14:40:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m1TEe3u1045854 for ; Fri, 29 Feb 2008 14:40:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m1TEe3AL045849; Fri, 29 Feb 2008 14:40:03 GMT (envelope-from gnats) Date: Fri, 29 Feb 2008 14:40:03 GMT Message-Id: <200802291440.m1TEe3AL045849@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Chess Griffin Cc: Subject: Re: docs/121197: [patch] edits to books/porters-handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Chess Griffin List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 29 Feb 2008 14:40:04 -0000 The following reply was made to PR docs/121197; it has been noted by GNATS. From: Chess Griffin To: bug-followup@FreeBSD.org, chess@chessgriffin.com Cc: Subject: Re: docs/121197: [patch] edits to books/porters-handbook Date: Fri, 29 Feb 2008 09:30:04 -0500 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig72A61CB56C75BDF0A54BF848 Content-Type: multipart/mixed; boundary="------------050801060003020905080601" This is a multi-part message in MIME format. --------------050801060003020905080601 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: quoted-printable Pav, Thanks for the comments. Yes, other than the two lines of new content=20 added at line 8591 regarding genplist, the other changes are just minor=20 grammatical edits. I have attached a new patch without the rewrapping. Sorry about that -- = just habit, I guess. :-) --=20 Chess Griffin GPG Key: 0x0C7558C3 http://www.chessgriffin.com --------------050801060003020905080601 Content-Type: text/plain; name="porters.diff" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline; filename="porters.diff" --- book.sgml.orig 2008-02-28 19:06:47.000000000 -0500 +++ book.sgml 2008-02-29 09:12:24.000000000 -0500 @@ -2465,10 +2465,10 @@ hereon. =20 A little background first. OpenBSD has a neat feature - inside both DISTFILES and - PATCHFILES variables, both files and - patches can be postfixed with :n - identifiers where n both can be + inside the DISTFILES and + PATCHFILES variables which allows files and + patches to be postfixed with :n + identifiers, where n both can be [0-9] and denote a group designation. For example: =20 @@ -2489,7 +2489,7 @@ as hell where beta is carried by all sites in MASTER_SITES, and alpha can only be found in the 20th - site. It would be such a waste to check all of them if + site. It would be such a waste to check all of them if the maintainer knew this beforehand, would it not? Not a good start for that lovely weekend! =20 @@ -3174,7 +3174,7 @@ challenge for port maintainers section. =20 Changes to the port will be sent to the maintainer of - a port for a review and an approval before being committed. + a port for review and approval before being committed. If the maintainer does not respond to an update request after two weeks (excluding major public holidays), then that is considered a maintainer timeout, and the @@ -3191,7 +3191,7 @@ Collection without explicit blessing from the submitter. Also, large infrastructural changes can result in a port being modified without maintainer's consent. - This kind of changes will never affect the port's + These kinds of changes will never affect the port's functionality. =20 The &a.portmgr; reserves the right to revoke or override @@ -4181,7 +4181,7 @@ =20 Two macros exists for this situation. The advantage of using these macros instead of cp is that they guarantee - proper file ownership and permissions on target files. First macro, + proper file ownership and permissions on target files. The first mac= ro, COPYTREE_BIN, will set all the installed files to be executable, thus being suitable for installing into PREFIX/bin. The second @@ -8591,6 +8591,12 @@ The packing list still has to be tidied up by hand as stated above. =20 + Another tool that might be used to create an initial + pkg-plist is ports-mgmt/genplist. As with any + automated tool, the resulting pkg-plist + should be checked and manually edited as needed. + =20 @@ -11809,7 +11815,7 @@ 7.0-CURRENT after RFC 3678 API support added to the IPv4 stack. - Legacy RFC 1724 behaviour of the IP_MULTICAST_IF + Legacy RFC 1724 behavior of the IP_MULTICAST_IF ioctl has now been removed; 0.0.0.0/8 may no longer be used to specify an interface index. struct ipmreqn should be used instead. --------------050801060003020905080601-- --------------enig72A61CB56C75BDF0A54BF848 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (MingW32) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFHyBbvKzd9mAx1WMMRAkx2AJ943mENHi7RHKGeh3wNs24nRKXciACeL8qN +0DECAdxvfLQP6RgFC5M9Ek= =JLbg -----END PGP SIGNATURE----- --------------enig72A61CB56C75BDF0A54BF848--