I put together this patch. I hope this is sufficient.
Thanks!
Jason
On Mon, Nov 22, 2010 at 07:58:56PM +0100, Torfinn Ingolfsen thus spake:
Hi,
On Mon, Nov 22, 2010 at 2:19 PM, RW <rwmailli...@googlemail.com> wrote:
Actually it does discuss the wording of the synopsis for both new and
updated ports which gives the impression that that that section covers
both.
Furthermore the update chapter is at the opposite end of the
index under the single misleading word "Upgrading". There's no mention
of "submitting" which is what people will be looking for.
IMO chapter 10 should either be 3.7 or be merged into 3.6. If anything
deserves to be under "Quick Porting" it's this.
So then we will see your PR for an update of that chapter in the Porter's
Handbook in the next few days perhaps?
The trouble is that even when people do read handbooks from beginning
to end there are always sections that that they are likely to skip
until they need them, and this is one of them.
The Porter's Handbook is not going to be improved unless the people who read
it and have ideas for improvement do something about it.
HTH, HAND.
--
Regards,
Torfinn Ingolfsen
_______________________________________________
freebsd-ports@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"
--- porters-handbook/book.sgml 2010-11-22 18:56:43.000000000 -0800
+++ porters-handbook/book.sgml.my 2010-11-22 19:34:25.000000000 -0800
@@ -412,6 +412,22 @@
url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports";>ports
waiting to be committed to &os;</ulink>.</para>
+ <para>If you are contributing a patch for a port, please <emphasis>do
not</emphasis>
+ submit a shar. The recommeded way for submission of a patch is by
using a utility
+ called <command>/usr/bin/diff</command> which is included as part of
the base &os;
+ distribution. To create a suitable <command>diff</command>, copy the
file that
+ needs patching to <replaceable>something.orig</replaceable>. Save
your changes to
+ <replaceable>something</replaceable> and then create your
patch.</para>
+
+ <informalexample>
+ <screen>&prompt.user; <userinput>/usr/bin/diff something.orig
something > somthing.diff
+ </userinput></screen>
+ </informalexample>
+
+ <para>Please see the aforementioned step for submission of
<replaceable>something.diff
+ </replaceable> to &os; for consideration by using the &man.send-pr.1;
program.
+ </para>
+
<para>Once we have looked at your port, we will get back to you if
necessary, and put
it in the tree. Your name will also appear in the list of
<ulink
url="&url.articles.contributors;/contrib-additional.html">Additional FreeBSD
Contributors</ulink>
_______________________________________________
freebsd-ports@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"
