diff --git a/Files b/Files index 995b17ff3..d9706ea8e 100644 --- a/Files +++ b/Files @@ -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 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-11.lua bogusmon.txt castle.lua cmdhelp data.base -dungeon.lua earth.lua engrave.txt epitaph.txt fakewiz1.lua -fakewiz2.lua fire.lua hellfill.lua help hh -history juiblex.lua keyhelp knox.lua license -medusa-1.lua medusa-2.lua medusa-3.lua medusa-4.lua minefill.lua -minend-1.lua minend-2.lua minend-3.lua minetn-1.lua minetn-2.lua -minetn-3.lua minetn-4.lua minetn-5.lua minetn-6.lua minetn-7.lua -nhcore.lua nhlib.lua opthelp optmenu oracle.lua -oracles.txt orcus.lua quest.lua rumors.fal rumors.tru -sanctum.lua soko1-1.lua soko1-2.lua soko2-1.lua soko2-2.lua -soko3-1.lua soko3-2.lua soko4-1.lua soko4-2.lua symbols -themerms.lua tower1.lua tower2.lua tower3.lua tribute -tut-1.lua tut-2.lua usagehlp valley.lua water.lua -wizard1.lua wizard2.lua wizard3.lua wizhelp +bigrm-11.lua bigrm-12.lua bogusmon.txt castle.lua cmdhelp +data.base dungeon.lua earth.lua engrave.txt epitaph.txt +fakewiz1.lua fakewiz2.lua fire.lua hellfill.lua help +hh history juiblex.lua keyhelp knox.lua +license luahelper medusa-1.lua medusa-2.lua medusa-3.lua +medusa-4.lua minefill.lua minend-1.lua minend-2.lua minend-3.lua +minetn-1.lua minetn-2.lua minetn-3.lua minetn-4.lua minetn-5.lua +minetn-6.lua minetn-7.lua nhcore.lua nhlib.lua opthelp +optmenu oracle.lua oracles.txt orcus.lua quest.lua +rumors.fal rumors.tru sanctum.lua soko1-1.lua soko1-2.lua +soko2-1.lua soko2-2.lua soko3-1.lua soko3-2.lua soko4-1.lua +soko4-2.lua symbols themerms.lua tower1.lua tower2.lua +tower3.lua tribute tut-1.lua tut-2.lua usagehlp +valley.lua water.lua wizard1.lua wizard2.lua wizard3.lua +wizhelp doc: (files for all versions) diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn index ebf6fd82d..7d5eabde2 100644 --- a/doc/Guidebook.mn +++ b/doc/Guidebook.mn @@ -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 diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex index 491477711..b6769704c 100644 --- a/doc/Guidebook.tex +++ b/doc/Guidebook.tex @@ -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 diff --git a/doc/dlb.txt b/doc/dlb.txt index f185c3b2a..cd037be37 100644 --- a/doc/dlb.txt +++ b/doc/dlb.txt @@ -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) diff --git a/doc/makedefs.txt b/doc/makedefs.txt index ad7ab4175..975a9cde5 100644 --- a/doc/makedefs.txt +++ b/doc/makedefs.txt @@ -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. diff --git a/doc/nethack.txt b/doc/nethack.txt index 9afe9924d..39f8d3bd9 100644 --- a/doc/nethack.txt +++ b/doc/nethack.txt @@ -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) diff --git a/doc/recover.txt b/doc/recover.txt index 1eacac0d7..b19d9cb43 100644 --- a/doc/recover.txt +++ b/doc/recover.txt @@ -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.