View | Details | Raw Unified | Return to bug 211948
Collapse All | Expand All

(-)b/contrib/bmake/make.1 (-18 / +25 lines)
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

Return to bug 211948