From owner-freebsd-ports@FreeBSD.ORG  Tue Sep 13 13:47:28 2005
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
X-Original-To: ports@FreeBSD.org
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 1055B16A41F;
	Tue, 13 Sep 2005 13:47:28 +0000 (GMT)
	(envelope-from linimon@lonesome.com)
Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9817743D45;
	Tue, 13 Sep 2005 13:47:27 +0000 (GMT)
	(envelope-from linimon@lonesome.com)
Received: by mail.soaustin.net (Postfix, from userid 502)
	id 95CA42DAC; Tue, 13 Sep 2005 08:47:26 -0500 (CDT)
Date: Tue, 13 Sep 2005 08:47:26 -0500
To: Pav Lucistnik <pav@FreeBSD.org>
Message-ID: <20050913134726.GA31529@soaustin.net>
References: <200509102222.j8AMMubj032724@bright.research.att.com>
	<4326A53C.5020808@FreeBSD.org>
	<1126609121.54365.17.camel@pav.hide.vol.cz>
	<4326B439.4090308@FreeBSD.org>
	<1126610216.54365.20.camel@pav.hide.vol.cz>
	<4326B5CF.1070606@FreeBSD.org>
	<1126610573.54365.23.camel@pav.hide.vol.cz>
	<20050913122601.GG563@isis.sigpipe.cz>
	<1126614807.54365.28.camel@pav.hide.vol.cz>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1126614807.54365.28.camel@pav.hide.vol.cz>
User-Agent: Mutt/1.5.9i
From: linimon@lonesome.com (Mark Linimon)
Cc: ports@FreeBSD.org, Roman Neuhauser <neuhauser@sigpipe.cz>,
	Sergey Matveychuk <sem@FreeBSD.org>
Subject: Re: Unifying WWW: pkg-descr lines for cpan ports
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 13 Sep 2005 13:47:28 -0000

On Tue, Sep 13, 2005 at 02:33:27PM +0200, Pav Lucistnik wrote:
> We can debate if the structuring of PH into Quick Porting and Slow
> Porting, duplicating much of the data of first in the second, is a good
> design.

I've always thought it might even be better as two documents -- one a
Guide and one remain the Handbook.  At the very least the titles need
to be changed to something like "Overview" and "Reference".

The _information_ in the latter section, whatever we call it and
wherever it goes, needs to be a complete superset of the former.

mcl