Bug 27843

Summary: [PATCH] make.conf WITH_* variables aren't documented.
Product: Documentation Reporter: mwm
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description mwm 2001-06-03 03:00:01 UTC 
The various WITH_* and WITHOUT_* variables in the ports make system
aren't documented.

Fix: Here's a patch for the make.conf man page to add documentation for all
of those variables.
How-To-Repeat: 
Read the make.conf man page, and notice they aren't there.
Comment 1 ru freebsd_committer freebsd_triage 2001-06-04 11:38:30 UTC 
These should probably go into the ports(7) manpage.

On Sun, Jun 03, 2001 at 01:53:04AM -0000, mwm@mired.org wrote:
> 
> The various WITH_* and WITHOUT_* variables in the ports make system
> aren't documented.
[...]



Cheers,
-- 
Ruslan Ermilov		Oracle Developer/DBA,
ru@sunbay.com		Sunbay Software AG,
ru@FreeBSD.org		FreeBSD committer,
+380.652.512.251	Simferopol, Ukraine

http://www.FreeBSD.org	The Power To Serve
http://www.oracle.com	Enabling The Information Age
Comment 2 mwm 2001-06-04 12:51:58 UTC 
> On Sun, Jun 03, 2001 at 01:53:04AM -0000, mwm@mired.org wrote:
> Ruslan Ermilov <ru@FreeBSD.ORG> types:
> > The various WITH_* and WITHOUT_* variables in the ports make system
> > aren't documented.
> These should probably go into the ports(7) manpage.

Possibly true. On the other hand, there's a lot of things in the
make.conf man page that should go there as well, and a lot of
duplication between the two.

Someone should decide which of the two pages they belong in (*), merge
them into one place with an appropriate replacement in the other, and
add a reference to make.conf(7) to ports(7). I'm willing to do the
work; I just want to make sure it goes in the right place before
starting.

	<mike

*) I'd vote for putting them in make.conf(7), as doing so would help fix
one of the bugs on the ports(7) man page: "This man page is too long."
--
Mike Meyer <mwm@mired.org>			http://www.mired.org/home/mwm/
Independent WWW/Perforce/FreeBSD/Unix consultant, email for more information.
Comment 3 dd freebsd_committer freebsd_triage 2001-09-04 10:54:46 UTC 
State Changed
From-To: open->suspended

Documentation for ports options are in a state of flux in -current, 
since Alex removed all of the from make.conf(5), but, AFAIK, hasn't 
readded them anywhere yet.  Until such time as we figure out where 
they should go, this PR should be suspended.
Comment 4 dd freebsd_committer freebsd_triage 2001-09-04 10:54:46 UTC 
Responsible Changed
From-To: freebsd-doc->alex

Alex removed things like this from make.conf(5), so perhaps he can figure 
out where this should go, and merge stuff from this PR when the time comes
Comment 5 Mark Linimon freebsd_committer freebsd_triage 2004-09-09 19:44:22 UTC 
Responsible Changed
From-To: alex->freebsd-doc

alex has given up his commit bit, so reset Responsible to the mailing list.
Comment 6 Mark Linimon freebsd_committer freebsd_triage 2005-12-23 21:14:19 UTC 
State Changed
From-To: suspended->closed

Since this PR came in long ago, a framework to centrally document all the 
ports knobs has been committed as ports/KNOBS.  But thanks for the submission.