From owner-freebsd-ports@FreeBSD.ORG Fri Jan 11 18:23:31 2008 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A453416A41B for ; Fri, 11 Jan 2008 18:23:31 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from mail.soaustin.net (lefty.soaustin.net [66.135.55.46]) by mx1.freebsd.org (Postfix) with ESMTP id 81FAE13C4E1 for ; Fri, 11 Jan 2008 18:23:31 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 25DCD8C131; Fri, 11 Jan 2008 12:23:31 -0600 (CST) Date: Fri, 11 Jan 2008 12:23:31 -0600 To: Paul Schmehl Message-ID: <20080111182331.GB1823@soaustin.net> References: <790a9fff0801110834s532a7282lf63061ad2b73acf5@mail.gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.13 (2006-08-11) From: linimon@lonesome.com (Mark Linimon) Cc: FreeBSD Ports Subject: Re: Suggested improvements for ports X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Jan 2008 18:23:31 -0000 On Fri, Jan 11, 2008 at 11:10:45AM -0600, Paul Schmehl wrote: > The porters handbook seems written from the standpoint of a guide more > than a manual. That's something that I was going to work on, um, last year :-) We need both. Right now we have this hybrid which isn't a completely satisfactory solution for either one. This is historical; it kind of grew out of an initial short how-to document, then, as new things were stuffed into the ports infrastructure, there was no better place to document them. The "quick porting" text should turn into a "guide"; the "slow porting" text should become the reference. Of course, I say this, without the cycles to work on it. mcl