From e5a067a5c5854cda7ba7f0c3c62f46b603437567 Mon Sep 17 00:00:00 2001
From: pds <pds@FreeBSD.org>
Date: Sun, 29 Nov 1998 13:46:39 +0000
Subject: Described the search path Make uses to find makefiles.

---
 usr.bin/make/make.1 | 41 +++++++++++++++++++++++++++++++++++++----
 1 file changed, 37 insertions(+), 4 deletions(-)

(limited to 'usr.bin/make')

diff --git a/usr.bin/make/make.1 b/usr.bin/make/make.1
index c85ca51..e4f86fb 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.14 1998/11/14 16:15:04 dg Exp $
+.\"	$Id: make.1,v 1.15 1998/11/15 05:51:55 bde Exp $
 .\"
 .Dd March 19, 1994
 .Dt MAKE 1
@@ -57,15 +57,17 @@
 is a program designed to simplify the maintenance of other programs.
 Its input is a list of specifications as to the files upon which programs
 and other files depend.
+.Nm Make
+searches a built-in path for this list.
 If the file
 .Ql Pa makefile
-exists, it is read for this list of specifications.
+exists along this path, it is read for this list of specifications.
 If it does not exist, the file
 .Ql Pa Makefile
-is read.
+is used.
 If the file
 .Ql Pa .depend
-exists, it is read (see
+exists, it is also read (see
 .Xr mkdep 1) .
 .Pp
 This manual page is intended as a reference document only.
@@ -938,6 +940,33 @@ command in the file.
 Each source specifies a suffix to
 .Nm make .
 If no sources are specified, any previous specified suffices are deleted.
+.Sh SEARCH PATH
+.Nm Make
+searches for
+.Ql Pa Makefile
+in the following directories, in order:
+.Pp
+.Bl -enum -compact
+.It
+${MAKEOBJDIRPREFIX}`cwd`
+.It
+${MAKEOBJDIR}
+.It
+obj.${MACHINE}
+.It
+obj 
+.It
+/usr/obj${MACHINE}`cwd`
+.It
+The current directory (`cwd`).
+.El
+.Pp
+If
+.Nm make
+finds the
+.Ql Pa Makefile
+someplace other than the current working directory, it adds the CWD to
+the search path.
 .Sh ENVIRONMENT
 .Nm Make
 utilizes the following environment variables, if they exist:
@@ -956,12 +985,16 @@ list of dependencies
 list of dependencies
 .It makefile
 list of dependencies
+.It obj
+object directory
 .It sys.mk
 system makefile
 .It /usr/share/mk
 system makefile directory
 .It /usr/share/doc/psd/12.make
 PMake tutorial
+.It /usr/obj
+system object directory prefix
 .El
 .Sh SEE ALSO
 .Xr mkdep 1
-- 
cgit v1.1