From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 23:06:12 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 21B91106564A for ; Mon, 2 Jan 2012 23:06:12 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id D4D4E8FC27 for ; Mon, 2 Jan 2012 23:06:11 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q02N6BvP004681 for ; Mon, 2 Jan 2012 16:06:11 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q02N6BwY004678 for ; Mon, 2 Jan 2012 16:06:11 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Mon, 2 Jan 2012 16:06:11 -0700 (MST) From: Warren Block To: doc@freebsd.org Message-ID: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Mon, 02 Jan 2012 16:06:11 -0700 (MST) Cc: Subject: Deciphering a Porter's Handbook paragraph X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2012 23:06:12 -0000 http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/book.html#PORTING-PREFIX ------ # make clean; make package PREFIX=/var/tmp/`make -V PORTNAME` If anything is installed outside of PREFIX, the package creation process will complain that it cannot find the files. ------ Okay so far. ------ This does not test for the existence of internal references, or correct use of LOCALBASE for references to files from other ports. ------ I want to rewrite that to be more specific about what "this" refers to: This simple test does not check for incorrect internal references or the correct use of LOCALBASE for references to files from other ports. That seems a bit better. Now for the good one: ------ Testing the installation in /var/tmp/`make -V PORTNAME` to do that while you have it installed would do that. ------ What? Testing the installation... how? Does "installation" mean already-installed files, or does it mean the user is supposed to do an installation? What does "that" in "to do that" refer to? What does the last "that" refer to? I think it may mean: To test for those problems, run the program from the temporary installation in /var/tmp/`make -V PORTNAME` and verify that it operates correctly. The complete rewritten paragraph: This simple test does not check for incorrect internal references or the correct use of LOCALBASE for references to files from other ports. To test for those problems, run the program from the temporary installation in /var/tmp/`make -V PORTNAME` and verify that it operates correctly. Please, someone help me encromulate this.