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

update Guidebook and some generated files

Browse Source
This commit is contained in:
nhmall
2024-12-24 10:27:12 -05:00
parent e32ac5a7c7
commit 95cf46c102
7 changed files with 74 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/Guidebook.mn
View File

@@ -47,7 +47,7 @@
.ds f0 \*(vr
.ds f1 \" empty
.\"DO NOT REMOVE NH_DATESUB .ds f2 Date(%B %-d, %Y)
.ds f2 November 4, 2024
.ds f2 November 16, 2024
.
.\" A note on some special characters:
.\" \(lq = left double quote

2
doc/Guidebook.tex
View File

@@ -48,7 +48,7 @@
\author{Original version - Eric S. Raymond\\
(Edited and expanded for 3.7.0 by Mike Stephenson and others)}
%DO NOT REMOVE NH_DATESUB \date{Date(%B %-d, %Y)}
\date{September 13, 2024}
\date{November 16, 2024}
\maketitle

18
doc/dlb.txt
View File

@@ -1,4 +1,4 @@
DLB(6) DLB(6)
DLB(6) Games Manual DLB(6)
@@ -13,8 +13,8 @@ DESCRIPTION
NetHack version 3.1 and higher. It is used to maintain the archive
files from which NetHack reads special level files and other read-only
information. Note that like tar the command and option specifiers are
specified as a continuous string and are followed by any arguments
required in the same order as the option specifiers.
specified as a continuous string and are followed by any arguments re-
quired in the same order as the option specifiers.
This facility is optional and may be excluded during NetHack configura-
tion.
@@ -55,16 +55,16 @@ SEE ALSO
nethack(6), tar(1)
BUGS
Not a good tar emulation; - does not mean stdin or stdout. Should
include an optional compression facility. Not all read-only files for
Not a good tar emulation; - does not mean stdin or stdout. Should in-
clude an optional compression facility. Not all read-only files for
NetHack can be read out of an archive; examining the source is the only
way to know which files can be.
COPYRIGHT
This file is Copyright (C) Kenneth Lorber, 2022 for version
NetHack-3.7:1.12. NetHack may be freely redistributed. See license
for details.
This file is Copyright (C) Kenneth Lorber, DATE(%Y) for version keni-
gitset:1.13. NetHack may be freely redistributed. See license for de-
tails.
NETHACK 8 February 2022 DLB(6)
NETHACK DATE(1-d 1B 1Y) DLB(6)

64
doc/makedefs.txt
View File

@@ -1,4 +1,4 @@
MAKEDEFS(6) MAKEDEFS(6)
MAKEDEFS(6) Games Manual MAKEDEFS(6)
@@ -32,13 +32,13 @@ SHORT COMMANDS
-m Generate date.h and options file. It will read dat/gitinfo.txt,
only if it is present, to obtain githash= and gitbranch=
info and include related preprocessor #defines in date.h file.
info and include related preprocessor #defines in date.h file.
-p Generate pm.h
-q Generate the rumors file.
-s Generate the bogusmon , engrave and epitaph files.
-s Generate the bogusmon, engrave, and epitaph files.
-1 Generate the epitaph file.
@@ -53,7 +53,7 @@ LONG COMMANDS
Show debugging output.
--make [command]
Execute a short command. Command is given without preceding
Execute a short command. Command is given without preceding
dash.
--input file
@@ -61,67 +61,67 @@ LONG COMMANDS
is - standard input is read.
--output file
Specify the output file for the command (if needed). If the
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
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-
--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.
Show the name and value for each variable known to the grep op-
tion.
--grep-trace
Turn on debug tracing for the grep function ( --grep must be
Turn on debug tracing for the grep function ( --grep must be
specified as well).
--grep-defined symbol
Exit shell true (0) if symbol is known and defined, otherwise
Exit shell true (0) if symbol is known and defined, otherwise
exit shell false (1).
--grep-define symbol
Force the value of symbol to be "defined." Symbol must already
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
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.
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 al-
lows certain changes such as embedding platform-specific documentation
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-
- 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
- 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
- Makedefs will exit with an error code if any errors are de-
tected; 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.
- Unknown identifiers are treated as both TRUE and as an er-
ror. Note that --undef or #undef in the NetHack(6) configu-
ration are different from unknown.
Control lines:
@@ -143,9 +143,9 @@ AUTHOR
The NetHack Development Team
COPYRIGHT
This file is Copyright (C) Kenneth Lorber, 2022 for version keni-crash-
web2:1.21. NetHack may be freely redistributed. See license for
details.
This file is Copyright (C) Kenneth Lorber, 2022 for version
NetHack-3.7:1.22. NetHack may be freely redistributed. See license
for details.

4
doc/nethack.txt
View File

@@ -278,7 +278,7 @@ BUGS
Probably infinite.
COPYRIGHT
This file is Copyright (C) Robert Patrick Rankin, 2024 for version
This file is Copyright (C) Robert Patrick Rankin, 2022 for version
NetHack-3.7:1.31. NetHack may be freely redistributed. See license
for details.
@@ -286,4 +286,4 @@ COPYRIGHT
NETHACK 28 February 2024 NETHACK(6)
NETHACK 21 February 2022 NETHACK(6)

28
doc/recover.txt
View File

@@ -1,4 +1,4 @@
RECOVER(6) RECOVER(6)
RECOVER(6) Games Manual RECOVER(6)
@@ -35,14 +35,14 @@ DESCRIPTION
The level file names are of the form base.nn, where nn is an internal
bookkeeping number for the level. The file base.0 is used for game
identity, locking, and, when checkpointing, for the game state. Vari-
ous OSes use different strategies for constructing the base name.
Microcomputers use the character name, possibly truncated and modified
to be a legal filename on that system. Multi-user systems use the
(modified) character name prefixed by a user number to avoid conflicts,
or "xlock" if the number of concurrent players is being limited. It
may be necessary to look in the playground to find the correct base
name of the interrupted game. recover will transform these level files
into a save file of the same name as nethack would have used.
ous OSes use different strategies for constructing the base name. Mi-
crocomputers use the character name, possibly truncated and modified to
be a legal filename on that system. Multi-user systems use the (modi-
fied) character name prefixed by a user number to avoid conflicts, or
"xlock" if the number of concurrent players is being limited. It may
be necessary to look in the playground to find the correct base name of
the interrupted game. recover will transform these level files into a
save file of the same name as nethack would have used.
Since recover must be able to read and delete files from the playground
and create files in the save directory, it has interesting interactions
@@ -53,9 +53,9 @@ DESCRIPTION
some of the microcomputer ports install recover by default.
For a multi-user system, the game administrator may want to arrange for
all .0 files in the playground to be fed to recover when the host
machine boots, and handle game crashes individually. If the user popu-
lation is sufficiently trustworthy, recover can be installed with the
all .0 files in the playground to be fed to recover when the host ma-
chine boots, and handle game crashes individually. If the user popula-
tion is sufficiently trustworthy, recover can be installed with the
same permissions the nethack executable has. In either case, recover
is easily compiled from the distribution utility directory.
@@ -70,8 +70,8 @@ SEE ALSO
BUGS
recover makes no attempt to find out if a base name specifies a game in
progress. If multiple machines share a playground, this would be
impossible to determine.
progress. If multiple machines share a playground, this would be im-
possible to determine.
recover should be taught to use the nethack playground locking mecha-
nism to avoid conflicts.