From owner-freebsd-doc@FreeBSD.ORG  Wed Sep 21 22:30:10 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: doc@freebsd.org
Delivered-To: freebsd-doc@FreeBSD.ORG
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9F28B16A41F
	for <doc@freebsd.org>; Wed, 21 Sep 2005 22:30:10 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id DA95F43D48
	for <doc@freebsd.org>; Wed, 21 Sep 2005 22:30:09 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
	(SMTPD32-8.05) id AEE8799E00D0; Wed, 21 Sep 2005 15:30:00 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j8LMW2qF078173;
	Wed, 21 Sep 2005 15:32:02 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j8LMVrE9078172;
	Wed, 21 Sep 2005 15:31:53 -0700 (PDT)
	(envelope-from garys@opusnet.com)
To: Josh Paetzel <josh@tcbug.org>
References: <200509211504.46861.josh@tcbug.org>
From: garys@opusnet.com (Gary W. Swearingen)
Date: Wed, 21 Sep 2005 15:31:53 -0700
In-Reply-To: <200509211504.46861.josh@tcbug.org> (Josh Paetzel's message of
	"Wed, 21 Sep 2005 15:04:46 -0500")
Message-ID: <i6aci6833a.ci6@mail.opusnet.com>
User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.4.17 (Jumbo Shrimp,
	berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Cc: doc@freebsd.org
Subject: Re: Proposed addition to the handbook
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 21 Sep 2005 22:30:10 -0000

Josh Paetzel <josh@tcbug.org> writes:

> If is determined to be a 'worthy-cost' I can do up a proposal 
> explaining how to determine and use  make arguements to a port. 

Sounds helpful, though I think it would be good to keep it in some
kind of "advanced" section or even an article.  The ports/pkgs section
is already heavy reading.

I'd hope it would at least mention pkgtools.conf(5) so users know the
special arguments don't HAVE to be typed in for every use.  The
handbook doesn't mention it now.

And maybe say something about those curses menus that "pop up" and
halt your port installs (if you don't use sufficient make variables?).