===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/make/make.1,v
retrieving revision 1.27
retrieving revision 1.28
diff -c -r1.27 -r1.28
*** src/usr.bin/make/make.1	2000/01/19 17:28:52	1.27
--- src/usr.bin/make/make.1	2000/03/10 19:07:21	1.28
***************
*** 1,4 ****
! .\"	$OpenBSD: make.1,v 1.27 2000/01/19 17:28:52 espie Exp $
  .\"	$NetBSD: make.1,v 1.18 1997/03/10 21:19:53 christos Exp $
  .\"
  .\" Copyright (c) 1990, 1993
--- 1,4 ----
! .\"	$OpenBSD: make.1,v 1.28 2000/03/10 19:07:21 aaron Exp $
  .\"	$NetBSD: make.1,v 1.18 1997/03/10 21:19:53 christos Exp $
  .\"
  .\" Copyright (c) 1990, 1993
***************
*** 60,74 ****
  Its input is a list of specifications as to the files upon which programs
  and other files depend.
  If the file
! .Ql Pa BSDmakefile
  exists, it is read for this list of specifications.
  If it does not exist, the files
! .Ql Pa makefile
  and
! .Ql Pa Makefile
  are tried in order.
  If the file
! .Ql Pa .depend
  exists, it is read (see
  .Xr mkdep 1) .
  .Pp
--- 60,74 ----
  Its input is a list of specifications as to the files upon which programs
  and other files depend.
  If the file
! .Pa BSDmakefile
  exists, it is read for this list of specifications.
  If it does not exist, the files
! .Pa makefile
  and
! .Pa Makefile
  are tried in order.
  If the file
! .Pa .depend
  exists, it is read (see
  .Xr mkdep 1) .
  .Pp
***************
*** 107,114 ****
  .It Ar d
  Print debugging information about directory searching and caching.
  .It Ar f
! Print debugging information about the execution of for loops. Currently a
! no-op.
  .It Ar "g1"
  Print the input graph before making anything.
  .It Ar "g2"
--- 107,114 ----
  .It Ar d
  Print debugging information about directory searching and caching.
  .It Ar f
! Print debugging information about the execution of for loops.
! Currently a no-op.
  .It Ar "g1"
  Print the input graph before making anything.
  .It Ar "g2"
***************
*** 131,139 ****
  makefiles.
  .It Fl f Ar makefile
  Specify a makefile to read instead of the default
! .Ql Pa makefile
  and
! .Ql Pa Makefile .
  If
  .Ar makefile
  is
--- 131,139 ----
  makefiles.
  .It Fl f Ar makefile
  Specify a makefile to read instead of the default
! .Pa makefile
  and
! .Pa Makefile .
  If
  .Ar makefile
  is
***************
*** 153,159 ****
  .It Fl j Ar max_jobs
  Specify the maximum number of jobs that
  .Nm
! may have running at any one time. Turns compatibility mode off, unless the
  .Ar B
  flag is also specified.
  .It Fl k
--- 153,160 ----
  .It Fl j Ar max_jobs
  Specify the maximum number of jobs that
  .Nm
! may have running at any one time.
! Turns compatibility mode off, unless the
  .Ar B
  flag is also specified.
  .It Fl k
***************
*** 161,167 ****
  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 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:
  .Pa /usr/share/mk .
  Furthermore, the system include path will be appended to the search path used
--- 162,169 ----
  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 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:
  .Pa /usr/share/mk .
  Furthermore, the system include path will be appended to the search path used
***************
*** 183,190 ****
  .It Fl r
  Do not use the built-in rules specified in the system makefile.
  .It Fl S
! Stop processing when an error is encountered.  Default
! behavior. This is needed to negate the
  .Fl k
  option during recursive builds.
  .It Fl s
--- 185,193 ----
  .It Fl r
  Do not use the built-in rules specified in the system makefile.
  .It Fl S
! Stop processing when an error is encountered.
! Default behavior.
! This is needed to negate the
  .Fl k
  option during recursive builds.
  .It Fl s
***************
*** 456,462 ****
  is defined,
  .Nm
  prepends its contents to the current directory name and tries for
! the resulting directory. If that fails,
  .Nm
  remains in the current directory.
  If
--- 459,466 ----
  is defined,
  .Nm
  prepends its contents to the current directory name and tries for
