From Dom.Mitchell@palmerharvey.co.uk Fri Mar 12 03:47:30 1999
Return-Path: <Dom.Mitchell@palmerharvey.co.uk>
Received: from mail.palmerharvey.co.uk (mail.palmerharvey.co.uk [62.172.109.58])
	by hub.freebsd.org (Postfix) with ESMTP id AA3E814FD5
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 12 Mar 1999 03:47:27 -0800 (PST)
	(envelope-from Dom.Mitchell@palmerharvey.co.uk)
Received: from ho-nt-01.pandhm.co.uk (unverified) by mail.palmerharvey.co.uk
 (Content Technologies SMTPRS 2.0.15) with ESMTP id <B0000016898@mail.palmerharvey.co.uk> for <FreeBSD-gnats-submit@freebsd.org>;
 Fri, 12 Mar 1999 11:47:23 +0000
Received: from voodoo.pandhm.co.uk ([10.100.35.12]) by ho-nt-01.pandhm.co.uk with SMTP (Microsoft Exchange Internet Mail Service Version 5.5.2448.0)
	id FSG3LG65; Fri, 12 Mar 1999 11:40:53 -0000
Received: from dom by voodoo.pandhm.co.uk with local (Exim 2.10 #1)
	id 10LQRg-0006ho-00
	for FreeBSD-gnats-submit@freebsd.org; Fri, 12 Mar 1999 11:49:40 +0000
Message-Id: <E10LQRg-0006ho-00@voodoo.pandhm.co.uk>
Date: Fri, 12 Mar 1999 11:49:40 +0000
From: Dom Mitchell <Dom.Mitchell@palmerharvey.co.uk>
Reply-To: Dom.Mitchell@palmerharvey.co.uk
To: FreeBSD-gnats-submit@freebsd.org
Subject: make(1) man page update
X-Send-Pr-Version: 3.2

>Number:         10556
>Category:       bin
>Synopsis:       make(1) man page update
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    chris
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 12 03:50:01 PST 1999
>Closed-Date:    Wed Aug 11 10:53:04 PDT 1999
>Last-Modified:  Wed Aug 11 10:54:31 PDT 1999
>Originator:     Dominic Mitchell
>Release:        FreeBSD 4.0-CURRENT i386
>Organization:
Palmer & Harvey McLane Ltd.
>Environment:

FreeBSD voodoo.pandhm.co.uk 4.0-CURRENT FreeBSD 4.0-CURRENT #17: Mon Mar  8 06:07:16 GMT 1999     root@voodoo.pandhm.co.uk:/usr/src/sys/compile/VOODOO  i386

>Description:

Make(1) doesn't document the fact that it it knows about VPATH.  It
should do, for the benefit of people trying to port Makefiles from other
systems.

>How-To-Repeat:

man make | grep VPATH

>Fix:
	
Here's my change; please feel free to change it to read better.

--- /usr/src/usr.bin/make/make.1	Sun Nov 29 13:46:39 1998
+++ make.1	Fri Mar 12 11:47:07 1999
@@ -940,6 +940,11 @@
 Each source specifies a suffix to
 .Nm make .
 If no sources are specified, any previous specified suffices are deleted.
+.It Ic VPATH
+This is a synonym for 
+.Ic .PATH .
+It is maintained for backwards
+compatibility and should not be used in new makefiles.
 .Sh SEARCH PATH
 .Nm Make
 searches for

-- 
**********************************************************************
This email and any files transmitted with it are confidential and 
intended solely for the use of the individual or entity to whom they   
are addressed. If you have received this email in error please notify 
the system manager.

This footnote also confirms that this email message has been swept by 
MIMEsweeper for the presence of computer viruses.
**********************************************************************

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->chris 
Responsible-Changed-By: chris 
Responsible-Changed-When: Mon Aug 9 10:04:16 PDT 1999 
Responsible-Changed-Why:  
I'll take care of this, and make a more detailed description for the man page. 
State-Changed-From-To: open->feedback 
State-Changed-By: chris 
State-Changed-When: Mon Aug 9 18:23:11 PDT 1999 
State-Changed-Why:  
Waiting for opinions from freebsd-bugs -- unsure as to whether it should be 
documented at all. 

From: Chris Costello <chris@calldei.com>
To: chris@FreeBSD.ORG
Cc: freebsd-bugs@FreeBSD.ORG, freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: bin/10556: make(1) man page update
Date: Mon, 09 Aug 1999 20:25:44 -0500

 On Mon, Aug 09, 1999, chris@FreeBSD.ORG wrote:
 > Synopsis: make(1) man page update
 > 
 > Responsible-Changed-From-To: freebsd-bugs->chris
 > Responsible-Changed-By: chris
 > Responsible-Changed-When: Mon Aug 9 10:04:16 PDT 1999
 > Responsible-Changed-Why: 
 > I'll take care of this, and make a more detailed description for the man page.
 
    Alright, I've looked over it and I am not sure that it should
 be documented.
 
    The reason I don't think it should be documented is to
 discourage its use, as it only exists for backward compatibility.
 
    Opinions?
 
 -- 
 |Chris Costello <chris@calldei.com>
 |If it was easy, the hardware people would take care of it.
 `----------------------------------------------------------
 
State-Changed-From-To: feedback->closed 
State-Changed-By: chris 
State-Changed-When: Wed Aug 11 10:53:04 PDT 1999 
State-Changed-Why:  
Committed a change to make.1 to document and discourage use of ${VPATH} in 
new Makefiles. 
>Unformatted:
