From owner-freebsd-doc@FreeBSD.ORG Tue Nov 23 03:42:32 2010 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4DAB51065670; Tue, 23 Nov 2010 03:42:32 +0000 (UTC) (envelope-from jhelfman@experts-exchange.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [72.29.183.251]) by mx1.freebsd.org (Postfix) with ESMTP id 1DA548FC19; Tue, 23 Nov 2010 03:42:31 +0000 (UTC) Received: from mail.experts-exchange.com (localhost [127.0.0.1]) by mail.experts-exchange.com (Postfix) with ESMTP id 8A2637464F6; Mon, 22 Nov 2010 19:42:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=e-e.com; h= user-agent:in-reply-to:content-disposition:content-type :content-type:mime-version:references:message-id:subject:subject :from:from:date:date:received:received:received; s=ee; t= 1290483751; x=1292298151; bh=Swdme5jgNpr0+oKHbNfoWu1aECy3gdkJ3st auEKUDZo=; b=Gbiwy6SXZEKukHmPluiWa/lZagK8z1w/Nup33Mv2Uu1xXWetkoW i9gRcCf3nScws+QVU84rj3cNkpLEehEINu89Q9UbLMCaQtTWZQCvDrShYawVpVML dEffKIKviZCu/zYDIopo8wE/6FQa13lefVxYyZvUarzWEsE/MvCY9Azg= X-Virus-Scanned: amavisd-new at experts-exchange.com Received: from mail.experts-exchange.com ([127.0.0.1]) by mail.experts-exchange.com (mail.experts-exchange.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Mnn5VFiDG60h; Mon, 22 Nov 2010 19:42:31 -0800 (PST) Received: from experts-exchange.com (unknown [192.168.103.122]) by mail.experts-exchange.com (Postfix) with SMTP id 3088C7464F0; Mon, 22 Nov 2010 19:42:31 -0800 (PST) Received: (nullmailer pid 66709 invoked by uid 1001); Tue, 23 Nov 2010 03:39:30 -0000 Date: Mon, 22 Nov 2010 19:39:30 -0800 From: Jason Helfman To: Torfinn Ingolfsen Message-ID: <20101123033930.GA66678@eggman.experts-exchange.com> References: <4CE7EC0D.9000203@a1poweruser.com> <4CE969B6.90900@kc8onw.net> <201011211909.23708.beech@akherb.com> <20101122052649.GA61979@comcast.net> <4CEA0738.3060701@unfs.us> <20101122072257.GF48679@comcast.net> <20101122131905.318b590c@gumby.homeunix.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="3MwIy2ne0vdjdPXF" Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 8.1-RELEASE X-Living-The-Dream: I love the SLO Life! User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org, manolis@freebsd.org, FreeBSD Ports Subject: Re: PR's not being picked up (Was Re: becoming a port committor) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 23 Nov 2010 03:42:32 -0000 --3MwIy2ne0vdjdPXF Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline 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 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-unsubscribe@freebsd.org" > --3MwIy2ne0vdjdPXF Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="patch.txt" --- 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;. + If you are contributing a patch for a port, please do not + submit a shar. The recommeded way for submission of a patch is by using a utility + called /usr/bin/diff which is included as part of the base &os; + distribution. To create a suitable diff, copy the file that + needs patching to something.orig. Save your changes to + something and then create your patch. + + + &prompt.user; /usr/bin/diff something.orig something > somthing.diff + + + + Please see the aforementioned step for submission of something.diff + to &os; for consideration by using the &man.send-pr.1; program. + + 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 Additional FreeBSD Contributors --3MwIy2ne0vdjdPXF--