Lines Matching +full:line +full:- +full:orders
4 bbmmaakkee - maintain program dependencies
7 …bmmaakkee [--BBeeiikkNNnnqqrrSSssttWWwwXX] [--CC _d_i_r_e_c_t_o_r_y]…
8 …[--ff _m_a_k_e_f_i_l_e] [--II _d_i_r_e_c_t_o_r_y] [--JJ _p_r_i_v_a_t_…
9 …[--mm _d_i_r_e_c_t_o_r_y] [--TT _f_i_l_e] [--VV _v_a_r_i_a_b_l_e] [--v…
15 which programs and other files depend. If no --ff _m_a_k_e_f_i_l_e option is
21 thorough description of bbmmaakkee and makefiles, please refer to _P_M_a_k_e _- _A
25 command line arguments before parsing them.
29 --BB Try to be backwards compatible by executing a single shell per
30 command and by making the sources of a dependency line in
33 --CC _d_i_r_e_c_t_o_r_y
35 anything else. If multiple --CC options are specified, each is
36 interpreted relative to the previous one: --CC _/ --CC _e_t_c is
37 equivalent to --CC _/_e_t_c.
39 --DD _v_a_r_i_a_b_l_e
42 --dd [--]_f_l_a_g_s
45 `-', they are added to the MAKEFLAGS environment variable and are
51 line buffered. The available _f_l_a_g_s are:
98 assignment, so the file and line number are available.
121 ss Print debugging information about suffix-transformation
127 VV Force the --VV option to print raw values of variables,
134 xx Run shell commands with --xx so the actual commands are
137 --ee Let environment variables override global variables within
140 --ff _m_a_k_e_f_i_l_e
142 …E_F_I_L_E___P_R_E_F_E_R_E_N_C_E. If _m_a_k_e_f_i_l_e is `-', standard input
148 --II _d_i_r_e_c_t_o_r_y
151 the --mm option) is automatically included as part of this list.
153 --ii Ignore non-zero exit of shell commands in the makefile.
154 Equivalent to specifying `-' before each command line in the
157 --JJ _p_r_i_v_a_t_e
160 When the --jj option is in use in a recursive build, this option is
164 --jj _m_a_x___j_o_b_s
169 _._M_A_K_E_._J_O_B_S. Turns compatibility mode off, unless the --BB option
173 line. This can break traditional scripts which change
175 with a fresh environment on the next line. It is more efficient
183 --kk Continue processing after errors are encountered, but only on
187 --mm _d_i_r_e_c_t_o_r_y
189 included via the <_f_i_l_e>-style include statement. The --mm option
193 path used for "_f_i_l_e"-style include statements (see the --II
194 option). The system include path can be referenced via the read-
197 If a directory name in the --mm argument (or the MAKESYSPATH
203 directory replaces the `.../' specification in the --mm argument.
208 --nn Display the commands that would have been executed, but do not
212 --NN Display the commands that would have been executed, but do not
213 actually execute any of them; useful for debugging top-level
216 --qq Do not execute any commands, instead exit 0 if the specified
219 --rr Do not use the built-in rules specified in the system makefile.
221 --SS Stop processing if an error is encountered. This is the default
222 behavior and the opposite of --kk.
224 --ss Do not echo any commands as they are executed. Equivalent to
225 specifying `@@' before each command line in the makefile.
227 --TT _t_r_a_c_e_f_i_l_e
228 When used with the --jj flag, append a trace record to _t_r_a_c_e_f_i_l_e
231 --tt Rather than re-building a target as specified in the makefile,
232 create it or update its modification time to make it appear up-
233 to-date.
235 --VV _v_a_r_i_a_b_l_e
238 printed one per line, with a blank line for each null or
247 …_._E_X_P_A_N_D___V_A_R_I_A_B_L_E_S is set to true and the --ddVV option has not
250 Note that loop-local and target-local variables, as well as
252 processing, are not accessible via this option. The --ddvv debug
256 --vv _v_a_r_i_a_b_l_e
257 Like --VV, but all printed variables are always expanded to their
258 complete value. The last occurrence of --VV or --vv decides whether
261 --WW Treat any warnings during makefile parsing as errors.
263 --ww Print entering and leaving directory messages, pre and post
266 --XX Don't export variables passed on the command line to the
267 environment individually. Variables passed on the command line
274 values passed on the command line are also exported to sub-makes
275 in the environment. The --XX flag disables this behavior.
283 Lines may be continued from one line to the next by ending them with a
285 on the following line are compressed into a single space.
292 is less than that of any of its sources. An out-of-date target is re-
293 created, but not until all sources have been examined and themselves re-
299 are run to create or re-create the target. If bbmmaakkee is
302 !! The same, but the target is always re-created whether or not it is
305 :::: Any dependency line may have attached shell commands, but each one
332 Each line is treated as a separate shell command, unless the end of line
333 is escaped with a backslash `\', in which case that line and the next are
335 `@@', `++', or `--', the command is treated specially.
339 ++ causes the command to be executed even when --nn is given.
341 except that the effect can be limited to a single line of a
344 -- in compatibility mode causes any non-zero exit status of
345 the command line to be ignored.
347 …When bbmmaakkee is run in jobs mode with --jj _m_a_x___j_o_b_s, the entire script f…
349 (non-jobs) mode, each command is run in a separate process. If the
352 line starts with `--' and the shell has ErrCtl enabled, failure of the
353 command line is ignored as in compatibility mode. Otherwise `--' affects
354 the entire job; the script stops at the first command line that fails,
361 force the use of a single shell, escape the line breaks so as to make the
364 avoid-chdir-side-effects:
369 ensure-one-shell-regardless-of-mode:
383 _N_A_M_E is a single-word variable name, consisting, by tradition,
384 of all upper-case letters,
436 1. Variables in dependency lines are expanded as the line is read.
483 Command line variables
484 Variables defined as part of the command line.
489 Local variables can be set on a dependency line, unless
490 …R_G_E_T___L_O_C_A_L___V_A_R_I_A_B_L_E_S is set to `false'. The rest of the line
500 render all of those targets out-of-date.
502 _N_O_T_E: target-local variable assignments behave differently in that;
510 The built-in local variables are:
517 _._I_M_P_S_R_C In suffix-transformation rules, the name/path of the
524 _._O_O_D_A_T_E The list of sources for this target that were deemed out-
525 of-date; also known as `_?'.
544 because they expand to the proper value for each target on the line.
547 AAddddiittiioonnaall bbuuiilltt--iinn vvaarriiaabblleess
602 A boolean that controls the default behavior of the --VV option.
603 If true, variable values printed with --VV are fully expanded; if
616 The top-level makefile that is currently read, as given in the
617 command line.
621 may be specified on bbmmaakkee's command line. Anything specified on
622 … bbmmaakkee's command line is appended to the _._M_A_K_E_F_L_A_G_S variable,
627 The numeric group ID of the user running bbmmaakkee. It is read-only.
630 If bbmmaakkee is run with --jj, the output for each target is prefixed
632 --- _t_a_r_g_e_t ---
636 `${.newline}---${.MAKE:T}[${.MAKE.PID}]' would produce tokens
638 ---make[1234] _t_a_r_g_e_t ---
643 The argument to the --jj option.
646 A read-only boolean that indicates whether the --jj option supports
650 The recursion depth of bbmmaakkee. The top-level instance of bbmmaakkee
653 which should only be evaluated in the top-level instance of
673 current target is considered out-of-date.
678 modifiers that are applied to each line of the old and new
680 target is considered out-of-date.
714 ccoommppaatt Like --BB, puts bbmmaakkee into "compat" mode.
723 determine if a target is out-of-date when the normal
728 out-of-date.
732 for targets to depend on makefiles just in-case they set
739 on the target, its side-effect though, will be to prevent
740 comparison of any command line it appears on. For
747 the target is out-of-date.
750 target is _a_l_w_a_y_s considered out-of-date, which is why
760 mmiissssiinngg--mmeettaa==_b_f
761 If _b_f is true, a missing _._m_e_t_a file makes the target out-
762 of-date.
764 mmiissssiinngg--ffiilleemmoonn==_b_f
765 If _b_f is true, missing filemon data makes the target out-
766 of-date.
780 iiggnnoorree--ccmmdd
790 rraannddoommiizzee--ttaarrggeettss
813 The name of the operating system, see uname(1). It is read-only.
817 to on the command line, so that they may be exported as part of
821 `_._M_A_K_E_O_V_E_R_R_I_D_E_S'. `MAKEFLAGS' is re-exported whenever
830 The process ID of bbmmaakkee. It is read-only.
833 The parent process ID of bbmmaakkee. It is read-only.
856 The numeric ID of the user running bbmmaakkee. It is read-only.
860 value. It is read-only. This allows expansions using the ::@@
874 the command line.)
879 command line.)
912 _._P_A_T_H The space-separated list of directories that bbmmaakkee searches for
927 read-only.
930 The list of known suffixes. It is read-only.
933 The space-separated list of directories that bbmmaakkee searches for
936 modifying the variable which is read-only.
939 The list of targets explicitly specified on the command line, if
942 _V_P_A_T_H The colon-separated (":") list of directories that bbmmaakkee searches
966 treat the expression value as a whitespace-separated list of words. When
983 whitespace and normalizes the inter-word spacing to a single space.
989 ::OO Orders the words lexicographically.
991 ::OOnn Orders the words numerically. A number followed by one of `k', `M'
993 `k', 1048576 for `M', or 1073741824 for `G'. Both upper- and lower-
996 ::OOrr Orders the words in reverse lexicographical order.
999 Orders the words in reverse numerical order.
1021 ::QQ Quotes every shell meta-character in the value, so that it can be
1024 ::qq Quotes every shell meta-character in the value, and also doubles `$'
1041 Computes a 32-bit hash of the value and encodes it as 8 hex digits.
1057 ::ttll Converts the value to lower-case letters.
1066 ::tttt Converts the first character of each word to upper-case, and the
1067 rest to lower-case letters.
1069 ::ttuu Converts the value to upper-case letters.
1099 regular expression _p_a_t_t_e_r_n (see regex(3)) and an ed(1)-style
1120 the variable name itself--which, of course, usually contains
1156 However, a single-letter variable is often more readable:
1164 M_cmpv = S,., ,g:_:range:@i@+ $${_:[-$$i]} \
1176 setting per-target CFLAGS for instance:
1190 (node) must at least have appeared on the right-hand side of a
1228 An empty value, or a value that consists entirely of white-space, is
1232 integers (where index -1 represents the last word).
1241 `::[[22....--11]]' selects all words from the second word to the last
1243 reverse order. For example, `::[[--11....11]]' selects all the words
1246 use `::OOrr' instead of `::OO::[[--11....11]]'.
1262 loops. All these directives are identified by a line beginning with a
1272 using the --II option are searched before the system makefile directory.
1277 …If the include statement is written as ..--iinncclluuddee or as ..ssiinncclluudde…
1296 ..eexxppoorrtt--aallll
1298 start with `.'). This is not affected by the --XX flag, so should
1301 ..eexxppoorrtt--eennvv _v_a_r_i_a_b_l_e ...
1307 ..eexxppoorrtt--lliitteerraall _v_a_r_i_a_b_l_e ...
1308 The same as `.export-env', except that variables in the value are
1316 ..uunneexxppoorrtt--eennvv
1327 .unexport-env
1340 line number.
1344 of the makefile and line number.
1348 line number, bbmmaakkee exits immediately.
1406 command line or was declared the default target (either
1407 implicitly or explicitly, see _._M_A_I_N) before the line containing
1430 as a decimal floating-point number; octal numbers are not supported.
1440 encounters a (whitespace-separated) word it doesn't recognize, either the
1455 <_m_a_k_e_-_l_i_n_e_s>
1460 …and these _v_a_r_i_a_b_l_e_s are substituted into the _m_a_k_e_-_l_i_n_e_s insi…
1470 Un-define the specified global variables. Only global variables
1471 can be un-defined.
1475 command line, and continue to the end of an unescaped new line.
1482 target, exactly as if they all were preceded by a dash (`-').
1486 ..MMAAKKEE Execute the commands associated with this target even if the --nn
1487 or --tt options were specified. Normally used to mark recursive
1492 the most likely case. In "meta" mode, the target is out-of-
1503 applies to any command line that uses the variable _._O_O_D_A_T_E,
1508 skip-compare-for-some:
1529 considered to be out of date, and is not created with the --tt
1530 option. Suffix-transformation rules are not applied to ..PPHHOONNYY
1554 ..WWAAIITT If ..WWAAIITT appears in a dependency line, the sources that precede
1555 it are made before the sources that succeed it in the line.
1594 used to help prevent half-finished or malformed targets from
1606 --ii option.
1618 the shell, though the --ff option has no effect.
1630 clear the read-only attribute from the global variables
1660 ..PPOOSSIIXX If this is the first non-comment line in the main makefile, the
1662 `<posix.mk>' is included if it exists, to provide POSIX-
1663 compatible default rules. If bbmmaakkee is run with the --rr flag,
1664 only `posix.mk' contributes to the default rules. In POSIX-
1674 set the read-only attribute on the global variables specified as
1681 one of the built-in shell specs; sh, ksh, and csh.
1710 check="set -e" ignore="set +e" \
1711 echo="set -v" quiet="set +v" filter="set +v" \
1724 allows the creation of suffix-transformation rules.
1730 cc -o ${.TARGET} -c ${.IMPSRC}
1744 the command line to bbmmaakkee and not as makefile variables; see the
1755 command line
1757 command line
1762 Invalid internal option "-J" in "_d_i_r_e_c_t_o_r_y"
1763 The internal --JJ option coordinates the main bbmmaakkee process with
1764 the sub-make processes to limit the number of jobs that run in
1767 requires that the target running the sub-make is marked with the
1774 To see the chain of sub-makes that leads to the invalid option,
1777 To run the sub-make in parallel mode, even in dry-run mode (see
1778 the --nn option), add the .MAKE pseudo source to the target. This
1779 is appropriate when the sub-make runs the same target in a
1782 To run the sub-make in parallel mode but not in dry-mode, add a
1787 To run the sub-make in compat mode, add the --BB option to its
1788 invocation. This is appropriate when the sub-make is only used
1789 to print a variable's value using the --vv or --VV options.
1791 To make the sub-make independent from the parent make, unset the
1825 ++oo All built-in variables that begin with a dot.
1840 behavior is too ill-defined (and too buggy) to rely upon.
1877 FreeBSD 14.3-RELEASE-p3 November 11, 2025 FreeBSD 14.3-RELEASE-p3