From owner-freebsd-ports@FreeBSD.ORG Mon Dec 8 10:37:10 2003 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 04D2416A4CE for ; Mon, 8 Dec 2003 10:37:10 -0800 (PST) Received: from smtpout.mac.com (A17-250-248-44.apple.com [17.250.248.44]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6609F43FA3 for ; Mon, 8 Dec 2003 10:37:08 -0800 (PST) (envelope-from cswiger@mac.com) Received: from mac.com (smtpin08-en2 [10.13.10.153]) by smtpout.mac.com (Xserve/MantshX 2.0) with ESMTP id hB8IeLoW011274; Mon, 8 Dec 2003 10:40:21 -0800 (PST) Received: from [10.1.1.193] (nfw2.codefab.com [66.234.138.66]) (authenticated bits=0) by mac.com (Xserve/smtpin08/MantshX 3.0) with ESMTP id hB8Ib7xO005695; Mon, 8 Dec 2003 10:37:07 -0800 (PST) In-Reply-To: <3FD25400.70403@lonesome.com> References: <20031205025342.04faf48b.sheepkiller@cultdeadsheep.org> <3FD013E7.7080302@lonesome.com> <3FD25400.70403@lonesome.com> Mime-Version: 1.0 (Apple Message framework v606) Content-Type: text/plain; charset=US-ASCII; format=flowed Message-Id: <8E1DAD82-29AE-11D8-BC14-003065ABFD92@mac.com> Content-Transfer-Encoding: 7bit From: Charles Swiger Date: Mon, 8 Dec 2003 13:44:29 -0500 To: Mark Linimon X-Mailer: Apple Mail (2.606) cc: ports@FreeBSD.org Subject: Re: [DRAFT] ports contributor's guide X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Dec 2003 18:37:10 -0000 On Dec 6, 2003, at 5:11 PM, Mark Linimon wrote: >> "Second opinion -- duplicates ports/misc/foo1 ... 4" >> >> ...or some such, indicating that the reviewer wants a second opinion >> from someone else as to whether the port should be committed (and >> what the issue is), leaving the PR open and the port uncommitted? > > Of course. That's why we have humans as committers :-) Well, yes. It's nice that we agree here (I'd be afraid of inhuman committers :-), but was there more to your comments then this? Are you suggesting a procedure by which a committer who has some doubts about a port should handle the situation? Are you trying to come up with additional tests reminiscient of the "2.4 Testing the port" chapter of the Porter's Handbook that committers should apply? As discussed below, I don't think adding the "make sure your port is useful" test to the PH would be helpful as written, but perhaps "2.6 Submitting the port" could be extended with more details about the actions taken by a committer when reviewing a port submission (ie, testing it with portlint et al, checking to see whether the port is filed in the right category, seeing whether the port submission duplicates existing ports, etc). I think guidelines like these would indicate that there is a review process AND also help explain why it takes a while for submissions to be processed, without needlessly emphasizing to a new porter that one's port submission might fail such a review. >> I'm not convinced that putting a comprehensive list of reasons why a >> committer should reject a new port in the Porter's Handbook is the >> best way of encouraging people to contribute to the ports system. On >> the other hand, I don't see any harm in the PH containing a >> suggestion that being willing to maintain a port one submits is >> appreciated, will contribute to rapid committal, etc. > > Well, I can live with this. OTOH claiming it will lead to more rapid > commital might not actually be supported by the facts :-) but the part > about it being appreciated should certainly go in. OK. Maybe: "In the event that the committer reviewing the port submission encounters a problem, being willing to maintain the port you have submitted will help to resolve such problems more rapidly"...? -- -Chuck