]> granicus.if.org Git - nethack/commitdiff
Guidebook.txt to July 21, 2021 current (retry)
authornhmall <nhmall@nethack.org>
Wed, 21 Jul 2021 18:58:06 +0000 (14:58 -0400)
committernhmall <nhmall@nethack.org>
Wed, 21 Jul 2021 18:58:06 +0000 (14:58 -0400)
doc/Guidebook.txt
sys/windows/Makefile.msc

index b325d6cde480405791b38c05c77058ad72c01464..521c9d69d89c957d629f9b83711039fdf6aa9603 100644 (file)
@@ -15,7 +15,7 @@
                          Original version - Eric S. Raymond
              (Edited and expanded for 3.7 by Mike Stephenson and others)
 
-                                   March 25, 2021
+                                    July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           you have seen on the current dungeon level; as you  explore  more
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                you have available for spell casting.  Again,  resting  will
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           scribe things that are impossible to represent visually.  If  you
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                to  hold  the  saved data is deleted.  In explore mode, once
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           (R)UNIX is a registered trademark of The Open Group.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                `>',   `|'   by  default).   Some  interfaces  also  support
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                that situation, moving (no count given) a  compatible  stack
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                Go down a staircase.  Default key is `>'.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                The `m' prefix forces use of a menu.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                key is `C-_'.  See also #travel.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                objects and monsters temporarily removed, making it possible
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                Show vision array.  Autocompletes.  Debug mode only.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           combination meta+shift+letter is needed.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           (whether locked or not) down by kicking it via  the  `^D'  (kick)
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           chosen from a few levels lower all the  way  to  the  top.   Trap
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           previously visited level, it will be loaded from its file on disk
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           any unpaid items which have been used up, along with  other  shop
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           fountain or an altar  or  various  other  things  doesn't  elicit
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           Beware!  You may suddenly come upon one in a  dark  place.   Some
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           Initially, your pet may even be better  at  killing  things  than
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           sense--perhaps it is invisible and has just  tapped  you  on  the
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           type of object so you will recognize it later.  You can also  use
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           gratuitously try to kill you.  You need weapons for  self-defense
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           `f' (fire), `Q' (quiver), `x' (exchange),  `X'  (twoweapon),  and
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           all of the items will travel in the same direction; if the  first
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           is considered secondary.  The most noticeable difference is after
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           shirt  under  suit,  helmet, gloves, boots, shield) to lower your
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           tempts  to use the wand will usually result in nothing happening.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           level,  or  if  you  have little skill with the appropriate spell
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           only the top item of the  pile  is  displayed.   The  hilite_pile
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           or tools, but doing so causes you to receive a luck penalty.   No
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                        and found a special item there.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             Boolean options toggle a setting  on  or  off,  while  compound
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             "Modifying NetHack Symbols" section.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             Allows looking at things on the screen by navigating the  mouse
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             lowing:    traditional,    combination,   full,   or   partial.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             matching menu items.  Default `:'.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             or more letters of the role (that is, by suffixing one of -A -B
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
                           mode;
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             simply  stringing them together (for example, "bk"), but in the
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             of  explore  mode  (also known as discovery mode) or debug mode
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             engaged  in multi-turn movement (running via shift+direction or
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             This  option may be used to select one of the named symbol sets
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             ridden with "map".
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           truncated.   Not  all  window  ports will adjust for all settings
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             If  NetHack  can, it should scroll the display when the hero or
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           brown,  blue,  magenta,  cyan,   orange,   brightgreen,   yellow,
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             specifies  that  any menu line with " blessed " contained in it
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           will  cause  the  hitpoints  field to display in the color red if
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             ally displayed depending upon your other option settings.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           program  as  a  message  handler", your NetHack has been compiled
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             bones file content in ascii text.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
             %D - current time, YYYYMMDDhhmmss format
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           It is initiated by starting the game  with  the  -D  command-line
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           Michael Allison ported NetHack 3.1 to Windows NT.
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
           Jessie   Collet,   Ken  Lorber,  Dean  Luick,  Pat  Rankin,  Mike
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
 
 
 
-          NetHack 3.7                                        March 25, 2021
+          NetHack 3.7                                         July 21, 2021
 
 
 
index 10f8691847fe3670ae96f2e78b7e4fa399717cc0..45c0fa8545b3de00b51ae56288f56aa33c9509ad 100644 (file)
@@ -10,6 +10,7 @@
 #       Visual Studio Compilers Tested:
 #            - Microsoft Visual Studio 2017 Community Edition
 #            - Microsoft Visual Studio 2019 Community Edition
+#            - Microsoft Visual Studio 2022 Community Edition Preview 2
 #
 #==============================================================================
 #   This is used for building two distinct executables of NetHack:
@@ -547,8 +548,10 @@ rc=Rc
 # Visual Studio we are using.  We set VSVER to 0000 to flag any version that
 # is too old or untested.
 #
+# Recently tested versions:
 #NMAKE version 1429300370 from latest VS 2019 (May 25, 2021 version 16.10.0)
 #NMAKE version 1429300400 from latest VS 2019 (July 20, 2021 version 16.10.4)
+#NMAKE version 1430304010 from latest VS 2022 preview 2 (July 2021)
 
 #!MESSAGE $(MAKEFLAGS)
 #!MESSAGE $(MAKEDIR)
@@ -559,6 +562,7 @@ MAKEVERSION=$(MAKEVERSION: =)
 #!MESSAGE $(_NMAKE_VER)
 #!MESSAGE $(MAKEVERSION)
 
+VSSPECIAL=
 VSNEWEST=2019
 !IF ($(MAKEVERSION) < 1000000000)
 VSVER=0000             #untested ancient version
@@ -574,13 +578,17 @@ VSVER=2015
 VSVER=2017
 !ELSEIF ($(MAKEVERSION) > 1416270311) && ($(MAKEVERSION) < 1429300401)
 VSVER=$(VSNEWEST)
+!ELSEIF ($(MAKEVERSION) > 1429300400) && ($(MAKEVERSION) < 1430304011)
+VSVER=2022
+VSNEWEST=2022
+VSSPECIAL=preview
 !ELSEIF ($(MAKEVERSION) > 1429300400)
 VSVER=2999              #untested future version
 !ENDIF
 
 !IF ($(VSVER) >= 2012)
 !IF ($(VSVER) <= $(VSNEWEST))
-!MESSAGE Autodetected Visual Studio $(VSVER)
+!MESSAGE Autodetected Visual Studio $(VSVER) $(VSSPECIAL)
 !ENDIF
 !ENDIF
 !IF ($(VSVER) == 2999)