From nobody@FreeBSD.org  Sat Feb 18 08:21:52 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id E0C8116A420
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 18 Feb 2006 08:21:52 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9C96F43D53
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 18 Feb 2006 08:21:52 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k1I8LoBV019573
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 18 Feb 2006 08:21:50 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id k1I8Lo8f019572;
	Sat, 18 Feb 2006 08:21:50 GMT
	(envelope-from nobody)
Message-Id: <200602180821.k1I8Lo8f019572@www.freebsd.org>
Date: Sat, 18 Feb 2006 08:21:50 GMT
From: Sideris Michael <msid@daemons.gr>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Presented usage of Ports in Handbook lacks several important things.
X-Send-Pr-Version: www-2.3

>Number:         93517
>Category:       docs
>Synopsis:       Presented usage of Ports in Handbook lacks several important things.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 18 08:30:09 GMT 2006
>Closed-Date:    Fri Oct 13 09:42:07 GMT 2006
>Last-Modified:  Fri Oct 13 09:42:07 GMT 2006
>Originator:     Sideris Michael
>Release:        
>Organization:
>Environment:
>Description:
Correct me if I am wrong, but i really tried to search around if there is such a thing or methodology posted somewhere and is linked as an official resource of explaining what I am going to mention below.

I have been using FreeBSD for more than a year. I have read couple of books, a number of Internet resources, I participated in forums as well as thoroughly reading the FreeBSD handbook. A few months ago though I learned the efficient way of working with Ports. Now, what is the problem here.

In the Handbook is stated clearly how to install a port and how to uninstall it and how you can use portupgrade to execute a massive upgrade on the currently installed ports as well as some other stuff. What is really missing from there is the fact that all the WITH knobs someone can find in Makefile can be used in /etc/make.conf as a global configuration. Also, since you mention portupgrade as a tool, which is part of pkgtools, you can mention that, will someone need to customize a port despite the global configuration he or she can use the pkgtools.conf file that comes when you install portupgrade and hence pkgtools. As far as I know, this way, WITH knobs are read both when you issue make install clean or using portupgrade/portinstall.

To conclude, I would like to mention that it would be nice to have a tool, that would read the dependencies of the port you want to install and will print on the screen the available WITH knobs for each dependency separately so that the user can use them in /etc/make.conf to customize his or her environment.
>How-To-Repeat:
              
>Fix:
              
>Release-Note:
>Audit-Trail:

From: Sam Lawrance <lawrance@FreeBSD.org>
To: Sideris Michael <msid@daemons.gr>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: ports/93517: Presented usage of Ports in Handbook lacks several important things.
Date: Sat, 18 Feb 2006 20:15:20 +1100

 On 18/02/2006, at 8:21 AM, Sideris Michael wrote:
 >
 > Correct me if I am wrong, but i really tried to search around if  
 > there is such a thing or methodology posted somewhere and is linked  
 > as an official resource of explaining what I am going to mention  
 > below.
 >
 > I have been using FreeBSD for more than a year. I have read couple  
 > of books, a number of Internet resources, I participated in forums  
 > as well as thoroughly reading the FreeBSD handbook. A few months  
 > ago though I learned the efficient way of working with Ports. Now,  
 > what is the problem here.
 >
 > In the Handbook is stated clearly how to install a port and how to  
 > uninstall it and how you can use portupgrade to execute a massive  
 > upgrade on the currently installed ports as well as some other  
 > stuff. What is really missing from there is the fact that all the  
 > WITH knobs someone can find in Makefile can be used in /etc/ 
 > make.conf as a global configuration.
 
 It's a feature of make, rather than the ports collection - see make 
 (1) and make.conf(5).  It would still be good to have it documented;  
 can you please send a patch?
 
 Some ports use the OPTIONS framework.  This avoids the need for  
 putting WITH_* in make.conf, because those ports "remember" the  
 settings given to them.
 
 > Also, since you mention portupgrade as a tool, which is part of  
 > pkgtools, you can mention that, will someone need to customize a  
 > port despite the global configuration he or she can use the  
 > pkgtools.conf file that comes when you install portupgrade and  
 > hence pkgtools. As far as I know, this way, WITH knobs are read  
 > both when you issue make install clean or using portupgrade/ 
 > portinstall.
 
 Patch? ;-)
 
 > To conclude, I would like to mention that it would be nice to have  
 > a tool, that would read the dependencies of the port you want to  
 > install and will print on the screen the available WITH knobs for  
 > each dependency separately so that the user can use them in /etc/ 
 > make.conf to customize his or her environment.
 
 Yes, it would.  Once I saw some scripts floating around that grepped  
 out the WITH_ knobs from a port.  If you can find it, perhaps you can  
 extended it to work recursively.  Again note that it's not useful for  
 ports using OPTIONS since make config-recursive will do the trick.
 
 
State-Changed-From-To: open->feedback 
State-Changed-By: lawrance 
State-Changed-When: Sat Feb 18 12:46:28 UTC 2006 
State-Changed-Why:  
Waiting for patches (submitter will work on it). 


Responsible-Changed-From-To: freebsd-ports-bugs->freebsd-doc 
Responsible-Changed-By: lawrance 
Responsible-Changed-When: Sat Feb 18 12:46:28 UTC 2006 
Responsible-Changed-Why:  
It's a doc thing. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=93517 
State-Changed-From-To: feedback->closed 
State-Changed-By: remko 
State-Changed-When: Fri Oct 13 09:41:36 UTC 2006 
State-Changed-Why:  
Feedback timeout. 

IF the patches are there, please send them to us so that we can 
have a look at them, we would gladly look into it and commit it 
with your help. 

Thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=93517 
>Unformatted:
