--- /dev/null
+MAKEDEFS(6) MAKEDEFS(6)
+
+
+
+NAME
+ makedefs - NetHack miscellaneous build-time functions
+
+SYNOPSIS
+ makedefs { -o | -d | -e | -m | -v | -p | -q | -r | -h | -z }
+
+ makedefs --input file --output file --command
+
+DESCRIPTION
+ Makedefs is a build-time tool used for a variety of NetHack(6) source
+ file creation and modification tasks. For historical reasons, makedefs
+ takes two types of command lines. When invoked with a short option,
+ the files operated on are determined when makedefs is compiled. When
+ invoked with a long option, the --input and --output options are used
+ to specify the files for the --command. Each command is only available
+ in one of the two formats.
+
+SHORT COMMANDS
+ Upper and lower case are both accepted for the short commands.
+
+ -o Generate onames.h.
+
+ -d Generate data.base.
+
+ -e Generate dungeon.pdf. The input file dungeon.def is passed
+ through the same logic as that used by the --grep command; see
+ the MDGREP FUNCTIONS section below for details.
+
+ -m Generate monster.c.
+
+ -v Generate date.h and options file.
+
+ -p Generate pm.h
+
+ -q Generate quest.dat.
+
+ -r Generate the rumors file.
+
+ -h Generate the oracles file.
+
+ -z Generate vis_tab.c and vis_tab.h.
+
+LONG COMMANDS
+ --input file
+ Specify the input file for the command (if needed). If the file
+ is - standard input is read.
+
+ --output file
+ Specify the output file for the command (if needed). If the
+ file is - standard output is written.
+
+ --svs [delimiter]
+ Generate a version string to standard output without a trailing
+ newline. If specified, the delimiter is used between each part
+ of the version string.
+
+ --grep Filter the input file to the output file. See the MDGREP FUNC
+ TIONS section below for information on controlling the filtering
+ operation.
+
+ --grep-showvars
+ Show the name and value for each variable known to the grep
+ option.
+
+ --grep-trace
+ Turn on debug tracing for the grep function ( --grep must be
+ specified as well).
+
+ --grep-define symbol
+ Force the value of symbol to be "defined." Symbol must already
+ be known to makedefs.
+
+ --grep-undef symbol
+ Force the definition of symbol to be "undefined." Symbol must
+ already be known to makedefs.
+
+MDGREP FUNCTIONS
+ The --grep command (and certain other commands) filter their input, on
+ a line-by-line basis, according to control lines embedded in the input
+ and on information gleaned from the NetHack(6) configuration. This
+ allows certain changes such as embedding platform-specific documenta
+ tion into the master documentation files.
+
+ Rules:
+
+ - The default conditional state is printing enabled.
+
+ - Any line NOT starting with a caret (^) is either suppressed
+ or passed through unchanged depending on the current condi
+ tional state.
+
+ - Any line starting with a caret is a control line; as in C,
+ zero or more spaces may be embedded in the line almost any
+ where (except immediately after the caret); however the
+ caret must be in column 1.
+
+ - Conditionals may be nested.
+
+ - Makedefs will exit with an error code if any errors are
+ detected; processing will continue (if it can) to allow as
+ many errors as possible to be detected.
+
+ - Unknown identifiers are treated as both TRUE and as an
+ error. Note that --undef or #undef in the NetHack(6) con
+ figuration are different from unknown.
+
+ Control lines:
+
+ ^^ a line starting with a (single) literal caret
+
+ ^# a comment
+
+ ^?ID
+ if the ID is defined set the conditional state to TRUE
+
+ ^!ID
+ if the ID is not defined set the conditional state to TRUE
+
+ ^: else; invert the conditional state
+
+ ^. end the most recent conditional
+
+AUTHOR
+ The NetHack Development Team
+
+SEE ALSO
+ dgn_comp(6)
+
+
+
+4th Berkeley Distribution 29 Apr 2010 MAKEDEFS(6)
projects / nethack / commitdiff