Bug 159551 - [patch] ports(7) makes no mention of LOCALBASE
Summary: [patch] ports(7) makes no mention of LOCALBASE
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: Eitan Adler
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-08-06 17:30 UTC by Matthew Seaman
Modified: 2012-02-10 04:20 UTC (History)
0 users

See Also:

Attachments
ports.7.diff (613 bytes, patch)
2011-08-06 17:30 UTC, Matthew Seaman 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
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!