From m.seaman@infracaninophile.co.uk  Thu Jul 19 14:43:01 2007
Return-Path: <m.seaman@infracaninophile.co.uk>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id A66D216A400
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 19 Jul 2007 14:43:01 +0000 (UTC)
	(envelope-from m.seaman@infracaninophile.co.uk)
Received: from smtp.infracaninophile.co.uk (ns0.infracaninophile.co.uk [81.187.76.162])
	by mx1.freebsd.org (Postfix) with ESMTP id 0F45F13C428
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 19 Jul 2007 14:43:00 +0000 (UTC)
	(envelope-from m.seaman@infracaninophile.co.uk)
Received: from happy-idiot-talk.infracaninophile.co.uk (localhost.infracaninophile.co.uk [IPv6:::1])
	by smtp.infracaninophile.co.uk (8.14.1/8.14.1) with ESMTP id l6JEgjQY078104
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 19 Jul 2007 15:42:45 +0100 (BST)
	(envelope-from matthew@happy-idiot-talk.infracaninophile.co.uk)
Received: (from matthew@localhost)
	by happy-idiot-talk.infracaninophile.co.uk (8.14.1/8.14.1/Submit) id l6JEgj9O078103;
	Thu, 19 Jul 2007 15:42:45 +0100 (BST)
	(envelope-from matthew)
Message-Id: <200707191442.l6JEgj9O078103@happy-idiot-talk.infracaninophile.co.uk>
Date: Thu, 19 Jul 2007 15:42:45 +0100 (BST)
From: Matthew Seaman <m.seaman@infracaninophile.co.uk>
Reply-To: Matthew Seaman <m.seaman@infracaninophile.co.uk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: no mention of PORT_DBDIR in ports(7)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         114731
>Category:       docs
>Synopsis:       [patch] no mention of PORT_DBDIR in ports(7)
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    gabor
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 19 14:50:07 GMT 2007
>Closed-Date:    Fri Jan 04 13:44:27 UTC 2008
>Last-Modified:  Fri Jan 04 13:44:27 UTC 2008
>Originator:     Matthew Seaman
>Release:        FreeBSD 6.2-STABLE i386
>Organization:
Infracaninophile
>Environment:
System: FreeBSD happy-idiot-talk.infracaninophile.co.uk 6.2-STABLE FreeBSD 6.2-STABLE #5: Sat Jul 14 01:44:09 BST 2007 root@happy-idiot-talk.infracaninophile.co.uk:/usr/obj/usr/src/sys/HAPPY-IDIOT-TALK i386


	
>Description:

The ports(7) man page contains no mention of either the PORT_DBDIR
variable or its usual default location '/var/db/ports'


>How-To-Repeat:
	
>Fix:

	

--- ports.7.diff begins here ---
--- share/man/man7/ports.7.orig	Thu Jul 19 15:15:31 2007
+++ share/man/man7/ports.7	Thu Jul 19 15:33:32 2007
@@ -462,6 +462,17 @@
 what you are doing and are sure about installing a forbidden port, then
 .Va NO_IGNORE
 lets you do it.
+.It Va PORT_DBDIR
+Directory where the results of configuring
+.Va OPTIONS
+are stored.
+Defaults to
+.Pa /var/db/ports .
+Each port where
+.Va OPTIONS
+have been configured will have a uniquely named sub-directory, containing a
+single file
+.Pa options .
 .El
 .Sh FILES
 .Bl -tag -width ".Pa /usr/ports/Mk/bsd.port.mk" -compact
--- ports.7.diff ends here ---


>Release-Note:
>Audit-Trail:

From: Gabor Kovesdan <gabor@FreeBSD.org>
To: bug-followup@FreeBSD.org,  m.seaman@infracaninophile.co.uk
Cc:  
Subject: Re: docs/114731: [patch] no mention of PORT_DBDIR in ports(7)
Date: Wed, 22 Aug 2007 16:54:47 +0200

 And what about PKG_DBDIR? And LOCALBASE, LINUXBASE? All of those can be 
 changed and there are a lot of other variables for fine-tuning. The 
 question is that should we collect and document all of those or draw a 
 line somewhere? If so, where?
 
 -- 
 Gabor Kovesdan
 FreeBSD Volunteer
 
 EMAIL: gabor@FreeBSD.org .:|:. gabor@kovesdan.org
 WEB:   http://people.FreeBSD.org/~gabor .:|:. http://kovesdan.org
 

From: Matthew Seaman <m.seaman@infracaninophile.co.uk>
To: Gabor Kovesdan <gabor@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/114731: [patch] no mention of PORT_DBDIR in ports(7)
Date: Wed, 22 Aug 2007 16:58:31 +0100

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA256
 
 Gabor Kovesdan wrote:
 > And what about PKG_DBDIR? And LOCALBASE, LINUXBASE? All of those can be
 > changed and there are a lot of other variables for fine-tuning. The
 > question is that should we collect and document all of those or draw a
 > line somewhere? If so, where?
 
 Well, yes.  Ideally all of the variables that a user can set to
 affect the behaviour of the common shared Makefiles in /usr/ports/Mk
 will be documented somewhere.  Of the ones you mention, PKG_DBDIR is
 described in pkg_info(1).  LOCALBASE and LINUXBASE are covered in
 The Porter's Handbook.  However, I couldn't find anywhere where
 PORT_DBDIR was described other than the contents of /usr/ports/Mk,
 and it seems to me the natural place to document it is in ports(7).
 
 	Cheers,
 
 	Matthew
 
 - --
 Dr Matthew J Seaman MA, D.Phil.                   7 Priory Courtyard
                                                   Flat 3
 PGP: http://www.infracaninophile.co.uk/pgpkey     Ramsgate
                                                   Kent, CT11 9PW
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2.0.4 (FreeBSD)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
 
 iD8DBQFGzF0n8Mjk52CukIwRCDKRAJ49DBHBOiX6lGCxo+2zumXeP+VYGgCfchIU
 i3rJcUyWrRfmrf8GUa/e70M=
 =1dVe
 -----END PGP SIGNATURE-----

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/114731: commit references a PR
Date: Fri, 21 Dec 2007 21:44:38 +0000 (UTC)

 gabor       2007-12-21 21:44:33 UTC
 
   FreeBSD src repository (doc,ports committer)
 
   Modified files:
     share/man/man7       ports.7 
   Log:
   - Document PORT_DBDIR
   
   PR:             docs/114731
   Submitted by:   Matthew Seaman <m.seaman@infracaninophile.co.uk>
   
   Revision  Changes    Path
   1.63      +11 -0     src/share/man/man7/ports.7
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->patched 
State-Changed-By: gabor 
State-Changed-When: Fri Dec 21 21:58:26 UTC 2007 
State-Changed-Why:  
Patched in HEAD, MFC reminder. 


Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Fri Dec 21 21:58:26 UTC 2007 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=114731 
State-Changed-From-To: patched->closed 
State-Changed-By: gabor 
State-Changed-When: Fri Jan 4 13:44:11 UTC 2008 
State-Changed-Why:  
Committed, thanks! 

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