From m.seaman@infracaninophile.co.uk  Sat Aug  6 16:27:39 2011
Return-Path: <m.seaman@infracaninophile.co.uk>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 4FFF61065675
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  6 Aug 2011 16:27:39 +0000 (UTC)
	(envelope-from m.seaman@infracaninophile.co.uk)
Received: from smtp.infracaninophile.co.uk (smtp6.infracaninophile.co.uk [IPv6:2001:8b0:151:1:3fd3:cd67:fafa:3d78])
	by mx1.freebsd.org (Postfix) with ESMTP id D5C478FC12
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  6 Aug 2011 16:27:38 +0000 (UTC)
Received: from lucid-nonsense.infracaninophile.co.uk (localhost [IPv6:::1])
	by smtp.infracaninophile.co.uk (8.14.5/8.14.5) with ESMTP id p76GRU8x005720
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 6 Aug 2011 17:27:30 +0100 (BST)
	(envelope-from matthew@lucid-nonsense.infracaninophile.co.uk)
Received: (from matthew@localhost)
	by lucid-nonsense.infracaninophile.co.uk (8.14.5/8.14.5/Submit) id p76GRUFi005719;
	Sat, 6 Aug 2011 17:27:30 +0100 (BST)
	(envelope-from matthew)
Message-Id: <201108061627.p76GRUFi005719@lucid-nonsense.infracaninophile.co.uk>
Date: Sat, 6 Aug 2011 17:27:30 +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: ports(7) makes no mention of LOCALBASE
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         159551
>Category:       docs
>Synopsis:       [patch] ports(7) makes no mention of LOCALBASE
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 06 16:30:13 UTC 2011
>Closed-Date:    Fri Feb 10 04:13:04 UTC 2012
>Last-Modified:  Fri Feb 10 04:20:10 UTC 2012
>Originator:     Matthew Seaman
>Release:        FreeBSD 8.2-STABLE amd64
>Organization:
Infracaninophile
>Environment:
System: FreeBSD lucid-nonsense.infracaninophile.co.uk 8.2-STABLE FreeBSD 8.2-STABLE #47 r224671: Sat Aug 6 10:59:06 BST 2011 root@lucid-nonsense.infracaninophile.co.uk:/usr/obj/usr/src/sys/LUCID-NONSENSE amd64


	
>Description:

ports(7) makes no mention of LOCALBASE, which is bizarre as it is the
master control for locating where ports will install files and look
for files when resolving dependencies.  ports(7) does mention PREFIX
but doesn't make it clear that the setting only applies to the port
currently being installed.  In fact, the current description of PREFIX
is likely to confuse readers into thinking that PREFIX does what
LOCALBASE does.

Also PREFIX generally inherits its setting from LOCALBASE unless
overridden. (Except for eg. Linux binaries where LINUXBASE is used
instead)

>How-To-Repeat:
	
>Fix:

	

--- ports.7.diff begins here ---
Index: ports.7
===================================================================
--- ports.7	(revision 224671)
+++ ports.7	(working copy)
@@ -408,10 +408,13 @@
 .It Va PKGFILE
 The full path to the package.
 .El
+.It Va LOCALBASE
+Where to install things in general, and where to search for files when
+resolving dependencies (usually
+.Pa /usr/local ) .
 .It Va PREFIX
-Where to install things in general
-(usually
-.Pa /usr/local ) .
+Where to install this port (usually set to the same as
+.Va LOCALBASE ) .
 .It Va MASTER_SITES
 Primary sites for distribution files if not found locally.
 .It Va PATCH_SITES
