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

Clarify my vague explanation of how ${VPATH} works and why it shouldn't
be used.

1 files changed, 13 insertions, 16 deletions

diff --git a/usr.bin/make/make.1 b/usr.bin/make/make.1
index 6054999..1f07acf 100644
--- a/usr.bin/make/make.1
+++ b/usr.bin/make/make.1
@@ -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