From owner-freebsd-doc Sun Dec 10 15: 0: 5 2000 From owner-freebsd-doc@FreeBSD.ORG Sun Dec 10 15:00:02 2000 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 0EE1D37B401 for ; Sun, 10 Dec 2000 15:00:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.1/8.11.1) id eBAN02V47839; Sun, 10 Dec 2000 15:00:02 -0800 (PST) (envelope-from gnats) Resent-Date: Sun, 10 Dec 2000 15:00:02 -0800 (PST) Resent-Message-Id: <200012102300.eBAN02V47839@freefall.freebsd.org> Resent-From: gnats-admin@FreeBSD.org (GNATS Management) Resent-To: freebsd-doc@freebsd.org Resent-Reply-To: gnats-admin@FreeBSD.org, mwm@mired.org Received: from guru.mired.org (okc-65-26-235-186.mmcable.com [65.26.235.186]) by hub.freebsd.org (Postfix) with SMTP id 2AD2237B400 for ; Sun, 10 Dec 2000 14:52:50 -0800 (PST) Received: (qmail 4401 invoked by uid 100); 10 Dec 2000 22:52:48 -0000 Message-Id: <20001210225248.4400.qmail@guru.mired.org> Date: 10 Dec 2000 22:52:48 -0000 From: mwm@mired.org Reply-To: mwm@mired.org To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/23450: The Porter's handbook doesn't say how to test for PREFIX-clean Resent-Sender: gnats@FreeBSD.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 23450 >Category: docs >Synopsis: The Porter's handbook doesn't say how to test for PREFIX-clean >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Dec 10 15:00:01 PST 2000 >Closed-Date: >Last-Modified: >Originator: Mike Meyer >Release: FreeBSD 5.0-CURRENT i386 >Organization: Meyer Consulting >Environment: System: FreeBSD guru.mired.org 5.0-CURRENT FreeBSD 5.0-CURRENT #0: Sun Dec 10 11:48:38 CST 2000 mwm@guru.mired.org:/usr/obj/sharetmp/src/sys/GURU i386 >Description: Ports are showing up that aren't PREFIX-clean, even though the Porters Handbook recommends against that. I suspect that telling people *how* to test a port to see if it's PREFIX clean will help with that. >How-To-Repeat: Try running a system with LOCALBASE set to something other than /usr/local for a year or so, and note how much stuff winds up installed in /usr/local. >Fix: Here are patches to the Porter's Handbook. --- /usr/doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml Sat Nov 25 12:34:48 2000 +++ book.sgml Sun Dec 10 16:49:00 2000 @@ -3277,6 +3277,22 @@ PREFIX, as this variable is automatically passed down to every stage of the build and install processes. + Make sure your application isn't installing things in + /usr/local instead of PREFIX. + A quick test for this is to do this is: + + &prompt.root; make clean; make package PREFIX=/var/tmp/port-name + + If anything is installed outside of PREFIX, + making the package creation process will complain that it + can't find the files. + + This does not test for the existence of internal references, + or correct use of LOCALBASE for references to + files from other ports. Testing the installation in + /var/tmp/port-name + to do that that while you have it installed would do that. + Do not set USE_X_PREFIX unless your port truly requires it (i.e., it links against X libs or it needs to reference files in X11BASE). >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message