nethack-gwaa-kiwi/nethack
1
0
Fork 0
Code Pull Requests Activity

This is cron-daily v1-May-7-2026. 005manpages updated: makedefs.txt

Browse Source
This commit is contained in:
nhw_cron
2026-05-07 23:25:06 -04:00
committed by nhmall
parent fed12887ca
commit 669e44c670
1 changed files with 32 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/makedefs.txt
+27 -29
View File
@@ -6,12 +6,12 @@ NAME
makedefs - NetHack miscellaneous build-time functions makedefs - NetHack miscellaneous build-time functions
SYNOPSIS SYNOPSIS
makedefs { -o | -d | -e | -m | -v | -p | -q | -r | -h } makedefs {-o|-d|-e|-m|-v|-p|-q|-r|-h}
makedefs --input file --output file --command makedefs --input file --output file --command
DESCRIPTION DESCRIPTION
Makedefs is a build-time tool used for a variety of NetHack(6) source Makedefs is a build-time tool used for a variety of nethack(6) source
file creation and modification tasks. For historical reasons, makedefs file creation and modification tasks. For historical reasons, makedefs
takes two types of command lines. When invoked with a short option, takes two types of command lines. When invoked with a short option,
the files operated on are determined when makedefs is compiled. When the files operated on are determined when makedefs is compiled. When
@@ -34,7 +34,7 @@ SHORT COMMANDS
only if it is present, to obtain githash= and gitbranch= info only if it is present, to obtain githash= and gitbranch= info
and include related preprocessor #defines in date.h file. and include related preprocessor #defines in date.h file.
-p Generate pm.h -p Generate pm.h.
-q Generate the rumors file. -q Generate the rumors file.
@@ -57,12 +57,12 @@ LONG COMMANDS
dash. dash.
--input file --input file
Specify the input file for the command (if needed). If the file Specify the input file for the command (if needed). If file is
is - standard input is read. "-", makedefs reads the standard input stream.
--output file --output file
Specify the output file for the command (if needed). If the Specify the output file for the command (if needed). If file is
file is - standard output is written. "-", makedefs writes to the standard input stream.
--svs [delimiter] --svs [delimiter]
Generate a version string to standard output without a trailing Generate a version string to standard output without a trailing
@@ -96,32 +96,32 @@ LONG COMMANDS
MDGREP FUNCTIONS MDGREP FUNCTIONS
The --grep command (and certain other commands) filter their input, on The --grep command (and certain other commands) filter their input, on
a line-by-line basis, according to control lines embedded in the input a line-by-line basis, according to control lines embedded in the input
and on information gleaned from the NetHack(6) configuration. This and on information gleaned from the nethack configuration. This allows
allows certain changes such as embedding platform-specific documenta- certain changes such as embedding platform-specific documentation into
tion into the master documentation files. the master documentation files.
Rules: Rules:
- The default conditional state is printing enabled. o The default conditional state is printing enabled.
- Any line NOT starting with a caret (^) is either suppressed o Any line NOT starting with a caret (^) is either suppressed or
or passed through unchanged depending on the current condi- passed through unchanged depending on the current conditional
tional state. state.
- Any line starting with a caret is a control line; as in C, o Any line starting with a caret is a control line; as in C, zero
zero or more spaces may be embedded in the line almost any- or more spaces may be embedded in the line almost anywhere
where (except immediately after the caret); however the (except immediately after the caret); however the caret must be
caret must be in column 1. in column 1.
- Conditionals may be nested. o Conditionals may be nested.
- Makedefs will exit with an error code if any errors are o Makedefs will exit with an error code if any errors are
detected; processing will continue (if it can) to allow as detected; processing will continue (if it can) to allow as many
many errors as possible to be detected. errors as possible to be detected.
- Unknown identifiers are treated as both TRUE and as an o Unknown identifiers are treated as both TRUE and as an error.
error. Note that --undef or #undef in the NetHack(6) con- Note that --undef or #undef in the nethack configuration are
figuration are different from unknown. different from unknown.
Control lines: Control lines:
@@ -129,11 +129,9 @@ MDGREP FUNCTIONS
^# a comment ^# a comment
^?ID ^?ID if the ID is defined set the conditional state to TRUE
if the ID is defined set the conditional state to TRUE
^!ID ^!ID if the ID is not defined set the conditional state to TRUE
if the ID is not defined set the conditional state to TRUE
^: else; invert the conditional state ^: else; invert the conditional state