! the resulting directory.
! If that fails,
  .Nm
  remains in the current directory.
  If
***************
*** 465,479 ****
  .Nm
  checks
  .Ev MAKEOBJDIR
! and tries to change into that directory.  Should that fail,
  .Nm
! remains in the current directory.  If
  .Ev MAKEOBJDIR
  is not defined, it tries to change into the directory named
  .Pa obj.${MACHINE}
  (see
  .Va MACHINE
! variable). If it still has found no special directory,
  .Nm
  next tries the directory named
  .Pa obj .
--- 469,486 ----
  .Nm
  checks
  .Ev MAKEOBJDIR
! and tries to change into that directory.
! Should that fail,
  .Nm
! remains in the current directory.
! If
  .Ev MAKEOBJDIR
  is not defined, it tries to change into the directory named
  .Pa obj.${MACHINE}
  (see
  .Va MACHINE
! variable).
! If it still has found no special directory,
  .Nm
  next tries the directory named
  .Pa obj .
***************
*** 491,497 ****
  may contain anything that
  may be specified on
  .Nm make Ns 's
! command line. Its contents are stored in
  .Nm make Ns 's
  .Va .MAKEFLAGS
  variable.
--- 498,505 ----
  may contain anything that
  may be specified on
  .Nm make Ns 's
! command line.
! Its contents are stored in
  .Nm make Ns 's
  .Va .MAKEFLAGS
  variable.
***************
*** 669,681 ****
  .Xr regex 3 )
  and an
  .Xr ed 1 Ns \-style
! replacement string.  Normally, the first occurrence of the pattern in
! each word of the value is changed.  The
  .Ql 1
  modifier causes the substitution to apply to at most one word; the
  .Ql g
  modifier causes the substitution to apply to as many instances of the
! search pattern as occur in the word or words it is found in.  Note that
  .Ql 1
  and
  .Ql g
--- 677,692 ----
  .Xr regex 3 )
  and an
  .Xr ed 1 Ns \-style
! replacement string.
! Normally, the first occurrence of the pattern in
! each word of the value is changed.
! The
  .Ql 1
  modifier causes the substitution to apply to at most one word; the
  .Ql g
  modifier causes the substitution to apply to as many instances of the
! search pattern as occur in the word or words it is found in.
! Note that
  .Ql 1
  and
  .Ql g
***************
*** 697,703 ****
  .Ar %
  then it is assumed that they are
  anchored at the end of each word, so only suffixes or entire
! words may be replaced. Otherwise
  .Ar %
  is the substring of
  .Ar old_string
--- 708,715 ----
  .Ar %
  then it is assumed that they are
  anchored at the end of each word, so only suffixes or entire
! words may be replaced.
! Otherwise
  .Ar %
  is the substring of
  .Ar old_string
***************
*** 705,711 ****
  .Ar new_string
  .El
  .Sh INCLUDE STATEMENTS, CONDITIONALS AND FOR LOOPS
! Makefile inclusion, conditional structures and for loops  reminiscent
  of the C programming language are provided in
  .Nm make .
  All such structures are identified by a line beginning with a single
--- 717,723 ----
  .Ar new_string
  .El
  .Sh INCLUDE STATEMENTS, CONDITIONALS AND FOR LOOPS
! Makefile inclusion, conditional structures and for loops reminiscent
  of the C programming language are provided in
  .Nm make .
  All such structures are identified by a line beginning with a single
***************
*** 867,877 ****
  .El
  .Pp
  .Ar expression
! may also be an arithmetic or string comparison.  Variable expansion is
  performed on both sides of the comparison, after which the integral
! values are compared.  A value is interpreted as hexadecimal if it is
  preceded by 0x, otherwise it is decimal; octal numbers are not supported.
! The standard C relational operators are all supported.  If after
  variable expansion, either the left or right hand side of a
  .Ql Ic ==
  or
--- 879,892 ----
  .El
  .Pp
  .Ar expression
! may also be an arithmetic or string comparison.
! Variable expansion is
  performed on both sides of the comparison, after which the integral
! values are compared.
! A value is interpreted as hexadecimal if it is
  preceded by 0x, otherwise it is decimal; octal numbers are not supported.
! The standard C relational operators are all supported.
! If after
  variable expansion, either the left or right hand side of a
  .Ql Ic ==
  or
***************
*** 932,939 ****
  .El
  After the for
  .Ar expression
