Changeset 24 for branches/FREEBSD/src/kmk/make.1

Timestamp:

Nov 26, 2002, 10:24:54 PM (23 years ago)

Author:

bird

Message:

Import of RELENG_4_7_0_RELEASE

File:

• branches/FREEBSD/src/kmk/make.1 (modified) (16 diffs)

branches/FREEBSD/src/kmk/make.1

@@ -30 +30 @@
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)make.1      8.8 (Berkeley) 6/13/95
-.\" $FreeBSD: src/usr.bin/make/make.1,v 1.59 2002/09/27 09:21:07 ru Exp $
+.\"     from: @(#)make.1        8.4 (Berkeley) 3/19/94
+.\" $FreeBSD: src/usr.bin/make/make.1,v 1.29.2.14 2002/09/09 19:06:16 archie Exp $
 .\"
-.Dd June 13, 1995
+.Dd March 19, 1994
 .Dt MAKE 1
 .Os
@@ -42 +42 @@
 .Nm
 .Op Fl BPSXeiknqrstv
-.Op Fl C Ar directory
 .Op Fl D Ar variable
 .Op Fl d Ar flags
@@ -63 +62 @@
 files and programs.
 The first of
-.Ql Pa BSDmakefile ,
 .Ql Pa makefile
 and
@@ -90 +88 @@
 .Fl j
 is used.
-.It Fl C Ar directory
-Change to
-.Ar directory
-while running.
 .It Fl D Ar variable
 Define
@@ -178 +172 @@
 that do not depend on the target whose creation caused the error.
 .It Fl m Ar directory
-Specify a directory in which to search for
-.Pa sys.mk
-and makefiles included via the <...> style.
+Specify a directory in which to search for sys.mk and makefiles included
+via the <...> style.
 Multiple directories can be added to form a search path.
 This path will override the default system include path:
@@ -519 +512 @@
 is unable to change into any of the remaining three directories,
 then the current directory is used.
-.Pp
-The
-.Nm
-utility sets
-.Va .OBJDIR
-to the canonical path given by
-.Xr getcwd 3 .
 .It Va .MAKEFLAGS
 The environment variable
@@ -551 +537 @@
 .Va .MAKEFLAGS
 provided for backward compatibility.
+.It Ev PWD
+Alternate path to the current directory.
+Supported if built with WANT_ENV_PWD defined.
+.Nm
+normally sets
+.Ql Va .CURDIR
+to the canonical path given by
+.Xr getcwd 3 .
+However, if the environment variable
+.Ev PWD
+is set and gives a path to the current directory, then
+.Nm
+sets
+.Ql Va .CURDIR
+to the value of
+.Ev PWD
+instead.
+.Ev PWD
+is always set to the value of
+.Ql Va .OBJDIR
+for all programs which
+.Nm
+executes.
 .It Va .TARGETS
 List of targets
@@ -580 +589 @@
 These directories will be searched for source files by
 .Nm
-after it has finished parsing all input makefiles.
+after
+.Nm
+has finished parsing all input makefiles.
 .El
 .Pp
@@ -700 +711 @@
 .Pq Ql \&$ ,
 not a preceding dollar sign as is usual.
+.It Cm T
+Replaces each word in the variable with its last component.
 .It Ar old_string=new_string
 This is the
@@ -720 +733 @@
 to be replaced in
 .Ar new_string
-.It Cm T
-Replaces each word in the variable with its last component.
 .It Cm U
 Converts variable to upper-case letters.
@@ -853 +864 @@
 .Bl -tag -width "Cm XX"
 .It Cm \&|\&|
-logical
-.Tn OR
+logical OR
 .It Cm \&&&
 Logical
@@ -1107 +1117 @@
 Disable parallel mode.
 .It Ic .NO_PARALLEL
-Same as above, for compatibility with other
-.Nm pmake
-variants.
+Same as above, for compatibility with other pmake variants.
 .It Ic .ORDER
 The named targets are made in sequence.
@@ -1191 +1199 @@
 .Ev MAKEFLAGS ,
 .Ev MAKEOBJDIR ,
+.Ev MAKEOBJDIRPREFIX ,
 and
-.Ev MAKEOBJDIRPREFIX .
+.Ev PWD .
 .Sh FILES
 .Bl -tag -width /usr/share/doc/psd/12.make -compact
@@ -1245 +1254 @@
 .Pp
 For loops are expanded before tests, so a fragment such as:
-.Bd -literal -offset indent
+.Bd -literal
 \&.for TMACHINE in ${SHARED_ARCHS}
 \&.if ${TMACHINE} = ${MACHINE}
@@ -1252 +1261 @@
 \&.endfor
 .Ed
-.Pp
 won't work, and should be rewritten the other way around.
-.Pp
-The parsing code is broken with respect to handling a semicolon
-after a colon, so a fragment like this will fail:
-.Bd -literal -offset indent
-HDRS=   foo.h bar.h
-
-all:
-\&.for h in ${HDRS:S;^;${.CURDIR}/;}
-     ...
-\&.endfor
-.Ed
 .Sh SEE ALSO
 .Xr mkdep 1 ,
@@ -1276 +1273 @@
 A
 .Nm
-command appeared in PWB UNIX.
+command appeared in
+.At v7 .