From owner-freebsd-doc@FreeBSD.ORG  Wed Sep 21 20:03:53 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 8159016A41F
	for <doc@freebsd.org>; Wed, 21 Sep 2005 20:03:53 +0000 (GMT)
	(envelope-from josh@tcbug.org)
Received: from sccrmhc11.comcast.net (sccrmhc11.comcast.net [63.240.76.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 2B4EC43D49
	for <doc@freebsd.org>; Wed, 21 Sep 2005 20:03:52 +0000 (GMT)
	(envelope-from josh@tcbug.org)
Received: from [192.168.1.102]
	(c-24-118-173-219.hsd1.mn.comcast.net[24.118.173.219])
	by comcast.net (sccrmhc11) with ESMTP
	id <2005092120035201100ph04le>; Wed, 21 Sep 2005 20:03:52 +0000
From: Josh Paetzel <josh@tcbug.org>
To: doc@freebsd.org
Date: Wed, 21 Sep 2005 15:04:46 -0500
User-Agent: KMail/1.8.1
MIME-Version: 1.0
Content-Type: text/plain;
  charset="us-ascii"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200509211504.46861.josh@tcbug.org>
Cc: 
Subject: 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 20:03:53 -0000

4.5 Using the Ports Collection

The following sections provide basic instructions on using the Ports 
Collection to install or remove programs from your system.

I haven't been able to find any documentation in the handbook that 
tells how to use the various knobs in a port's Makefile.  I suspect 
that there is a fairly large subset of FreeBSD users that don't know 
you can do cd /usr/ports/irc/epic5 && make WITH_SOCKS=yes install

Another question would be if this would go beyond the 'basic 
instructions' statement at the top of the page.


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. 

-- 
Thanks,

Josh Paetzel