Move ${VPATH} explanation under the .PATH rule section.

Clarify my vague explanation of how ${VPATH} works and why it shouldn't
be used.
This commit is contained in:
Chris Costello 1999-08-12 20:28:54 +00:00
parent 00d3c51669
commit a5813d5e80

View File

@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)make.1 8.4 (Berkeley) 3/19/94
.\" $Id: make.1,v 1.18 1999/07/31 20:53:01 hoek Exp $
.\" $Id: make.1,v 1.19 1999/08/11 17:52:55 chris Exp $
.\"
.Dd March 19, 1994
.Dt MAKE 1
@ -459,21 +459,6 @@ is set to the value of
for all programs which
.Nm make
executes.
.It Ev VPATH
Directories in addition to
.Ql Ev PATH
through which
.Nm make
will search in order to find programs specified in the Makefile.
.Pp
.Ev VPATH
exists
solely
for backward compatibility.
It is
.Em strongly recommended
that you do not use this variable in your Makefiles.
.Ef
.El
.Pp
Variable expansion may be modified to select or modify each word of the
@ -938,6 +923,18 @@ The sources are directories which are to be searched for files not
found in the current directory.
If no sources are specified, any previously specified directories are
deleted.
.Pp
Additionally, the variable
.Ql Ev VPATH
can be used to specify additional directories for the search path, separated
by a
.Dq \:
character.
.Pp
However, it is
.Em strongly recommended
that you do not use this in any new Makefiles, as it exists only for backward
compatibility.
.It Ic .PHONY
Apply the
.Ic .PHONY