Lines Matching +full:- +full:- +full:no +full:- +full:print +full:- +full:directory

21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
41 .Op Fl C Ar directory
45 .Op Fl I Ar directory
48 .Op Fl m Ar directory
53 .Op Ar target No ...
59 If no
77 .%T "PMake \- A Tutorial"
86 .Bl -tag -width Ds
90 .It Fl C Ar directory
92 .Ar directory
104 .It Fl d Oo Cm \- Oc Ns Ar flags
107 are to print debugging information.
109 .Ql \- ,
123 .Bl -tag -width Ds
125 Print all possible debugging information;
128 Print debugging information about archive searching and caching.
130 Print debugging information about the current working directory.
132 Print debugging information about conditional evaluation.
134 Print debugging information about directory searching and caching.
136 Print debugging information about failed commands and targets.
154 option has no effect).
162 Print debugging information about loop evaluation.
164 Print the input graph before making anything.
166 Print the input graph after making everything, or before exiting
169 Print the input graph before exiting on error.
171 Print debugging information about hash table operations.
173 Print debugging information about running multiple shells.
179 Print commands in Makefiles regardless of whether or not they are prefixed by
188 Print debugging information about
192 Print debugging information about making targets, including modification
196 These temporary scripts are created in the directory
215 Print debugging information about makefile parsing.
217 Print debugging information about suffix-transformation rules.
219 Print debugging information about target list maintenance.
223 option to print raw values of variables,
227 Print debugging information about variable assignment and expansion.
243 .Ql \&- ,
246 .It Fl I Ar directory
247 Specify a directory in which to search for makefiles and included makefiles.
248 The system makefile directory (or directories, see the
252 Ignore non-zero exit of shell commands in the makefile.
254 .Ql \&-
301 .It Fl m Ar directory
302 Specify a directory in which to search for
305 .Li \&< Ns Ar file Ns Li \&> Ns -style
313 .Li \*q Ns Ar file Ns Li \*q Ns -style
317 The system include path can be referenced via the read-only variable
320 If a directory name in the
327 searches for the specified file or directory named in the remaining part
329 The search starts with the current directory
331 If the search is successful, the resulting directory replaces the
352 useful for debugging top-level makefiles
358 Do not use the built-in rules specified in the system makefile.
376 Rather than re-building a target as specified in the makefile, create it
377 or update its modification time to make it appear up-to-date.
379 Print the value of
402 Note that loop-local and target-local variables, as well as values
421 Print entering and leaving directory messages, pre and post processing.
436 sub-makes in the environment.
441 but no ordering is enforced.
461 An out-of-date target is re-created, but not until all sources
462 have been examined and themselves re-created as needed.
464 .Bl -tag -width flag
470 re-create the target.
475 The same, but the target is always re-created whether or not it is out
486 for dependency lines with no sources, the attached shell
514 Expansion is in directory order, not alphabetically as done in the shell.
537 .Sq Ic \- ,
539 .Bl -tag -offset indent -width indent
550 .It Ic \-
552 causes any non-zero exit status of the command line to be ignored.
560 In compatibility (non-jobs) mode, each command is run in a separate process.
567 .Sq Ic \-
571 .Sq Ic \-
583 without the intention of changing the directory for subsequent commands
588 .Bd -literal -offset indent
589 avoid-chdir-side-effects:
594 ensure-one-shell-regardless-of-mode:
602 changes the current working directory to
605 each child process starts with that as its current working directory.
612 .Bl -tag -offset Ds -width Ds
614 is a single-word variable name,
615 consisting, by tradition, of all upper-case letters,
630 .Bl -tag -width Ds
647 .\" See var-op-expand.mk, the section with LATER and INDIRECT.
666 and the expression contains no modifiers,
680 .Bl -enum
694 .Bd -literal -offset indent
707 .Bd -literal -offset indent
713 .Bl -tag -offset indent -width indent
736 .Bl -tag -width Ds
757 .Bd -literal -offset indent
769 of those targets out-of-date.
772 target-local variable assignments behave differently in that;
773 .Bl -tag -width Ds -offset indent
782 The seven built-in local variables are:
783 .Bl -tag -width ".Va .ARCHIVE" -offset indent
791 In suffix-transformation rules, the name/path of the source from which the
801 The list of sources for this target that were deemed out-of-date; also
855 .Ss Additional built-in variables
859 .Bl -tag
860 .\" NB: This list is sorted case-insensitive, ignoring punctuation.
861 .\" NB: To find all built-in variables in make's source code,
864 .\" NB: Last synced on 2023-01-01.
870 A path to the directory where
894 The directory of the file this makefile was included from.
938 do not print error information at the end.
951 The top-level makefile that is currently read,
970 It is read-only.
977 .Dl --- Ar target Li ---
982 is empty, no token is printed.
986 .Ql ${.newline}---${.MAKE:T}[${.MAKE.PID}]
988 .Dl ---make[1234] Ar target Li ---
995 A read-only boolean that indicates whether the
1002 The top-level instance of
1007 to protect things which should only be evaluated in the top-level instance of
1034 the current target is considered out-of-date.
1042 commands still differ, the target is considered out-of-date.
1080 .Bl -tag -width indent
1110 .It Cm missing-meta= Ns Ar bf
1115 file makes the target out-of-date.
1116 .It Cm missing-filemon= Ns Ar bf
1119 is true, missing filemon data makes the target out-of-date.
1131 mode, print a clue about the target being built.
1135 .It Cm ignore-cmd
1148 .It Cm randomize-targets
1154 Used to create files in a separate directory, see
1171 Used to create files in a separate directory, see
1176 It is read-only.
1188 is re-exported whenever
1201 It is read-only.
1205 It is read-only.
1250 It is read-only.
1262 It is read-only.
1272 A path to the directory where the targets are built.
1276 .Bl -enum
1311 changes to the specified directory if it exists, and sets
1315 to that directory before executing any targets.
1321 checks that the specified directory is writable and ignores it if not.
1325 .Dq no .
1327 The directory name of the current makefile being parsed.
1337 The space-separated list of directories that
1347 .\" XXX: There is no make variable named 'PWD',
1350 Alternate path to the current directory.
1358 is set and gives a path to the current directory,
1378 It is read-only.
1381 It is read-only.
1383 The space-separated list of directories that
1388 rather than modifying the variable which is read-only.
1392 The colon-separated
1405 .D1 Ic \&${ Ar variable\| Oo Ic \&: Ar modifier\| Oo Ic \&: No ... Oc Oc Ic \&}
1414 .Bd -literal -offset indent
1415 .Ar modifier_variable\^ Li \&= Ar modifier Ns Oo Ic \&: Ns No ... Oc
1418 .Ic \&${ Ar variable Ic \&:${ Ar modifier_variable Ic \&} Oo Ic \&: No ... Oc Ic \&}
1433 others treat the expression value as a whitespace-separated list of words.
1440 .Bl -tag -width EEE
1461 and normalizes the inter-word spacing to a single space.
1484 Both upper- and lower-case letters are accepted.
1496 .Bd -literal -offset indent
1508 .Bd -literal -offset indent
1515 Quotes every shell meta-character in the value, so that it can be passed
1518 Quotes every shell meta-character in the value, and also doubles
1545 Computes a 32-bit hash of the value and encodes it as 8 hex digits.
1579 Converts the value to lower-case letters.
1587 is omitted, no separator is used.
1590 Converts the first character of each word to upper-case,
1591 and the rest to lower-case letters.
1593 Converts the value to upper-case letters.
1604 .It Cm \&:S\| No \&/ Ar old_string\| No \&/ Ar new_string\| No \&/ Op Cm 1gW
1657 .It Cm \&:C\| No \&/ Ar pattern\| No \&/ Ar replacement\| No \&/ Op Cm 1gW
1669 .Xr ed 1 Ns \-style
1711 .No itself Ns \^\(em\^ Ns
1714 .Dl ${NUMBERS:M42:?match:no}
1719 .Dl ${"${NUMBERS:M42}" != \&"\&":?match:no} .
1782 However, a single-letter variable is often more readable:
1791 .Bd -literal -offset indent
1793 M_cmpv = S,., ,g:_:range:@i@+ $${_:[-$$i]} \&\\
1812 It is handy for setting per-target CFLAGS for instance:
1824 If no such node exists or its path is null, the name of the variable is used.
1826 appeared on the right-hand side of a dependency.
1870 An empty value, or a value that consists entirely of white-space,
1877 (where index \-1 represents the last word).
1883 .Bl -tag -width index
1895 .Sq Cm \&:[2..-1]
1903 .Sq Cm \&:[-1..1]
1910 .Sq Cm \&:O:[-1..1] .
1951 the system makefile directory.
1952 If double quotes are used, the including makefile's directory and any
1955 option are searched before the system makefile directory.
1958 .Sq Cm include Ar file No ...
1963 .Cm .-include
1975 .Bl -tag -width Ds
1976 .It Ic .export Ar variable No ...
1986 .It Ic .export-all
1992 .It Ic .export-env Ar variable No ...
2001 .It Ic .export-literal Ar variable No ...
2003 .Ql .export-env ,
2005 .It Ic .unexport Ar variable No ...
2012 If no variable list is provided, all globals are unexported,
2016 .It Ic .unexport-env
2027 .Bd -literal -offset indent
2030 .Li .unexport-env
2045 .Bl -tag -width Ds
2060 .Bl -tag
2061 .It Ic .if \*[maybenot] Ar expression Op Ar operator expression No ...
2063 .It Ic .ifdef \*[maybenot] Ar variable Op Ar operator variable No ...
2065 .It Ic .ifndef \*[maybenot] Ar variable Op Ar operator variable No ...
2067 .It Ic .ifmake \*[maybenot] Ar target Op Ar operator target No ...
2069 .It Ic .ifnmake \*[maybenot] Ar target Op Ar operator target No ...
2073 .It Ic .elif \*[maybenot] Ar expression Op Ar operator expression No ...
2078 .It Ic .elifdef \*[maybenot] Ar variable Op Ar operator variable No ...
2083 .It Ic .elifndef \*[maybenot] Ar variable Op Ar operator variable No ...
2088 .It Ic .elifmake \*[maybenot] Ar target Op Ar operator target No ...
2093 .It Ic .elifnmake \*[maybenot] Ar target Op Ar operator target No ...
2105 .Bl -tag
2125 .Bl -tag
2170 otherwise it is interpreted as a decimal floating-point number;
2191 a (whitespace-separated) word it doesn't recognize, either the
2225 .Bl -tag -compact -width Ds
2226 .It Ic \&.for Ar variable Oo Ar variable No ... Oc Ic in Ar expression
2227 .It Aq Ar make-lines
2239 .Ar make-lines
2252 .Bl -tag -width Ds
2253 .It Ic .undef Ar variable No ...
2254 Un-define the specified global variables.
2255 Only global variables can be un-defined.
2263 .Bl -tag -width .IGNOREx
2269 .Pq Ql \- .
2295 mode, the target is out-of-date if the meta file is missing.
2312 .Bd -literal -offset indent
2314 skip-compare-for-some:
2330 if no target was specified.
2343 Suffix-transformation rules are not applied to
2386 .Bd -literal
2410 .Bl -tag -width .BEGINx
2432 This setting can be used to help prevent half-finished or malformed
2446 If no sources are specified, this is the equivalent of specifying the
2454 If no target is specified when
2464 no effect.
2468 .\" If no targets are
2481 clear the read-only attribute from the global variables specified as sources.
2487 changes the current working directory to it and updates the value of
2498 .Bd -literal
2506 .\" If no targets are
2510 found in the current directory.
2511 If no sources are specified,
2515 target, the current working directory is searched last.
2527 If this is the first non-comment line in the main makefile,
2535 to provide POSIX-compatible default rules.
2547 If no sources are specified, the
2551 set the read-only attribute on the global variables specified as sources.
2559 .Bl -tag -width ".Li hasErrCtls"
2561 This is the minimal specification, used to select one of the built-in
2594 .Bd -literal
2596 check="set \-e" ignore="set +e" \e
2597 echo="set \-v" quiet="set +v" filter="set +v" \e
2604 If no sources are specified, the
2615 If no sources are specified, any previously specified suffixes are deleted.
2616 It allows the creation of suffix-transformation rules.
2619 .Bd -literal
2622 cc \-o ${.TARGET} \-c ${.IMPSRC}
2629 If no sources are specified,
2657 .Bl -tag -width /usr/share/mk -compact
2661 first default makefile if no makefile is specified on the command line
2663 second default makefile if no makefile is specified on the command line
2667 system makefile directory
2692 .Bl -bullet -offset indent
2709 All built-in variables that begin with a dot.
2740 historically its behavior is too ill-defined (and too buggy) to rely
2750 Basic use of suffix rules (for files only in the current directory,
2785 There is no way of escaping a space character in a filename.