Bug 159551

Summary: [patch] ports(7) makes no mention of LOCALBASE
Product: Documentation Reporter: Matthew Seaman <m.seaman>
Component: Books & ArticlesAssignee: Eitan Adler <eadler>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
ports.7.diff none

Description Matthew Seaman 2011-08-06 17:30:13 UTC
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)
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2012-02-07 03:35:20 UTC
Responsible Changed
From-To: freebsd-doc->eadler

I'll take it.
Comment 2 dfilter service freebsd_committer freebsd_triage 2012-02-07 04:01:12 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 r7
 .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"
Comment 3 Eitan Adler freebsd_committer freebsd_triage 2012-02-07 04:17:43 UTC
State Changed
From-To: open->patched

committed with slightly different wording
Comment 4 dfilter service freebsd_committer freebsd_triage 2012-02-10 04:08:36 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 r7
 .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"
Comment 5 dfilter service freebsd_committer freebsd_triage 2012-02-10 04:10:25 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 r7
 .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"
Comment 6 dfilter service freebsd_committer freebsd_triage 2012-02-10 04:11:13 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 r7
 .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"
Comment 7 Eitan Adler freebsd_committer freebsd_triage 2012-02-10 04:13:02 UTC
State Changed
From-To: patched->closed

Committed. Thanks!