--- ports.7.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Tue Feb 7 03:35:20 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=159551 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/159551: commit references a PR
Date: Tue,  7 Feb 2012 04:01:12 +0000 (UTC)

 Author: eadler
 Date: Tue Feb  7 04:00:57 2012
 New Revision: 231111
 URL: http://svn.freebsd.org/changeset/base/231111
 
 Log:
   ports(7) currently makes no mention of LOCALBASE: fix that
   
   PR:		docs/159551
   Submitted by:	Matthew Seaman <m.seaman@infracaninophile.co.uk>
   Approved by:	gjb
   MFC after:	3 days
 
 Modified:
   head/share/man/man7/ports.7
 
 Modified: head/share/man/man7/ports.7
 ==============================================================================
 --- head/share/man/man7/ports.7	Tue Feb  7 03:41:08 2012	(r231110)
 +++ head/share/man/man7/ports.7	Tue Feb  7 04:00:57 2012	(r231111)
 @@ -25,7 +25,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd May 30, 2011
 +.Dd Feb 06, 2012
  .Dt PORTS 7
  .Os
  .Sh NAME
 @@ -408,10 +408,13 @@ Directory to put the package in.
  .It Va PKGFILE
  The full path to the package.
  .El
 -.It Va PREFIX
 -Where to install things in general
 -(usually
 +.It Va LOCALBASE
 +Where existing things are installed and where to search for files when
 +resolving dependencies (usually
  .Pa /usr/local ) .
 +.It Va PREFIX
 +Where to install this port (usually set to the same as
 +.Va LOCALBASE ) .
  .It Va MASTER_SITES
  Primary sites for distribution files if not found locally.
  .It Va PATCH_SITES
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->patched 
State-Changed-By: eadler 
State-Changed-When: Tue Feb 7 04:17:43 UTC 2012 
State-Changed-Why:  
committed with slightly different wording 

http://www.freebsd.org/cgi/query-pr.cgi?pr=159551 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/159551: commit references a PR
Date: Fri, 10 Feb 2012 04:08:36 +0000 (UTC)

 Author: eadler
 Date: Fri Feb 10 04:08:22 2012
 New Revision: 231333
 URL: http://svn.freebsd.org/changeset/base/231333
 
 Log:
   MFC r231111, r231331
   
   PR:		159551
   Approved by:	gjb
 
 Modified:
   stable/9/share/man/man7/ports.7
 Directory Properties:
   stable/9/share/   (props changed)
   stable/9/share/man/   (props changed)
   stable/9/share/man/man7/   (props changed)
 
 Modified: stable/9/share/man/man7/ports.7
 ==============================================================================
 --- stable/9/share/man/man7/ports.7	Fri Feb 10 04:01:17 2012	(r231332)
 +++ stable/9/share/man/man7/ports.7	Fri Feb 10 04:08:22 2012	(r231333)
 @@ -25,7 +25,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd May 30, 2011
 +.Dd February 9, 2012
  .Dt PORTS 7
  .Os
  .Sh NAME
 @@ -408,10 +408,13 @@ Directory to put the package in.
  .It Va PKGFILE
  The full path to the package.
  .El
 -.It Va PREFIX
 -Where to install things in general
 -(usually
 +.It Va LOCALBASE
 +Where existing things are installed and where to search for files when
 +resolving dependencies (usually
  .Pa /usr/local ) .
 +.It Va PREFIX
 +Where to install this port (usually set to the same as
 +.Va LOCALBASE ) .
  .It Va MASTER_SITES
  Primary sites for distribution files if not found locally.
  .It Va PATCH_SITES
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: eadler 
State-Changed-When: Fri Feb 10 04:13:02 UTC 2012 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=159551 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/159551: commit references a PR
Date: Fri, 10 Feb 2012 04:10:25 +0000 (UTC)

 Author: eadler
 Date: Fri Feb 10 04:10:13 2012
 New Revision: 231334
 URL: http://svn.freebsd.org/changeset/base/231334
 
 Log:
   MFC r231111, r231331:
   	 ports(7) currently makes no mention of LOCALBASE: fix that
   
   PR:		159551
   Approved by:	gjb
 
 Modified:
   stable/8/share/man/man7/ports.7
 Directory Properties:
   stable/8/share/   (props changed)
   stable/8/share/man/   (props changed)
   stable/8/share/man/man7/   (props changed)
 
 Modified: stable/8/share/man/man7/ports.7
 ==============================================================================
 --- stable/8/share/man/man7/ports.7	Fri Feb 10 04:08:22 2012	(r231333)
 +++ stable/8/share/man/man7/ports.7	Fri Feb 10 04:10:13 2012	(r231334)
 @@ -25,7 +25,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd May 30, 2011
 +.Dd February 9, 2012
  .Dt PORTS 7
  .Os
  .Sh NAME
 @@ -408,10 +408,13 @@ Directory to put the package in.
  .It Va PKGFILE
  The full path to the package.
  .El
 -.It Va PREFIX
 -Where to install things in general
 -(usually
 +.It Va LOCALBASE
 +Where existing things are installed and where to search for files when
 +resolving dependencies (usually
  .Pa /usr/local ) .
 +.It Va PREFIX
 +Where to install this port (usually set to the same as
 +.Va LOCALBASE ) .
  .It Va MASTER_SITES
  Primary sites for distribution files if not found locally.
  .It Va PATCH_SITES
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/159551: commit references a PR
Date: Fri, 10 Feb 2012 04:11:13 +0000 (UTC)

 Author: eadler
 Date: Fri Feb 10 04:11:04 2012
 New Revision: 231335
 URL: http://svn.freebsd.org/changeset/base/231335
 
 Log:
   MFC r231111, r231331:
   	 ports(7) currently makes no mention of LOCALBASE: fix that
   
   PR:		159551
   Approved by:	gjb
 
 Modified:
   stable/7/share/man/man7/ports.7
 Directory Properties:
   stable/7/share/   (props changed)
   stable/7/share/man/   (props changed)
   stable/7/share/man/man7/   (props changed)
 
 Modified: stable/7/share/man/man7/ports.7
 ==============================================================================
 --- stable/7/share/man/man7/ports.7	Fri Feb 10 04:10:13 2012	(r231334)
 +++ stable/7/share/man/man7/ports.7	Fri Feb 10 04:11:04 2012	(r231335)
 @@ -25,7 +25,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd May 30, 2011
 +.Dd February 9, 2012
  .Dt PORTS 7
  .Os
  .Sh NAME
 @@ -408,10 +408,13 @@ Directory to put the package in.
  .It Va PKGFILE
  The full path to the package.
  .El
 -.It Va PREFIX
 -Where to install things in general
 -(usually
 +.It Va LOCALBASE
 +Where existing things are installed and where to search for files when
 +resolving dependencies (usually
  .Pa /usr/local ) .
 +.It Va PREFIX
 +Where to install this port (usually set to the same as
 +.Va LOCALBASE ) .
  .It Va MASTER_SITES
  Primary sites for distribution files if not found locally.
  .It Va PATCH_SITES
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
