1 .TH MAKEDEFS 6 "29 Apr 2010"
2 .\" NetHack 3.6 makedefs.6 $NHDT-Date: 1432512786 2015/05/25 00:13:06 $ $NHDT-Branch: master $:$NHDT-Revision: 1.7 $
5 makedefs \- NetHack miscellaneous build-time functions
38 is a build-time tool used for a variety of
40 source file creation and modification tasks. For historical reasons,
42 takes two types of command lines. When invoked with a short option, the
43 files operated on are determined when
45 is compiled. When invoked with a long option, the
49 options are used to specify the files for the
51 Each command is only available in one of the two formats.
53 Upper and lower case are both accepted for the short commands.
71 same logic as that used by the
75 section below for details.
130 Show debugging output.
133 .B --make \fR[\fIcommand\fR]
134 Execute a short command. Command is given without preceding dash.
140 for the command (if needed). If the file is - standard
147 for the command (if needed). If the file is - standard
151 .B --svs \fR[\fIdelimiter\fR]
152 Generate a version string to standard output without a trailing newline.
153 If specified, the delimiter is used between each part of the version string.
158 .I file to the output
162 section below for information on controlling the filtering operation.
166 Show the name and value for each variable known to the grep option.
170 Turn on debug tracing for the grep function (
172 must be specified as well).
175 .BI --grep-define " symbol"
180 must already be known to
184 .BI --grep-undef " symbol"
185 Force the definition of
189 must already be known to
194 command (and certain other commands) filter their input, on a line-by-line
195 basis, according to control lines embedded in the input and on information
198 configuration. This allows certain changes such as embedding platform-specific
199 documentation into the master documentation files.
204 The default conditional state is printing enabled.
208 starting with a caret (^) is either suppressed or passed through unchanged
209 depending on the current conditional state.
211 Any line starting with a caret is a control line; as in C, zero or more spaces
212 may be embedded in the line almost anywhere (except immediately after the
213 caret); however the caret must be in column 1.
215 Conditionals may be nested.
218 will exit with an error code if any errors are detected; processing will
219 continue (if it can) to allow as many errors as possible to be detected.
221 Unknown identifiers are treated as both TRUE and as an error. Note that
222 .BR --undef " or " #undef
225 configuration are different from unknown.
231 a line starting with a (single) literal caret
237 is defined set the conditional state to TRUE
241 is not defined set the conditional state to TRUE
243 else; invert the conditional state
245 end the most recent conditional
249 The NetHack Development Team