From owner-freebsd-doc@FreeBSD.ORG Sat Aug 6 16:30:14 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DFD84106566B for ; Sat, 6 Aug 2011 16:30:13 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B96398FC17 for ; Sat, 6 Aug 2011 16:30:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p76GUDhS037231 for ; Sat, 6 Aug 2011 16:30:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p76GUDmY037225; Sat, 6 Aug 2011 16:30:13 GMT (envelope-from gnats) Resent-Date: Sat, 6 Aug 2011 16:30:13 GMT Resent-Message-Id: <201108061630.p76GUDmY037225@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Matthew Seaman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4FFF61065675 for ; 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 ; 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 ; 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/159551: ports(7) makes no mention of LOCALBASE X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Matthew Seaman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 06 Aug 2011 16:30:14 -0000 >Number: 159551 >Category: docs >Synopsis: ports(7) makes no mention of LOCALBASE >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Aug 06 16:30:13 UTC 2011 >Closed-Date: >Last-Modified: >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: >Unformatted: