From nobody@FreeBSD.org  Wed Feb  1 17:51:06 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 78DA116A422
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <reinhold.matthias@web.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: misleading chapter in handbook
X-Send-Pr-Version: www-2.3

>Number:         92699
>Category:       docs
>Synopsis:       misleading chapter in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Feb 01 18:00:19 GMT 2006
>Closed-Date:    Wed Mar 01 20:37:44 GMT 2006
>Last-Modified:  Wed Mar 01 20:37:44 GMT 2006
>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

 >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.
>How-To-Repeat:
              
>Fix:
              
>Release-Note:
>Audit-Trail:

From: "Remko Lodder" <remko@FreeBSD.org>
To: "Matthias Reinhold" <reinhold.matthias@web.de>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/92699: misleading chapter in handbook
Date: Thu, 2 Feb 2006 07:58:44 +0100 (CET)

 On Wed, February 1, 2006 18:51, Matthias Reinhold wrote:
 >
 >  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.
 
 Hi Matthias,
 
 You seem to be German, please feel free to submit patches for the
 translated content so that it can be incorporated. I am sure the
 German translation team would not mind if you did so.
 
 Thanks in advance,
 Remko
 
 -- 
 Kind regards,
 
    Remko Lodder  ** remko@elvandar.org
         FreeBSD  ** remko@FreeBSD.org
 
 
 
 
State-Changed-From-To: open->closed 
State-Changed-By: pav 
State-Changed-When: Wed Mar 1 20:37:12 UTC 2006 
State-Changed-Why:  
You're right this is a little hairy. I changed all PORTSDIRs to much more 
useful WRKDIRPREFIXes... 

http://www.freebsd.org/cgi/query-pr.cgi?pr=92699 
>Unformatted:
