From owner-freebsd-doc@FreeBSD.ORG Wed Feb 1 18:00:21 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B2D4316A422 for ; Wed, 1 Feb 2006 18:00:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 153A143D5C for ; Wed, 1 Feb 2006 18:00:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k11I0JJD002482 for ; Wed, 1 Feb 2006 18:00:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k11I0Juh002481; Wed, 1 Feb 2006 18:00:19 GMT (envelope-from gnats) Resent-Date: Wed, 1 Feb 2006 18:00:19 GMT Resent-Message-Id: <200602011800.k11I0Juh002481@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, Matthias Reinhold Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 78DA116A422 for ; Wed, 1 Feb 2006 17:51:06 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 483B643D46 for ; Wed, 1 Feb 2006 17:51:06 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k11Hp6dM073271 for ; Wed, 1 Feb 2006 17:51:06 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id k11Hp6OA073265; Wed, 1 Feb 2006 17:51:06 GMT (envelope-from nobody) Message-Id: <200602011751.k11Hp6OA073265@www.freebsd.org> Date: Wed, 1 Feb 2006 17:51:06 GMT From: Matthias Reinhold To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Cc: Subject: docs/92699: misleading chapter in handbook 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: Wed, 01 Feb 2006 18:00:22 -0000 >Number: 92699 >Category: docs >Synopsis: misleading chapter in handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Feb 01 18:00:19 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Matthias Reinhold >Release: freebsd 7-current >Organization: >Environment: % uname -a FreeBSD lodoss.reinhold.local 7.0-CURRENT FreeBSD 7.0-CURRENT #1: Tue Jan 10 18:06:23 CET 2006 root@lodoss.reinhold.local:/usr/obj/usr/src/sys/LODOSS i386 >Description: Hi The chapter "4.5.2.1 Overriding the Default Ports Directories" in FreeBSD's handbook is not really wrong but yet pretty inaccurate and misleading. It says >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: >For example: > ># make PORTSDIR=/usr/home/example/ports install > >will compile the port in /usr/home/example/ports and install everything under /usr/local This sounds like if you are in a portsdir, maybe /usr/ports/shells/bash, this command would build this port in /usr/home/examples/ports and install it to /usr/local afterwards. Of course it does not do so. As i understand it PORTSDIR just tells make whic h installed portstree to use - in case there's more than one - or just where the portstree is located if you want to build a port from somewhere else (e.g. a testrun of a self-created port or sth like that). To clarify the issue I'd suggest to at least mention WRKDIRPREFIX in this chapter so that the reader doesn't mix the knobs up. But it would be nice if the point about PORTSDIR gets an accurate explanation. Greetings, Matthias PS: The german version of this chapter is even a bad translation. In german it doesn't just _sound like_ PORTSDIR is the directory where the port is build. In german it explicitly says it is! So this translation really has to get fixed.