update Guidebook and some generated files

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
+15 -14
View File
@@ -47,20 +47,21 @@ Val-strt.lua Wiz-fila.lua Wiz-filb.lua Wiz-goal.lua Wiz-loca.lua
Wiz-strt.lua air.lua asmodeus.lua astral.lua baalz.lua Wiz-strt.lua air.lua asmodeus.lua astral.lua baalz.lua
bigrm-1.lua bigrm-2.lua bigrm-3.lua bigrm-4.lua bigrm-5.lua bigrm-1.lua bigrm-2.lua bigrm-3.lua bigrm-4.lua bigrm-5.lua
bigrm-6.lua bigrm-7.lua bigrm-8.lua bigrm-9.lua bigrm-10.lua bigrm-6.lua bigrm-7.lua bigrm-8.lua bigrm-9.lua bigrm-10.lua
bigrm-11.lua bogusmon.txt castle.lua cmdhelp data.base bigrm-11.lua bigrm-12.lua bogusmon.txt castle.lua cmdhelp
dungeon.lua earth.lua engrave.txt epitaph.txt fakewiz1.lua data.base dungeon.lua earth.lua engrave.txt epitaph.txt
fakewiz2.lua fire.lua hellfill.lua help hh fakewiz1.lua fakewiz2.lua fire.lua hellfill.lua help
history juiblex.lua keyhelp knox.lua license hh history juiblex.lua keyhelp knox.lua
medusa-1.lua medusa-2.lua medusa-3.lua medusa-4.lua minefill.lua license luahelper medusa-1.lua medusa-2.lua medusa-3.lua
minend-1.lua minend-2.lua minend-3.lua minetn-1.lua minetn-2.lua medusa-4.lua minefill.lua minend-1.lua minend-2.lua minend-3.lua
minetn-3.lua minetn-4.lua minetn-5.lua minetn-6.lua minetn-7.lua minetn-1.lua minetn-2.lua minetn-3.lua minetn-4.lua minetn-5.lua
nhcore.lua nhlib.lua opthelp optmenu oracle.lua minetn-6.lua minetn-7.lua nhcore.lua nhlib.lua opthelp
oracles.txt orcus.lua quest.lua rumors.fal rumors.tru optmenu oracle.lua oracles.txt orcus.lua quest.lua
sanctum.lua soko1-1.lua soko1-2.lua soko2-1.lua soko2-2.lua rumors.fal rumors.tru sanctum.lua soko1-1.lua soko1-2.lua
soko3-1.lua soko3-2.lua soko4-1.lua soko4-2.lua symbols soko2-1.lua soko2-2.lua soko3-1.lua soko3-2.lua soko4-1.lua
themerms.lua tower1.lua tower2.lua tower3.lua tribute soko4-2.lua symbols themerms.lua tower1.lua tower2.lua
tut-1.lua tut-2.lua usagehlp valley.lua water.lua tower3.lua tribute tut-1.lua tut-2.lua usagehlp
wizard1.lua wizard2.lua wizard3.lua wizhelp valley.lua water.lua wizard1.lua wizard2.lua wizard3.lua
wizhelp
doc: doc:
(files for all versions) (files for all versions)
+1 -1
View File
@@ -47,7 +47,7 @@
.ds f0 \*(vr .ds f0 \*(vr
.ds f1 \" empty .ds f1 \" empty
.\"DO NOT REMOVE NH_DATESUB .ds f2 Date(%B %-d, %Y) .\"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: .\" A note on some special characters:
.\" \(lq = left double quote .\" \(lq = left double quote
+1 -1
View File
@@ -48,7 +48,7 @@
\author{Original version - Eric S. Raymond\\ \author{Original version - Eric S. Raymond\\
(Edited and expanded for 3.7.0 by Mike Stephenson and others)} (Edited and expanded for 3.7.0 by Mike Stephenson and others)}
%DO NOT REMOVE NH_DATESUB \date{Date(%B %-d, %Y)} %DO NOT REMOVE NH_DATESUB \date{Date(%B %-d, %Y)}
\date{September 13, 2024} \date{November 16, 2024}
\maketitle \maketitle
+9 -9
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 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 files from which NetHack reads special level files and other read-only
information. Note that like tar the command and option specifiers are information. Note that like tar the command and option specifiers are
specified as a continuous string and are followed by any arguments specified as a continuous string and are followed by any arguments re-
required in the same order as the option specifiers. quired in the same order as the option specifiers.
This facility is optional and may be excluded during NetHack configura- This facility is optional and may be excluded during NetHack configura-
tion. tion.
@@ -55,16 +55,16 @@ SEE ALSO
nethack(6), tar(1) nethack(6), tar(1)
BUGS BUGS
Not a good tar emulation; - does not mean stdin or stdout. Should Not a good tar emulation; - does not mean stdin or stdout. Should in-
include an optional compression facility. Not all read-only files for 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 NetHack can be read out of an archive; examining the source is the only
way to know which files can be. way to know which files can be.
COPYRIGHT COPYRIGHT
This file is Copyright (C) Kenneth Lorber, 2022 for version This file is Copyright (C) Kenneth Lorber, DATE(%Y) for version keni-
NetHack-3.7:1.12. NetHack may be freely redistributed. See license gitset:1.13. NetHack may be freely redistributed. See license for de-
for details. tails.
NETHACK 8 February 2022 DLB(6) NETHACK DATE(1-d 1B 1Y) DLB(6)
+32 -32
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, -m Generate date.h and options file. It will read dat/gitinfo.txt,
only if it is present, to obtain githash= and gitbranch= 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 -p Generate pm.h
-q Generate the rumors file. -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. -1 Generate the epitaph file.
@@ -53,7 +53,7 @@ LONG COMMANDS
Show debugging output. Show debugging output.
--make [command] --make [command]
Execute a short command. Command is given without preceding Execute a short command. Command is given without preceding
dash. dash.
--input file --input file
@@ -61,67 +61,67 @@ LONG COMMANDS
is - standard input is read. is - standard input is read.
--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 the
file is - standard output is written. file is - standard output is written.
--svs [delimiter] --svs [delimiter]
Generate a version string to standard output without a trailing Generate a version string to standard output without a trailing
newline. If specified, the delimiter is used between each part newline. If specified, the delimiter is used between each part
of the version string. 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 TIONS section below for information on controlling the filtering
operation. operation.
--grep-showvars --grep-showvars
Show the name and value for each variable known to the grep Show the name and value for each variable known to the grep op-
option. tion.
--grep-trace --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). specified as well).
--grep-defined symbol --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). exit shell false (1).
--grep-define symbol --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. be known to makedefs.
--grep-undef symbol --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. already be known to makedefs.
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(6) configuration. This al-
allows certain changes such as embedding platform-specific documenta- lows certain changes such as embedding platform-specific documentation
tion into the master documentation files. into the master documentation files.
Rules: Rules:
- The default conditional state is printing enabled. - The default conditional state is printing enabled.
- Any line NOT starting with a caret (^) is either suppressed - Any line NOT starting with a caret (^) is either suppressed
or passed through unchanged depending on the current condi- or passed through unchanged depending on the current condi-
tional state. tional state.
- Any line starting with a caret is a control line; as in C, - 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- zero or more spaces may be embedded in the line almost any-
where (except immediately after the caret); however the where (except immediately after the caret); however the
caret must be in column 1. caret must be in column 1.
- Conditionals may be nested. - Conditionals may be nested.
- Makedefs will exit with an error code if any errors are - Makedefs will exit with an error code if any errors are de-
detected; processing will continue (if it can) to allow as tected; processing will continue (if it can) to allow as
many errors as possible to be detected. many errors as possible to be detected.
- Unknown identifiers are treated as both TRUE and as an - Unknown identifiers are treated as both TRUE and as an er-
error. Note that --undef or #undef in the NetHack(6) con- ror. Note that --undef or #undef in the NetHack(6) configu-
figuration are different from unknown. ration are different from unknown.
Control lines: Control lines:
@@ -143,9 +143,9 @@ AUTHOR
The NetHack Development Team The NetHack Development Team
COPYRIGHT COPYRIGHT
This file is Copyright (C) Kenneth Lorber, 2022 for version keni-crash- This file is Copyright (C) Kenneth Lorber, 2022 for version
web2:1.21. NetHack may be freely redistributed. See license for NetHack-3.7:1.22. NetHack may be freely redistributed. See license
details. for details.
+2 -2
View File
@@ -278,7 +278,7 @@ BUGS
Probably infinite. Probably infinite.
COPYRIGHT 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 NetHack-3.7:1.31. NetHack may be freely redistributed. See license
for details. for details.
@@ -286,4 +286,4 @@ COPYRIGHT
NETHACK 28 February 2024 NETHACK(6) NETHACK 21 February 2022 NETHACK(6)
+14 -14
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 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 bookkeeping number for the level. The file base.0 is used for game
identity, locking, and, when checkpointing, for the game state. Vari- identity, locking, and, when checkpointing, for the game state. Vari-
ous OSes use different strategies for constructing the base name. ous OSes use different strategies for constructing the base name. Mi-
Microcomputers use the character name, possibly truncated and modified crocomputers use the character name, possibly truncated and modified to
to be a legal filename on that system. Multi-user systems use the be a legal filename on that system. Multi-user systems use the (modi-
(modified) character name prefixed by a user number to avoid conflicts, fied) character name prefixed by a user number to avoid conflicts, or
or "xlock" if the number of concurrent players is being limited. It "xlock" if the number of concurrent players is being limited. It may
may be necessary to look in the playground to find the correct base be necessary to look in the playground to find the correct base name of
name of the interrupted game. recover will transform these level files the interrupted game. recover will transform these level files into a
into a save file of the same name as nethack would have used. save file of the same name as nethack would have used.
Since recover must be able to read and delete files from the playground Since recover must be able to read and delete files from the playground
and create files in the save directory, it has interesting interactions 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. some of the microcomputer ports install recover by default.
For a multi-user system, the game administrator may want to arrange for 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 all .0 files in the playground to be fed to recover when the host ma-
machine boots, and handle game crashes individually. If the user popu- chine boots, and handle game crashes individually. If the user popula-
lation is sufficiently trustworthy, recover can be installed with the tion is sufficiently trustworthy, recover can be installed with the
same permissions the nethack executable has. In either case, recover same permissions the nethack executable has. In either case, recover
is easily compiled from the distribution utility directory. is easily compiled from the distribution utility directory.
@@ -70,8 +70,8 @@ SEE ALSO
BUGS BUGS
recover makes no attempt to find out if a base name specifies a game in 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 progress. If multiple machines share a playground, this would be im-
impossible to determine. possible to determine.
recover should be taught to use the nethack playground locking mecha- recover should be taught to use the nethack playground locking mecha-
nism to avoid conflicts. nism to avoid conflicts.