Patch for /usr/bin/make docs

Max Okumoto okumoto at home
Mon Nov 8 01:31:28 PST 2004


When we merged in changes from FreeBSD/RELENG_4 on 2004/10/24
we missed the patch for make.1.  You can use the attached
patch or you can use cvs to extract it.
% cvs diff -u -rRELENG_4_9 -rRELENG_4 make.1

				Max Okumoto
Index: make.1
===================================================================
RCS file: /usr/home/okumoto/Work/make/fbsd-cvs/src/usr.bin/make/make.1,v
retrieving revision 1.29.2.15
retrieving revision 1.29.2.16
diff -u -r1.29.2.15 -r1.29.2.16
--- make.1	17 Dec 2002 19:01:18 -0000	1.29.2.15
+++ make.1	10 Jul 2004 08:14:42 -0000	1.29.2.16
@@ -32,7 +32,7 @@
 .\"	from: @(#)make.1	8.4 (Berkeley) 3/19/94
 .\" $FreeBSD$
 .\"
-.Dd March 19, 1994
+.Dd July 2, 2004
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -454,7 +454,7 @@
 .Nm
 sets or knows about the following internal variables or environment
 variables:
-.Bl -tag -width MAKEFLAGS
+.Bl -tag -width ".Va MAKEFILE_LIST"
 .It Va \&$
 A single dollar sign
 .Ql \&$ ,
@@ -516,6 +516,19 @@
 .Nm
 is unable to change into any of the remaining three directories,
 then the current directory is used.
+.It Va .MAKEFILE_LIST
+As
+.Nm
+reads various makefiles, including the default files and any
+obtained from the command line and
+.Ic .include
+directives, their names will be automatically appended to the
+.Va .MAKEFILE_LIST
+variable.
+They are added right before
+.Nm
+begins to parse them, so that the name of the current makefile is the
+last word in this variable.
 .It Va .MAKEFLAGS
 The environment variable
 .Ev MAKEFLAGS
@@ -1230,6 +1243,10 @@
 .Ev MAKEOBJDIRPREFIX
 directory.
 .El
+.Sh EXAMPLES
+List all included makefiles in order visited:
+.Pp
+.Dl "make -V .MAKEFILE_LIST | tr \e\  \e\en"
 .Sh BUGS
 The determination of
 .Va .OBJDIR




More information about the Submit mailing list