Mon Feb 3 22:25:17 2020 UTC ()
Make delimiters in <file> and "file" literal.


(uwe)
diff -r1.277 -r1.278 src/usr.bin/make/make.1
cvs diff -r1.277 -r1.278 src/usr.bin/make/make.1 (expand / switch to unified diff)

--- src/usr.bin/make/make.1 2020/02/03 15:47:03 1.277
+++ src/usr.bin/make/make.1 2020/02/03 22:25:17 1.278
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: make.1,v 1.277 2020/02/03 15:47:03 kamil Exp $ 1.\" $NetBSD: make.1,v 1.278 2020/02/03 22:25:17 uwe Exp $
2.\" 2.\"
3.\" Copyright (c) 1990, 1993 3.\" Copyright (c) 1990, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors 14.\" 3. Neither the name of the University nor the names of its contributors
@@ -262,35 +262,35 @@ When compatibility mode is off, all comm @@ -262,35 +262,35 @@ When compatibility mode is off, all comm
262target are executed in a single shell invocation as opposed to the 262target are executed in a single shell invocation as opposed to the
263traditional one shell invocation per line. 263traditional one shell invocation per line.
264This can break traditional scripts which change directories on each 264This can break traditional scripts which change directories on each
265command invocation and then expect to start with a fresh environment 265command invocation and then expect to start with a fresh environment
266on the next line. 266on the next line.
267It is more efficient to correct the scripts rather than turn backwards 267It is more efficient to correct the scripts rather than turn backwards
268compatibility on. 268compatibility on.
269.It Fl k 269.It Fl k
270Continue processing after errors are encountered, but only on those targets 270Continue processing after errors are encountered, but only on those targets
271that do not depend on the target whose creation caused the error. 271that do not depend on the target whose creation caused the error.
272.It Fl m Ar directory 272.It Fl m Ar directory
273Specify a directory in which to search for sys.mk and makefiles included 273Specify a directory in which to search for sys.mk and makefiles included
274via the 274via the
275.Pf < Ar file Ns > Ns -style 275.Li \&< Ns Ar file Ns Li \&> Ns -style
276include statement. 276include statement.
277The 277The
278.Fl m 278.Fl m
279option can be used multiple times to form a search path. 279option can be used multiple times to form a search path.
280This path will override the default system include path: /usr/share/mk. 280This path will override the default system include path: /usr/share/mk.
281Furthermore the system include path will be appended to the search path used 281Furthermore the system include path will be appended to the search path used
282for 282for
283.Pf \*q Ar file Ns \*q Ns -style 283.Li \*q Ns Ar file Ns Li \*q Ns -style
284include statements (see the 284include statements (see the
285.Fl I 285.Fl I
286option). 286option).
287.Pp 287.Pp
288If a file or directory name in the 288If a file or directory name in the
289.Fl m 289.Fl m
290argument (or the 290argument (or the
291.Ev MAKESYSPATH 291.Ev MAKESYSPATH
292environment variable) starts with the string 292environment variable) starts with the string
293.Qq \&.../ 293.Qq \&.../
294then 294then
295.Nm 295.Nm
296will search for the specified file or directory named in the remaining part 296will search for the specified file or directory named in the remaining part
@@ -1612,29 +1612,29 @@ in Bourne shell. @@ -1612,29 +1612,29 @@ in Bourne shell.
1612.It Cm \&# 1612.It Cm \&#
1613Returns the number of words in the value. 1613Returns the number of words in the value.
1614.El \" :[range] 1614.El \" :[range]
1615.El 1615.El
1616.Sh INCLUDE STATEMENTS, CONDITIONALS AND FOR LOOPS 1616.Sh INCLUDE STATEMENTS, CONDITIONALS AND FOR LOOPS
1617Makefile inclusion, conditional structures and for loops reminiscent 1617Makefile inclusion, conditional structures and for loops reminiscent
1618of the C programming language are provided in 1618of the C programming language are provided in
1619.Nm . 1619.Nm .
1620All such structures are identified by a line beginning with a single 1620All such structures are identified by a line beginning with a single
1621dot 1621dot
1622.Pq Ql \&. 1622.Pq Ql \&.
1623character. 1623character.
1624Files are included with either 1624Files are included with either
1625.Cm \&.include Pf < Ar file Ns > 1625.Cm \&.include \&< Ns Ar file Ns Cm \&>
1626or 1626or
1627.Cm \&.include Pf \*q Ar file Ns \*q . 1627.Cm \&.include \&\*q Ns Ar file Ns Cm \&\*q .
1628Variables between the angle brackets or double quotes are expanded 1628Variables between the angle brackets or double quotes are expanded
1629to form the file name. 1629to form the file name.
1630If angle brackets are used, the included makefile is expected to be in 1630If angle brackets are used, the included makefile is expected to be in
1631the system makefile directory. 1631the system makefile directory.
1632If double quotes are used, the including makefile's directory and any 1632If double quotes are used, the including makefile's directory and any
1633directories specified using the 1633directories specified using the
1634.Fl I 1634.Fl I
1635option are searched before the system 1635option are searched before the system
1636makefile directory. 1636makefile directory.
1637For compatibility with other versions of 1637For compatibility with other versions of
1638.Nm 1638.Nm
1639.Ql include file ... 1639.Ql include file ...
1640is also accepted. 1640is also accepted.