atom feed28 messages in org.freebsd.freebsd-portsRe: PR's not being picked up (Was Re:...
FromSent OnAttachments
Fbsd8Nov 20, 2010 7:40 am 
Oskar HolmlundNov 20, 2010 8:21 am 
Byung-Hee HWANGNov 20, 2010 8:27 am 
EricNov 20, 2010 8:49 am 
Chris ReesNov 20, 2010 8:50 am 
Masoom ShaikhNov 20, 2010 8:59 am 
Beech RintoulNov 20, 2010 8:56 pm 
Byung-Hee HWANGNov 20, 2010 10:07 pm 
JonathanNov 21, 2010 10:49 am 
Torfinn IngolfsenNov 21, 2010 4:11 pm 
Beech RintoulNov 21, 2010 8:09 pm 
Charlie KesterNov 21, 2010 9:26 pm 
Janky Jay, IIINov 21, 2010 10:01 pm 
AnonymousNov 21, 2010 10:46 pm 
Charlie KesterNov 21, 2010 11:22 pm 
Beech RintoulNov 22, 2010 4:17 am 
RWNov 22, 2010 5:18 am 
Ion-Mihai TetcuNov 22, 2010 9:19 am 
Mark LinimonNov 22, 2010 10:22 am 
Torfinn IngolfsenNov 22, 2010 10:58 am 
Greg ByshenkNov 22, 2010 11:25 am 
Charlie KesterNov 22, 2010 2:07 pm 
RWNov 22, 2010 2:14 pm 
Beech RintoulNov 22, 2010 2:32 pm 
Jason HelfmanNov 22, 2010 7:39 pm.txt
Torfinn IngolfsenNov 22, 2010 10:53 pm 
Jason HelfmanNov 23, 2010 11:59 am.txt
Mark LinimonNov 28, 2010 2:12 pm 
Subject:Re: PR's not being picked up (Was Re: becoming a port committor)
From:Jason Helfman (jhel@e-e.com)
Date:Nov 22, 2010 7:39:07 pm
List:org.freebsd.freebsd-ports
Attachments:

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 <rwma@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.

--- 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>