Lines 78-84
and makefiles, please refer to
Link Here
|
78 |
.Pp |
78 |
.Pp |
79 |
.Nm |
79 |
.Nm |
80 |
will prepend the contents of the |
80 |
will prepend the contents of the |
81 |
.Va MAKEFLAGS |
81 |
.Ev MAKEFLAGS |
82 |
environment variable to the command line arguments before parsing them. |
82 |
environment variable to the command line arguments before parsing them. |
83 |
.Pp |
83 |
.Pp |
84 |
The options are as follows: |
84 |
The options are as follows: |
Lines 104-114
to be 1, in the global scope.
Link Here
|
104 |
Turn on debugging, and specify which portions of |
104 |
Turn on debugging, and specify which portions of |
105 |
.Nm |
105 |
.Nm |
106 |
are to print debugging information. |
106 |
are to print debugging information. |
|
|
107 |
.Pp |
107 |
Unless the flags are preceded by |
108 |
Unless the flags are preceded by |
108 |
.Ql \- |
109 |
.Ql \- |
109 |
they are added to the |
110 |
they are added to the |
110 |
.Va MAKEFLAGS |
111 |
.Ev MAKEFLAGS |
111 |
environment variable and will be processed by any child make processes. |
112 |
environment variable and will be processed by any child make processes. |
|
|
113 |
Flags preceded by |
114 |
.Ql \- |
115 |
are used to control debugging output for the current |
116 |
.Nm |
117 |
process, and are not used by child make processes. |
118 |
.Pp |
112 |
By default, debugging information is printed to standard error, |
119 |
By default, debugging information is printed to standard error, |
113 |
but this can be changed using the |
120 |
but this can be changed using the |
114 |
.Ar F |
121 |
.Ar F |
Lines 186-192
Print debugging information about "meta" mode decisions about targets.
Link Here
|
186 |
Print debugging information about making targets, including modification |
193 |
Print debugging information about making targets, including modification |
187 |
dates. |
194 |
dates. |
188 |
.It Ar n |
195 |
.It Ar n |
189 |
Don't delete the temporary command scripts created when running commands. |
196 |
Do not delete the temporary command scripts created when running commands. |
190 |
These temporary scripts are created in the directory |
197 |
These temporary scripts are created in the directory |
191 |
referred to by the |
198 |
referred to by the |
192 |
.Ev TMPDIR |
199 |
.Ev TMPDIR |
Lines 387-397
Treat any warnings during makefile parsing as errors.
Link Here
|
387 |
.It Fl w |
394 |
.It Fl w |
388 |
Print entering and leaving directory messages, pre and post processing. |
395 |
Print entering and leaving directory messages, pre and post processing. |
389 |
.It Fl X |
396 |
.It Fl X |
390 |
Don't export variables passed on the command line to the environment |
397 |
Do not export variables passed on the command line to the environment |
391 |
individually. |
398 |
individually. |
392 |
Variables passed on the command line are still exported |
399 |
Variables passed on the command line are still exported |
393 |
via the |
400 |
via the |
394 |
.Va MAKEFLAGS |
401 |
.Ev MAKEFLAGS |
395 |
environment variable. |
402 |
environment variable. |
396 |
This option may be useful on systems which have a small limit on the |
403 |
This option may be useful on systems which have a small limit on the |
397 |
size of command arguments. |
404 |
size of command arguments. |
Lines 817-823
even if the target is not tagged with
Link Here
|
817 |
.Ic .MAKE |
824 |
.Ic .MAKE |
818 |
The default is |
825 |
The default is |
819 |
.Ql Pa yes |
826 |
.Ql Pa yes |
820 |
for backwards compatability with |
827 |
for backwards compatibility with |
821 |
.Fx 9.0 |
828 |
.Fx 9.0 |
822 |
and earlier. |
829 |
and earlier. |
823 |
.It Va .MAKE.DEPENDFILE |
830 |
.It Va .MAKE.DEPENDFILE |
Lines 859-865
would produce tokens like
Link Here
|
859 |
making it easier to track the degree of parallelism being achieved. |
866 |
making it easier to track the degree of parallelism being achieved. |
860 |
.It Ev MAKEFLAGS |
867 |
.It Ev MAKEFLAGS |
861 |
The environment variable |
868 |
The environment variable |
862 |
.Ql Ev MAKEFLAGS |
869 |
.Ev MAKEFLAGS |
863 |
may contain anything that |
870 |
may contain anything that |
864 |
may be specified on |
871 |
may be specified on |
865 |
.Nm Ns 's |
872 |
.Nm Ns 's |
Lines 867-873
command line.
Link Here
|
867 |
Anything specified on |
874 |
Anything specified on |
868 |
.Nm Ns 's |
875 |
.Nm Ns 's |
869 |
command line is appended to the |
876 |
command line is appended to the |
870 |
.Ql Ev MAKEFLAGS |
877 |
.Ev MAKEFLAGS |
871 |
variable which is then |
878 |
variable which is then |
872 |
entered into the environment for all programs which |
879 |
entered into the environment for all programs which |
873 |
.Nm |
880 |
.Nm |
Lines 913-919
into "compat" mode.
Link Here
|
913 |
Puts |
920 |
Puts |
914 |
.Nm |
921 |
.Nm |
915 |
into "meta" mode, where meta files are created for each target |
922 |
into "meta" mode, where meta files are created for each target |
916 |
to capture the command run, the output generated and if |
923 |
to capture the command run, the output generated, and if |
917 |
.Xr filemon 4 |
924 |
.Xr filemon 4 |
918 |
is available, the system calls which are of interest to |
925 |
is available, the system calls which are of interest to |
919 |
.Nm . |
926 |
.Nm . |
Lines 958-964
is True, when a .meta file is created, mark the target
Link Here
|
958 |
.Ic .SILENT . |
965 |
.Ic .SILENT . |
959 |
.El |
966 |
.El |
960 |
.It Va .MAKE.META.BAILIWICK |
967 |
.It Va .MAKE.META.BAILIWICK |
961 |
In "meta" mode, provides a list of prefixes which |
968 |
In "meta" mode, this variable provides a list of prefixes which |
962 |
match the directories controlled by |
969 |
match the directories controlled by |
963 |
.Nm . |
970 |
.Nm . |
964 |
If a file that was generated outside of |
971 |
If a file that was generated outside of |
Lines 993-1006
The default value is:
Link Here
|
993 |
.It Va .MAKEOVERRIDES |
1000 |
.It Va .MAKEOVERRIDES |
994 |
This variable is used to record the names of variables assigned to |
1001 |
This variable is used to record the names of variables assigned to |
995 |
on the command line, so that they may be exported as part of |
1002 |
on the command line, so that they may be exported as part of |
996 |
.Ql Ev MAKEFLAGS . |
1003 |
.Ev MAKEFLAGS . |
997 |
This behavior can be disabled by assigning an empty value to |
1004 |
This behavior can be disabled by assigning an empty value to |
998 |
.Ql Va .MAKEOVERRIDES |
1005 |
.Ql Va .MAKEOVERRIDES |
999 |
within a makefile. |
1006 |
within a makefile. |
1000 |
Extra variables can be exported from a makefile |
1007 |
Extra variables can be exported from a makefile |
1001 |
by appending their names to |
1008 |
by appending their names to |
1002 |
.Ql Va .MAKEOVERRIDES . |
1009 |
.Ql Va .MAKEOVERRIDES . |
1003 |
.Ql Ev MAKEFLAGS |
1010 |
.Ev MAKEFLAGS |
1004 |
is re-exported whenever |
1011 |
is re-exported whenever |
1005 |
.Ql Va .MAKEOVERRIDES |
1012 |
.Ql Va .MAKEOVERRIDES |
1006 |
is modified. |
1013 |
is modified. |
Lines 1092-1098
is set in the environment or on the command line.)
Link Here
|
1092 |
.Ev ${.CURDIR} |
1099 |
.Ev ${.CURDIR} |
1093 |
.El |
1100 |
.El |
1094 |
.Pp |
1101 |
.Pp |
1095 |
Variable expansion is performed on the value before it's used, |
1102 |
Variable expansion is performed on the value before it is used, |
1096 |
so expressions such as |
1103 |
so expressions such as |
1097 |
.Dl ${.CURDIR:S,^/usr/src,/var/obj,} |
1104 |
.Dl ${.CURDIR:S,^/usr/src,/var/obj,} |
1098 |
may be used. |
1105 |
may be used. |
Lines 1403-1409
and an
Link Here
|
1403 |
.Xr ed 1 Ns \-style |
1410 |
.Xr ed 1 Ns \-style |
1404 |
string |
1411 |
string |
1405 |
.Ar replacement . |
1412 |
.Ar replacement . |
1406 |
Normally, the first occurrence of the pattern |
1413 |
Normally, the first occurrence of |
1407 |
.Ar pattern |
1414 |
.Ar pattern |
1408 |
in each word of the value is substituted with |
1415 |
in each word of the value is substituted with |
1409 |
.Ar replacement . |
1416 |
.Ar replacement . |
Lines 1922-1928
of a string comparison.
Link Here
|
1922 |
When |
1929 |
When |
1923 |
.Nm |
1930 |
.Nm |
1924 |
is evaluating one of these conditional expressions, and it encounters |
1931 |
is evaluating one of these conditional expressions, and it encounters |
1925 |
a (white-space separated) word it doesn't recognize, either the |
1932 |
a (white-space separated) word it does not recognize, either the |
1926 |
.Dq make |
1933 |
.Dq make |
1927 |
or |
1934 |
or |
1928 |
.Dq defined |
1935 |
.Dq defined |
Lines 2049-2056
This source prevents this target from being selected.
Link Here
|
2049 |
.It Ic .OPTIONAL |
2056 |
.It Ic .OPTIONAL |
2050 |
If a target is marked with this attribute and |
2057 |
If a target is marked with this attribute and |
2051 |
.Nm |
2058 |
.Nm |
2052 |
can't figure out how to create it, it will ignore this fact and assume |
2059 |
cannot figure out how to create it, it will ignore this fact and assume |
2053 |
the file isn't needed or already exists. |
2060 |
the file is not needed or already exists. |
2054 |
.It Ic .PHONY |
2061 |
.It Ic .PHONY |
2055 |
The target does not |
2062 |
The target does not |
2056 |
correspond to an actual file; it is always considered to be out of date, |
2063 |
correspond to an actual file; it is always considered to be out of date, |
Lines 2134-2140
This is sort of a
Link Here
|
2134 |
rule for any target (that was used only as a |
2141 |
rule for any target (that was used only as a |
2135 |
source) that |
2142 |
source) that |
2136 |
.Nm |
2143 |
.Nm |
2137 |
can't figure out any other way to create. |
2144 |
cannot figure out any other way to create. |
2138 |
Only the shell script is used. |
2145 |
Only the shell script is used. |
2139 |
The |
2146 |
The |
2140 |
.Ic .IMPSRC |
2147 |
.Ic .IMPSRC |