! is evaluated, it is split into words. The
! iteration
  .Ar variable
  is successively set to each word, and substituted in the
  .Ic make-rules
--- 947,954 ----
  .El
  After the for
  .Ar expression
! is evaluated, it is split into words.
! The iteration
  .Ar variable
  is successively set to each word, and substituted in the
  .Ic make-rules
***************
*** 996,1002 ****
  If special
  .Ic .WAIT
  source is appears in a dependency line, the sources that precede it are
! made before the sources that succeed it in the line. Loops are not being
  detected and targets that form loops will be silently ignored.
  .El
  .Sh "SPECIAL TARGETS"
--- 1011,1018 ----
  If special
  .Ic .WAIT
  source is appears in a dependency line, the sources that precede it are
! made before the sources that succeed it in the line.
! Loops are not being
  detected and targets that form loops will be silently ignored.
  .El
  .Sh "SPECIAL TARGETS"
***************
*** 1032,1038 ****
  option.
  .It Ic .INCLUDES
  A list of suffixes that indicate files that can be included in a source
! file. The suffix must have already been declared with
  .Ic .SUFFIXES ,
  any suffix so declared will have the directories on its search path (see
  .Ic .PATH )
--- 1048,1055 ----
  option.
  .It Ic .INCLUDES
  A list of suffixes that indicate files that can be included in a source
! file.
! The suffix must have already been declared with
  .Ic .SUFFIXES ,
  any suffix so declared will have the directories on its search path (see
  .Ic .PATH )
***************
*** 1053,1059 ****
  .It Ic .MAIN
  If no target is specified when
  .Nm
! is invoked, this target will be built. This is always set, either
  explicitly, or implicitly when
  .Nm
  selects the default target, to give the user a way to refer to the default
--- 1070,1077 ----
  .It Ic .MAIN
  If no target is specified when
  .Nm
! is invoked, this target will be built.
! This is always set, either
  explicitly, or implicitly when
  .Nm
  selects the default target, to give the user a way to refer to the default
***************
*** 1094,1100 ****
  .It Ic .PHONY
  Apply the
  .Ic .PHONY
! attribute to any specified sources. Targets with this attribute are always
  considered to be out of date.
  .It Ic .PRECIOUS
  Apply the
--- 1112,1119 ----
  .It Ic .PHONY
  Apply the
  .Ic .PHONY
! attribute to any specified sources.
! Targets with this attribute are always
  considered to be out of date.
  .It Ic .PRECIOUS
  Apply the
***************
*** 1188,1194 ****
  .Pp
  The evaluation of
  .Ar expression
! in a test is very simple-minded. Currently, the only form that works is
  .Ql .if ${VAR} op something
  For instance, you should write tests as
  .Ql .if ${VAR} = "string"
--- 1207,1214 ----
  .Pp
  The evaluation of
  .Ar expression
! in a test is very simple-minded.
! Currently, the only form that works is
  .Ql .if ${VAR} op something
  For instance, you should write tests as
  .Ql .if ${VAR} = "string"
***************
*** 1213,1219 ****
  Variable handling is incredibly inefficient.
  .Pp
  The handling of ; and other special characters in tests may be utterly
! bogus. For instance, in
  .Bd -literal
  \&A=abcd;c.c
  \&.if ${A:R} == "abcd;c"
--- 1233,1240 ----
  Variable handling is incredibly inefficient.
  .Pp
  The handling of ; and other special characters in tests may be utterly
! bogus.
! For instance, in
  .Bd -literal
  \&A=abcd;c.c
  \&.if ${A:R} == "abcd;c"
***************
*** 1221,1227 ****
  .Pp
  the test will never match, even though the value is correct.
  .Pp
! The conditional handler is incredibly lame. Junk such as
  .Bd -literal
  \&.if defined anything goes (A)
  .Ed
--- 1242,1249 ----
  .Pp
  the test will never match, even though the value is correct.
  .Pp
! The conditional handler is incredibly lame.
! Junk such as
  .Bd -literal
  \&.if defined anything goes (A)
  .Ed
***************
*** 1239,1244 ****
--- 1261,1268 ----
  A will evaluate to a b c d after the loop, not z b c d.
  .Sh SEE ALSO
  .Xr mkdep 1
+ .Pp
+ .%T "Make \- A Tutorial" .
  .Sh HISTORY
  A
  .Nm