Date: Fri, 29 Feb 2008 14:40:03 GMT From: Chess Griffin <chess@chessgriffin.com> To: freebsd-doc@FreeBSD.org Subject: Re: docs/121197: [patch] edits to books/porters-handbook Message-ID: <200802291440.m1TEe3AL045849@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/121197; it has been noted by GNATS. From: Chess Griffin <chess@chessgriffin.com> 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.</para> =20 <para>A little background first. OpenBSD has a neat feature - inside both <makevar>DISTFILES</makevar> and - <makevar>PATCHFILES</makevar> variables, both files and - patches can be postfixed with <literal>:n</literal> - identifiers where <literal>n</literal> both can be + inside the <makevar>DISTFILES</makevar> and + <makevar>PATCHFILES</makevar> variables which allows files and + patches to be postfixed with <literal>:n</literal> + identifiers, where <literal>n</literal> both can be <literal>[0-9]</literal> and denote a group designation. For example:</para> =20 @@ -2489,7 +2489,7 @@ as hell where <filename>beta</filename> is carried by all sites in <makevar>MASTER_SITES</makevar>, and <filename>alpha</filename> 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!</para> =20 @@ -3174,7 +3174,7 @@ challenge for port maintainers</ulink> section.</para> =20 <para>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.</para> =20 <para>The &a.portmgr; reserves the right to revoke or override @@ -4181,7 +4181,7 @@ =20 <para>Two macros exists for this situation. The advantage of using these macros instead of <command>cp</command> 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, <makevar>COPYTREE_BIN</makevar>, will set all the installed files to be executable, thus being suitable for installing into <filename><makevar>PREFIX</makevar>/bin</filename>. The second @@ -8591,6 +8591,12 @@ <para>The packing list still has to be tidied up by hand as stated above.</para> =20 + <para>Another tool that might be used to create an initial + <filename>pkg-plist</filename> is <filename + role=3D"package">ports-mgmt/genplist</filename>. As with any + automated tool, the resulting <filename>pkg-plist</filename> + should be checked and manually edited as needed.</para> + </sect1> =20 </chapter> @@ -11809,7 +11815,7 @@ <row> <entry>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.</entry> --------------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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200802291440.m1TEe3AL045849>