OSDN Git Service

upgrade to 3.6.2
[jnethack/source.git] / doc / Guidebook.tex
index 2cbc606..1b32dab 100644 (file)
@@ -45,7 +45,7 @@
 %.au
 \author{Original version - Eric S. Raymond\\
 (Edited and expanded for 3.6 by Mike Stephenson and others)}
-\date{April 27, 2018}
+\date{May 7, 2019}
 
 \maketitle
 
@@ -196,7 +196,8 @@ and easy to overcome at first sight, an experienced Wizard is a deadly foe.
 \elist
 
 %.pg
-You may also choose the race of your character:
+You may also choose the race of your character (within limits; most
+roles have restrictions on which races are eligible for them):
 
 %.pg
 %
@@ -282,6 +283,7 @@ understand what {\it NetHack\/} is doing with the screen.  The {\it NetHack\/}
 screen replaces the ``You see \ldots'' descriptions of text adventure games.
 Figure 1 is a sample of what a {\it NetHack\/} screen might look like.
 The way the screen looks for you depends on your platform.
+%.BR 2
 
 \vbox{
 \begin{verbatim}
@@ -296,8 +298,8 @@ The way the screen looks for you depends on your platform.
 
 
 
-        Player the Rambler     St:12 Dx:7 Co:18 In:11 Wi:9 Ch:15  Neutral
-        Dlvl:1  $:0  HP:9(12) Pw:3(3) AC:10 Exp:1/19 T:257 Weak
+        Player the Rambler    St:12 Dx:7 Co:18 In:11 Wi:9 Ch:15 Neutral
+        Dlvl:1 $:0 HP:9(12) Pw:3(3) AC:10 Exp:1/19 T:257 Weak
 \end{verbatim}
 \begin{center}
 Figure 1
@@ -700,6 +702,8 @@ and go straight to checking inventory,
 or (for ``{\tt \#loot}'' to remove a saddle),
 skip containers and go straight to adjacent monsters. The prefix will
 make ``{\tt \#travel}'' command show a menu of interesting targets in sight.
+In debug mode (aka ``wizard mode''), the `{\tt m}' prefix may also be
+used with the ``{\tt \#teleport}'' and ``{\tt \#wizlevelport}'' commands.
 %.lp
 \item[\tb{F[yuhjklbn]}]
 Prefix:  fight a monster (even if you only guess one is there).
@@ -757,7 +761,7 @@ Panic button.  Quit the game.
 %.lp
 \item[\tb{d}]
 Drop something.\\
-{\tt d7a} --- drop seven items of object
+For example {\tt d7a} --- drop seven items of object
 {\it a}.
 %.lp
 \item[\tb{D}]
@@ -811,10 +815,12 @@ you hand-to-hand (but if you attack, you will rub it out); this is
 often useful to give yourself a breather.
 %.lp
 \item[\tb{f}]
-Fire one of the objects placed in your quiver (or quiver sack, or that you
-have at the ready).  You may select
-ammunition with a previous `{\tt Q}' command, or let the computer pick
-something appropriate if {\it autoquiver\/} is true.
+Fire (shoot or throw) one of the objects placed in your quiver (or
+quiver sack, or that you have at the ready).
+You may select ammunition with a previous `{\tt Q}' command, or let the
+computer pick something appropriate if {\it autoquiver\/} is true.\\
+%.lp ""
+See also `{\tt t}' (throw) for more general throwing and shooting.
 %.lp
 \item[\tb{i}]
 List your inventory (everything you're carrying).
@@ -852,13 +858,14 @@ are listed later in this Guidebook.  Options are usually set before the
 game rather than with the `{\tt O}' command; see the section on options below.
 %.lp
 \item[\tb{\^{}O}]
-Show overview or show dungeon layout\\
+Show overview.\\
 %.lp ""
-In normal play and in explore mode, a shortcut for the ``{\tt \#overview}''
-extended command to list interesting dungeon levels visited.\\
+Shortcut for the ``{\tt \#overview}'':
+list interesting dungeon levels visited.\\
 %.lp ""
-In debug mode, an extra command which lists the placement of all special
-levels.
+(Prior to 3.6.0, `{\tt \^{}O}' was a debug mode command which listed
+the placement of all special levels.
+Use ``{\tt \#wizwhere}'' to run that command.)
 %.lp
 \item[\tb{p}]
 Pay your shopping bill.
@@ -876,7 +883,8 @@ choices but will accept an accessory and attempt to put that on.)
 Repeat previous message.\\
 %.lp ""
 Subsequent {\tt \^{}P}'s repeat earlier messages.
-The behavior can be varied via the {\it msg\verb+_+window\/} option.
+For some interfaces, the behavior can be varied via the
+{\it msg\verb+_+window\/} option.
 %.lp
 \item[\tb{q}]
 Quaff (drink) something (potion, water, etc).
@@ -912,15 +920,38 @@ choices but will accept an accessory and attempt to remove it.)
 Redraw the screen.
 %.lp
 \item[\tb{s}]
-Search for secret doors and traps around you.  It usually takes several
-tries to find something.
+Search for secret doors and traps around you.
+It usually takes several tries to find something.\\
+%.lp ""
+Can also be used to figure out whether there is still a monster at
+an adjacent ``remembered, unseen monster'' marker.
 %.lp
 \item[\tb{S}]
-Save (and suspend) the game.  The game will be restored automatically the
-next time you play.
+Save the game (which suspends play and exits the program).
+The saved game will be restored automatically the next time you play
+using the same character name.\\
+%.lp ""
+In normal play, once a saved game is restored the file used to hold
+the saved data is deleted.
+In explore mode, once restoration is accomplished you are asked whether
+to keep or delete the file.
+Keeping the file makes it feasible to play for a while then quit
+without saving and later restore again.\\
+%.lp ""
+There is no ``save current game state and keep playing'' command, not
+even in explore mode where saved game files can be kept and re-used.
 %.lp
 \item[\tb{t}]
-Throw an object or shoot a projectile.
+Throw an object or shoot a projectile.\\
+%.lp ""
+There's no separate ``shoot'' command.
+If you ``throw'' an arrow while wielding a bow, you are shooting
+that arrow and any weapon skill bonus or penalty for bow applies.
+If you ``throw'' an arrow while not wielding a bow, you are throwing
+it by hand and it will generally be less effective than when shot.\\
+%.lp ""
+See also `{\tt f}' (fire) for throwing or shooting an item pre-selected
+via the `{\tt Q}' (quiver) command.
 %.lp
 \item[\tb{T}]
 Take off armor.\\
@@ -953,7 +984,7 @@ Display the game history.
 Wield weapon.\\
 %.sd
 %.si
-{\tt w-} --- wield nothing, use your bare hands.\\
+{\tt w-} --- wield nothing, use your bare (or gloved) hands.\\
 %.ei
 %.ed
 Some characters can wield two weapons at once; use the `{\tt X}' command
@@ -979,7 +1010,6 @@ the exchange still takes place.
 Toggle two-weapon combat, if your character can do it.  Also available
 via the ``{\tt \#twoweapon}'' extended command.\\
 %.lp ""
-
 (In versions prior to 3.6 this was the command to switch from normal
 play to ``explore mode'', also known as ``discovery mode'', which has now
 been moved to ``{\tt \#exploremode}''.)
@@ -992,7 +1022,11 @@ redundant, such as {\tt Caveman} or {\tt Priestess}), and alignment,
 along with your patron deity and his or her opposition.  It also
 shows most of the various items of information from the status line(s)
 in a less terse form, including several additional things which don't
-appear in the normal status display due to space considerations.
+appear in the normal status display due to space considerations.\\
+%.lp ""
+In normal play, that's all that `{\tt \^{}X}' displays.
+In explore mode, the role and status feedback is augmented by the
+information provided by {\it enlightenment\/} magic.
 %.lp
 \item[\tb{z}]
 Zap a wand.\\
@@ -1089,7 +1123,7 @@ the game was compiled with.
 \item[\tb{\#adjust}]
 Adjust inventory letters (most useful when the
 {\it fixinv\/}
-option is ``on''). Autocompletes. Default key is '{\tt M-a}'.\\
+option is ``on''). Autocompletes. Default key is `{\tt M-a}'.\\
 %.lp ""
 This command allows you to move an item from one particular inventory
 slot to another so that it has a letter which is more meaningful for you
@@ -1118,12 +1152,14 @@ deciding whether to merge with the destination stack.
 \item[\tb{\#annotate}]
 Allows you to specify one line of text to associate with the current
 dungeon level.  All levels with annotations are displayed by the
-``{\tt \#overview}'' command. Autocompletes. Default key is '{\tt M-A}',
-and '{\tt \^{}N}' if {\it number\verb+_+pad\/} is on.
+``{\tt \#overview}'' command. Autocompletes.
+Default key is `{\tt M-A}',
+and also `{\tt \^{}N}' if {\it number\verb+_+pad\/} is on.
 %.lp
 \item[\tb{\#apply}]
 Apply (use) a tool such as a pick-axe, a key, or a lamp.
-Default key is '{\tt a}'.\\
+Default key is `{\tt a}'.\\
+%.lp ""
 If the tool used acts on items on the floor, using the `{\tt m}' prefix
 skips those items.\\
 %.lp ""
@@ -1131,135 +1167,148 @@ If used on a wand, that wand will be broken, releasing its magic in the
 process.  Confirmation is required.
 %.lp
 \item[\tb{\#attributes}]
-Show your attributes. Default key is '{\tt \^{}X}'.\\
+Show your attributes. Default key is `{\tt \^{}X}'.
 %.lp
 \item[\tb{\#autopickup}]
-Toggle the {\it autopickup\/} -option. Default key is '{\tt @}'.\\
+Toggle the {\it autopickup\/} option. Default key is `{\tt @}'.
 %.lp
 \item[\tb{\#call}]
 Call (name) a monster, or an object in inventory, on the floor,
 or in the discoveries list, or add an annotation for the
-current level (same as ``{\tt \#annotate}''). Default key is '{\tt C}'.
+current level (same as ``{\tt \#annotate}''). Default key is `{\tt C}'.
 %.lp
 \item[\tb{\#cast}]
-Cast a spell. Default key is '{\tt Z}'.\\
+Cast a spell. Default key is `{\tt Z}'.
 %.lp
 \item[\tb{\#chat}]
-Talk to someone. Default key is '{\tt M-c}'.\\
+Talk to someone. Default key is `{\tt M-c}'.
 %.lp
 \item[\tb{\#close}]
-Close a door. Default key is '{\tt c}'.\\
+Close a door. Default key is `{\tt c}'.
 %.lp
 \item[\tb{\#conduct}]
 List voluntary challenges you have maintained. Autocompletes.
-Default key is '{\tt M-C}'.\\
+Default key is `{\tt M-C}'.\\
 %.lp ""
 See the section below entitled ``Conduct'' for details.
 %.lp
 \item[\tb{\#dip}]
-Dip an object into something. Autocompletes. Default key is '{\tt M-d}'.
+Dip an object into something. Autocompletes. Default key is `{\tt M-d}'.
 %.lp
 \item[\tb{\#down}]
-Go down a staircase. Default key is '{\tt >}'.
+Go down a staircase. Default key is `{\tt >}'.
 %.lp
 \item[\tb{\#drop}]
-Drop an item. Default key is '{\tt d}'.
+Drop an item. Default key is `{\tt d}'.
 %.lp
 \item[\tb{\#droptype}]
-Drop specific item types. Default key is '{\tt D}'.
+Drop specific item types. Default key is `{\tt D}'.
 %.lp
 \item[\tb{\#eat}]
-Eat something. Default key is '{\tt e}'.
+Eat something. Default key is `{\tt e}'.
 The `{\tt m}' prefix skips eating items on the floor.
 %.lp
 \item[\tb{\#engrave}]
-Engrave writing on the floor. Default key is '{\tt E}'.
+Engrave writing on the floor. Default key is `{\tt E}'.
 %.lp
 \item[\tb{\#enhance}]
 Advance or check weapon and spell skills. Autocompletes.
-Default key is '{\tt M-e}'.
+Default key is `{\tt M-e}'.
 %.lp
 \item[\tb{\#exploremode}]
 Enter the explore mode.
 %.lp
 \item[\tb{\#fire}]
-Fire ammunition from quiver. Default key is '{\tt f}'.
+Fire ammunition from quiver. Default key is `{\tt f}'.
 %.lp
 \item[\tb{\#force}]
-Force a lock. Autocompletes. Default key is '{\tt M-f}'.
+Force a lock. Autocompletes. Default key is `{\tt M-f}'.
 %.lp
 \item[\tb{\#glance}]
-Show what type of thing a map symbol corresponds to. Default key is '{\tt ;}'.
+Show what type of thing a map symbol corresponds to. Default key is `{\tt ;}'.
 %.lp
 \item[\tb{\#help}]
-Show the help menu. Default key is '{\tt ?}', and '{\tt h}' if {\it number\verb+_+pad\/} is on.
+Show the help menu.
+Default key is `{\tt ?}',
+and also `{\tt h}' if {\it number\verb+_+pad\/} is on.
 %.lp
 \item[\tb{\#herecmdmenu}]
 Show a menu of possible actions in your current location.
 %.lp
 \item[\tb{\#history}]
-Show long version and game history. Default key is '{\tt V}'.
+Show long version and game history. Default key is `{\tt V}'.
 %.lp
 \item[\tb{\#inventory}]
-Show your inventory. Default key is '{\tt i}'.
+Show your inventory. Default key is `{\tt i}'.
 %.lp
 \item[\tb{\#inventtype}]
-Inventory specific item types. Default key is '{\tt I}'.
+Inventory specific item types. Default key is `{\tt I}'.
 %.lp
 \item[\tb{\#invoke}]
-Invoke an object's special powers. Autocompletes. Default key is '{\tt M-i}'.
+Invoke an object's special powers. Autocompletes. Default key is `{\tt M-i}'.
 %.lp
 \item[\tb{\#jump}]
-Jump to another location. Autocompletes. Default key is '{\tt M-j}', and '{\tt j}' if {\it number\verb+_+pad\/} is on.
+Jump to another location. Autocompletes.
+Default key is `{\tt M-j}',
+and also `{\tt j}' if {\it number\verb+_+pad\/} is on.
 %.lp
 \item[\tb{\#kick}]
-Kick something. Default key is '{\tt \^{}D}', and '{\tt k}' if {\it number\verb+_+pad\/} is on.
+Kick something.
+Default key is `{\tt \^{}D}',
+and also `{\tt k}' if {\it number\verb+_+pad\/} is on.
 %.lp
 \item[\tb{\#known}]
-Show what object types have been discovered. Default key is '{\tt $\backslash$}'.
+Show what object types have been discovered.
+Default key is `{\tt $\backslash$}'.
 %.lp
 \item[\tb{\#knownclass}]
-Show discovered types for one class of objects. Default key is '{\tt `}'.
+Show discovered types for one class of objects.
+Default key is `{\tt `}'.
 %.lp
 \item[\tb{\#levelchange}]
-Change your experience level. Autocompletes. Wizard-mode only.
+Change your experience level.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#lightsources}]
-Show mobile light sources. Autocompletes. Wizard-mode only.
+Show mobile light sources.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#look}]
-Look at what is here, under you. Default key is '{\tt :}'.
+Look at what is here, under you. Default key is `{\tt :}'.
 %.lp
 \item[\tb{\#loot}]
 Loot a box or bag on the floor beneath you, or the saddle
 from a steed standing next to you. Autocompletes.
-Default key is '{\tt M-l}', and '{\tt l}' if {\it number\verb+_+pad\/} is on.
+Default key is `{\tt M-l}',
+and also `{\tt l}' if {\it number\verb+_+pad\/} is on.
 Precede with the `{\tt m}' prefix to skip containers at your location
 and go directly to removing a saddle.
 %.lp
-\item[\tb{\#monpolycontrol}]
-Control monster polymorphs. Autocompletes. Wizard-mode only.
-%.lp
 \item[\tb{\#monster}]
 Use a monster's special ability (when polymorphed into monster form).
-Autocompletes. Default key is '{\tt M-m}'.
+Autocompletes. Default key is `{\tt M-m}'.
 %.lp
 \item[\tb{\#name}]
-Name a monster, an individual object, or a type of object.  Same as `{\tt \#call}'.
-Autocompletes. Default keys are '{\tt N}', '{\tt M-n}', and '{\tt M-N}'.
+Name a monster, an individual object, or a type of object.
+Same as ``{\tt \#call}''.
+Autocompletes.
+Default keys are `{\tt N}', `{\tt M-n}', and `{\tt M-N}'.
 %.lp
 \item[\tb{\#offer}]
-Offer a sacrifice to the gods. Autocompletes. Default key is '{\tt M-o}'.\\
-The `{\tt m}' prefix skips offering items on the altar.
+Offer a sacrifice to the gods. Autocompletes. Default key is `{\tt M-o}'.\\
 %.lp ""
 You'll need to find an altar to have any chance at success.
 Corpses of recently killed monsters are the fodder of choice.
+%.lp ""
+The `{\tt m}' prefix skips offering any items which are on the altar.\\
 %.lp
 \item[\tb{\#open}]
-Open a door. Default key is '{\tt o}'.
+Open a door. Default key is `{\tt o}'.
 %.lp
 \item[\tb{\#options}]
-Show and change option settings. Default key is '{\tt O}'.
+Show and change option settings. Default key is `{\tt O}'.
 %.lp
 \item[\tb{\#overview}]
 Display information you've discovered about the dungeon.  Any visited
@@ -1268,23 +1317,29 @@ and many things (altars, thrones, fountains, and so on; extra stairs
 leading to another dungeon branch) trigger an automatic annotation.
 If dungeon overview is chosen during end-of-game disclosure, every visited
 level will be included regardless of annotations. Autocompletes.
-Default keys are '{\tt \^{}O}', and '{\tt M-O}'.
+Default keys are `{\tt \^{}O}', and `{\tt M-O}'.
 %.lp
+% DON'T PANIC!
 \item[\tb{\#panic}]
-Test the panic routine. Autocompletes. Wizard-mode only.
+Test the panic routine.
+Terminates the current game.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#pay}]
-Pay your shopping bill. Default key is '{\tt p}'.
+Pay your shopping bill. Default key is `{\tt p}'.
 %.lp
 \item[\tb{\#pickup}]
-Pick up things at the current location. Default key is '{\tt ,}'.
+Pick up things at the current location. Default key is `{\tt ,}'.
 The `{\tt m}' prefix forces use of a menu.
 %.lp
 \item[\tb{\#polyself}]
-Polymorph self. Autocompletes. Wizard-mode only.
+Polymorph self.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#pray}]
-Pray to the gods for help. Autocompletes. Default key is '{\tt M-p}'.\\
+Pray to the gods for help. Autocompletes. Default key is `{\tt M-p}'.\\
 %.lp ""
 Praying too soon after receiving prior help is a bad idea.
 (Hint: entering the dungeon alive is treated as having received help.
@@ -1296,17 +1351,17 @@ by default, and you can reset the
 option to disable it.
 %.lp
 \item[\tb{\#prevmsg}]
-Show previously displayed game messages. Default key is '{\tt \^{}P}'.
+Show previously displayed game messages. Default key is `{\tt \^{}P}'.
 %.lp
 \item[\tb{\#puton}]
-Put on an accessory (ring, amulet, etc). Default key is '{\tt P}'.
+Put on an accessory (ring, amulet, etc). Default key is `{\tt P}'.
 %.lp
 \item[\tb{\#quaff}]
-Quaff (drink) something. Default key is '{\tt q}'.
+Quaff (drink) something. Default key is `{\tt q}'.
 %.lp
 \item[\tb{\#quit}]
 Quit the program without saving your game. Autocompletes.
-Default key is '{\tt M-q}'.
+Default key is `{\tt M-q}'.
 %.lp ""
 Since using this command by accident would throw away the current game,
 you are asked to confirm your intent before quitting.  By default a
@@ -1315,83 +1370,90 @@ response of `{\tt y}' acknowledges that intent.  You can set the
 option to require a response of ``{\tt yes}'' instead.
 %.lp
 \item[\tb{\#quiver}]
-Select ammunition for quiver. Default key is '{\tt Q}'.
+Select ammunition for quiver. Default key is `{\tt Q}'.
 %.lp
 \item[\tb{\#read}]
-Read a scroll, a spellbook, or something else. Default key is '{\tt r}'.
+Read a scroll, a spellbook, or something else. Default key is `{\tt r}'.
 %.lp
 \item[\tb{\#redraw}]
-Redraw the screen. Default key is '{\tt \^{}R}', and '{\tt \^{}L}' if {\it number\verb+_+pad\/} is on.
+Redraw the screen.
+Default key is `{\tt \^{}R}',
+and also `{\tt \^{}L}' if {\it number\verb+_+pad\/} is on.
 %.lp
 \item[\tb{\#remove}]
-Remove an accessory (ring, amulet, etc). Default key is '{\tt R}'.
+Remove an accessory (ring, amulet, etc). Default key is `{\tt R}'.
 %.lp
 \item[\tb{\#ride}]
 Ride (or stop riding) a saddled creature. Autocompletes.
-Default key is '{\tt M-R}'.
+Default key is `{\tt M-R}'.
 %.lp
 \item[\tb{\#rub}]
-Rub a lamp or a stone. Autocompletes. Default key is '{\tt M-r}'.
+Rub a lamp or a stone. Autocompletes. Default key is `{\tt M-r}'.
 %.lp
 \item[\tb{\#save}]
-Save the game. Default key is '{\tt S}'.
+Save the game and exit the program.
+Default key is `{\tt S}'.
 %.lp
 \item[\tb{\#search}]
-Search for traps and secret doors around you. Default key is '{\tt s}'.
+Search for traps and secret doors around you. Default key is `{\tt s}'.
 %.lp
 \item[\tb{\#seeall}]
-Show all equipment in use. Default key is '{\tt *}'.
+Show all equipment in use. Default key is `{\tt *}'.
 %.lp
 \item[\tb{\#seeamulet}]
-Show the amulet currently worn. Default key is '{\tt "}'.
+Show the amulet currently worn. Default key is `{\tt "}'.
 %.lp
 \item[\tb{\#seearmor}]
-Show the armor currently worn. Default key is '{\tt [}'.
+Show the armor currently worn. Default key is `{\tt [}'.
 %.lp
 \item[\tb{\#seegold}]
-Count your gold. Default key is '{\tt \$}'.
+Count your gold. Default key is `{\tt \$}'.
 %.lp
 \item[\tb{\#seenv}]
-Show seen vectors. Autocompletes. Wizard-mode only.
+Show seen vectors.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#seerings}]
-Show the ring(s) currently worn. Default key is '{\tt =}'.
+Show the ring(s) currently worn. Default key is `{\tt =}'.
 %.lp
 \item[\tb{\#seespells}]
-List and reorder known spells. Default key is '{\tt +}'.
+List and reorder known spells. Default key is `{\tt +}'.
 %.lp
 \item[\tb{\#seetools}]
-Show the tools currently in use. Default key is '{\tt (}'.
+Show the tools currently in use. Default key is `{\tt (}'.
 %.lp
 \item[\tb{\#seetrap}]
-Show the type of an adjacent trap. Default key is '{\tt \^{}}'.
+Show the type of an adjacent trap. Default key is `{\tt \^{}}'.
 %.lp
 \item[\tb{\#seeweapon}]
-Show the weapon currently wielded. Default key is '{\tt )}'.
+Show the weapon currently wielded. Default key is `{\tt )}'.
 %.lp
 \item[\tb{\#shell}]
-Do a shell escape. Default key is '{\tt !}'.
+Do a shell escape. Default key is `{\tt !}'.
 %.lp
 \item[\tb{\#sit}]
-Sit down. Autocompletes. Default key is '{\tt M-s}'.
+Sit down. Autocompletes. Default key is `{\tt M-s}'.
 %.lp
 \item[\tb{\#stats}]
-Show memory statistics. Autocompletes. Wizard-mode only.
+Show memory usage statistics.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#suspend}]
-Suspend the game. Default key is '{\tt \^{}Z}'.
+Suspend the game. Default key is `{\tt \^{}Z}'.
 %.lp
 \item[\tb{\#swap}]
-Swap wielded and secondary weapons. Default key is '{\tt x}'.
+Swap wielded and secondary weapons. Default key is `{\tt x}'.
 %.lp
 \item[\tb{\#takeoff}]
-Take off one piece of armor. Default key is '{\tt T}'.
+Take off one piece of armor. Default key is `{\tt T}'.
 %.lp
 \item[\tb{\#takeoffall}]
-Remove all armor. Default key is '{\tt A}'.
+Remove all armor. Default key is `{\tt A}'.
 %.lp
 \item[\tb{\#teleport}]
-Teleport around the level. Default key is '{\tt \^{}T}'.
+Teleport around the level. Default key is `{\tt \^{}T}'.
 %.lp
 \item[\tb{\#terrain}]
 Show bare map without displaying monsters, objects, or traps.
@@ -1401,115 +1463,155 @@ Autocompletes.
 Show a menu of possible actions in a location next to you.
 %.lp
 \item[\tb{\#throw}]
-Throw something. Default key is '{\tt t}'.
+Throw something. Default key is `{\tt t}'.
 %.lp
 \item[\tb{\#timeout}]
-Look at the timeout queue. Autocompletes. Wizard-mode only.
+Look at the timeout queue.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#tip}]
 Tip over a container (bag or box) to pour out its contents.
-Autocompletes. Default key is '{\tt M-T}'.
+Autocompletes. Default key is `{\tt M-T}'.
 The `{\tt m}' prefix makes the command use a menu.
 %.lp
 \item[\tb{\#travel}]
-Travel to a specific location on the map. Default key is '{\tt _}'.
+Travel to a specific location on the map.
+Default key is `{\tt \verb+_+}'.
 Using the ``request menu'' prefix shows a menu of interesting targets in sight
-without asking to move the cursor. When picking a target with cursor and
-the {\it autodescribe\/}-option is on, the top line will show "(no travel path)" if
+without asking to move the cursor.
+When picking a target with cursor and the {\it autodescribe\/}
+option is on, the top line will show ``(no travel path)'' if
 your character does not know of a path to that location.
 %.lp
 \item[\tb{\#turn}]
-Turn undead away. Autocompletes. Default key is '{\tt M-t}'.
+Turn undead away. Autocompletes. Default key is `{\tt M-t}'.
 %.lp
 \item[\tb{\#twoweapon}]
-Toggle two-weapon combat on or off. Autocompletes. Default keys are '{\tt X}',
-and '{\tt M-2}'.
+Toggle two-weapon combat on or off. Autocompletes.
+Default key is `{\tt X}',
+and also `{\tt M-2}' if {\it number\verb+_+pad\/} is off.\\
 %.lp ""
 Note that you must
 use suitable weapons for this type of combat, or it will
 be automatically turned off.
 %.lp
 \item[\tb{\#untrap}]
-Untrap something (trap, door, or chest). Default key is '{\tt M-u}', and '{\tt u}' if {\it number\verb+_+pad\/} is on.
+Untrap something (trap, door, or chest).
+Default key is `{\tt M-u}', and `{\tt u}' if {\it number\verb+_+pad\/} is on.\\
 %.lp ""
-In some circumstancs it can also be used to rescue trapped monsters.
+In some circumstances it can also be used to rescue trapped monsters.
 %.lp
 \item[\tb{\#up}]
-Go up a staircase. Default key is '{\tt <}'.
+Go up a staircase. Default key is `{\tt <}'.
 %.lp
 \item[\tb{\#vanquished}]
-List vanquished monsters. Autocompletes. Wizard-mode only.
+List vanquished monsters.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#version}]
 Print compile time options for this version of {\it NetHack\/}.
-Autocompletes. Default key is '{\tt M-v}'.
+Autocompletes. Default key is `{\tt M-v}'.
 %.lp
 \item[\tb{\#versionshort}]
-Show version string. Default key is '{\tt v}'.
+Show version string. Default key is `{\tt v}'.
 %.lp
 \item[\tb{\#vision}]
-Show vision array. Autocompletes. Wizard-mode only.
+Show vision array.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#wait}]
-Rest one move while doing nothing. Default key is '{\tt .}', and '{\tt{ }}' if {\it rest\verb+_+on\verb+_+space\/} is on.
+Rest one move while doing nothing.
+Default key is `{\tt .}', and also `{\tt{ }}' if
+{\it rest\verb+_+on\verb+_+space\/} is on.
 %.lp
 \item[\tb{\#wear}]
-Wear a piece of armor. Default key is '{\tt W}'.
+Wear a piece of armor. Default key is `{\tt W}'.
 %.lp
 \item[\tb{\#whatdoes}]
-Tell what a key does. Default key is '{\tt \&}'.
+Tell what a key does. Default key is `{\tt \&}'.
 %.lp
 \item[\tb{\#whatis}]
-Show what type of thing a symbol corresponds to. Default key is '{\tt /}'.
+Show what type of thing a symbol corresponds to. Default key is `{\tt /}'.
 %.lp
 \item[\tb{\#wield}]
-Wield a weapon. Default key is '{\tt w}'.
+Wield a weapon. Default key is `{\tt w}'.
 %.lp
 \item[\tb{\#wipe}]
-Wipe off your face. Autocompletes. Default key is '{\tt M-w}'.
-%.lp
-\item[\tb{\#wizdebug\verb+_+bury}]
-Bury objects under and around you. Autocompletes. Wizard-mode only.
+Wipe off your face. Autocompletes. Default key is `{\tt M-w}'.
 %.lp
-\item[\tb{\#wizdebug\verb+_+traveldisplay}]
-Toggle travel display. Autocompletes. Wizard-mode only.
+\item[\tb{\#wizbury}]
+Bury objects under and around you.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#wizdetect}]
-Search a room. Autocompletes. Wizard-mode only. Default key is '{\tt \^{}E}'.
+Search for hidden things (secret doors or traps or unseen monsters)
+within a modest radius.
+Autocompletes.
+Debug mode only.
+Default key is `{\tt \^{}E}'.
 %.lp
 \item[\tb{\#wizgenesis}]
-Create a monster. Autocompletes. Wizard-mode only. Default key is '{\tt \^{}G}'.
+Create a monster.
+May be prefixed by a count to create more than one.
+Autocompletes.
+Debug mode only.
+Default key is `{\tt \^{}G}'.
 %.lp
 \item[\tb{\#wizidentify}]
-Identify all items in inventory. Autocompletes. Wizard-mode only.
-Default key is '{\tt \^{}I}'.
+Identify all items in inventory.
+Autocompletes.
+Debug mode only.
+Default key is `{\tt \^{}I}'.
 %.lp
 \item[\tb{\#wizintrinsic}]
-Set intrinsic. Autocompletes. Wizard-mode only.
+Set one or more intrinsic attributes.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#wizlevelport}]
-Teleport to another level. Autocompletes. Wizard-mode only. Default key is '{\tt \^{}V}'.
+Teleport to another level.
+Autocompletes.
+Debug mode only.
+Default key is `{\tt \^{}V}'.
 %.lp
 \item[\tb{\#wizmap}]
-Map the level. Autocompletes. Wizard-mode only. Default key is '{\tt \^{}F}'.
+Map the level.
+Autocompletes.
+Debug mode only.
+Default key is `{\tt \^{}F}'.
 %.lp
 \item[\tb{\#wizrumorcheck}]
-Verify rumor boundaries. Autocompletes. Wizard-mode only.
+Verify rumor boundaries.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#wizsmell}]
-Smell monster. Autocompletes. Wizard-mode only.
+Smell monster.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#wizwhere}]
-Show locations of special levels. Autocompletes. Wizard-mode only.
+Show locations of special levels.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#wizwish}]
-Wish for something. Autocompletes. Wizard-mode only. Default key is '{\tt \^{}W}'.
+Wish for something.
+Autocompletes.
+Debug mode only.
+Default key is `{\tt \^{}W}'.
 %.lp
 \item[\tb{\#wmode}]
-Show wall modes. Autocompletes. Wizard-mode only.
+Show wall modes.
+Autocompletes.
+Debug mode only.
 %.lp
 \item[\tb{\#zap}]
-Zap a wand. Default key is '{\tt z}'.
+Zap a wand. Default key is `{\tt z}'.
 %.lp
 \item[\tb{\#?}]
 Help menu:  get the list of available extended commands.
@@ -1522,7 +1624,7 @@ bit), you can invoke many extended commands by meta-ing the first
 letter of the command.
 In {\it NT, OS/2, PC\/ {\rm and} ST NetHack},
 the `Alt' key can be used in this fashion;
-on the {\it Amiga\/}, set the {\it altmeta\/} option to get this behavior.
+on the {\it Amiga}, set the {\it altmeta\/} option to get this behavior.
 On other systems, if typing `Alt' plus another key transmits a
 two character sequence consisting of an {\tt Escape}
 followed by the other key, you may set the {\it altmeta\/}
@@ -1666,7 +1768,7 @@ not restricted in this fashion.
 
 %.pg
 Doors can be useful for shutting out monsters.  Most monsters cannot
-open doors, although a few don't need to (ex.\ ghosts can walk through
+open doors, although a few don't need to (for example, ghosts can walk through
 doors).
 
 %.pg
@@ -1771,7 +1873,7 @@ The {\tt Ix} command shows an inventory-like display of any unpaid
 items which have been used up, along with other shop fees, if any.
 
 %.hn 3
-\subsubsection*{Shop idiosyncracies}
+\subsubsection*{Shop idiosyncrasies}
 
 %.pg
 Several aspects of shop behavior might be unexpected.
@@ -1791,7 +1893,7 @@ While the shopkeeper watches you like a hawk, he will generally ignore
 any other customers.
 %.lp \(bu 2
 \item[$\bullet$]
-If a shop is ``closed for inventory'', it will not open of its own accord.
+If a shop is ``closed for inventory,'' it will not open of its own accord.
 %.lp \(bu 2
 \item[$\bullet$]
 Shops do not get restocked with new items, regardless of inventory depletion.
@@ -1852,13 +1954,15 @@ but want to try fighting anyway, you can use the `F' command.
 \subsection*{Your pet}
 
 %.pg
-You start the game with a little dog (`{\tt d}'), cat (`{\tt f}'),
+You start the game with a little dog (`{\tt d}'), kitten (`{\tt f}'),
 or pony (`{\tt u}'), which follows
-you about the dungeon and fights monsters with you.  Like you, your
-pet needs food to survive.  It usually feeds itself on fresh carrion
-and other meats.  If you're worried about it or want to train it, you
-can feed it, too, by throwing it food.  A properly trained pet can be
-very useful under certain circumstances.
+you about the dungeon and fights monsters with you.
+Like you, your pet needs food to survive.
+Dogs and cats usually feed themselves on fresh carrion and other meats;
+horses need vegetarian food which is harder to come by.
+If you're worried about your pet or want to train it, you
+can feed it, too, by throwing it food.
+A properly trained pet can be very useful under certain circumstances.
 
 %.pg
 Your pet also gains experience from killing monsters, and can grow
@@ -1940,7 +2044,7 @@ location ordinarily wouldn't be seen any more.
 
 %.pg
 When you find something in the dungeon, it is common to want to pick
-it up.  In {\it NetHack\/}, this is accomplished automatically by walking over
+it up.  In {\it NetHack}, this is accomplished automatically by walking over
 the object (unless you turn off the {\it autopickup\/}
 option (see below), or move with the `{\tt m}' prefix (see above)), or
 manually by using the `{\tt ,}' command.
@@ -1960,9 +2064,11 @@ will get slower and you'll burn calories faster, requiring food more frequently
 to cope with it.  Eventually, you'll be so overloaded that you'll either have
 to discard some of what you're carrying or collapse under its weight.
 %.pg
-{\it NetHack\/} will tell you how badly you have loaded yourself.  The symbols
-`Burdened', `Stressed', `Strained', `Overtaxed' and `Overloaded' are
-displayed on the bottom line display to indicate your condition.
+{\it NetHack\/} will tell you how badly you have loaded yourself.
+If you are encumbered, one of the conditions
+``{\it Burdened\/}'', ``{\it Stressed\/}'', ``{\it Strained\/}'',
+``{\it Overtaxed\/}'' or ``{\it Overloaded\/}'' will be
+shown on the bottom line status display.
 
 %.pg
 When you pick up an object, it is assigned an inventory letter.  Many
@@ -2036,10 +2142,12 @@ be displayed even when that can be deduced from other attributes.
 
 %.pg
 Given a chance, most monsters in the Mazes of Menace will gratuitously try to
-kill you.  You need weapons for self-defense (killing them first).  Without a
+kill you.
+You need weapons for self-defense (killing them first).
+Without a
 weapon, you do only 1--2 hit points of damage (plus bonuses, if any).
-Monk characters are an exception; they normally do much more damage with
-bare hands than they do with weapons.
+Monk characters are an exception; they normally do more damage with
+bare (or gloved) hands than they do with weapons.
 
 %.pg
 There are wielded weapons, like maces and swords, and thrown weapons,
@@ -2074,8 +2182,8 @@ weapon ready to use by setting things up with the `{\tt x}' command, which
 exchanges your primary (the one being wielded) and alternate weapons.
 And if you have proficiency in the ``two weapon combat'' skill, you
 may wield both weapons simultaneously as primary and secondary; use the
-`{\tt \#twoweapon}' extended command to engage or disengage that.  Only
-some types of characters (barbarians, for instance) have the necessary
+`{\tt X}' command to engage or disengage that.
+Only some types of characters (barbarians, for instance) have the necessary
 skill available.  Even with that skill, using two weapons at once incurs
 a penalty in the chance to hit your target compared to using just one
 weapon at a time.
@@ -2095,8 +2203,9 @@ in an appendix to {\it Unearthed Arcana}, an AD\&D supplement.
 
 %.pg
 The commands to use weapons are `{\tt w}' (wield), `{\tt t}' (throw),
-`{\tt f}' (fire, an alternative way of throwing), `{\tt Q}' (quiver),
-`{\tt x}' (exchange), `{\tt \#twoweapon}', and `{\tt \#enhance}' (see below).
+`{\tt f}' (fire, an alternate way of throwing), `{\tt Q}' (quiver),
+`{\tt x}' (exchange), `{\tt X}' (twoweapon), and ``{\tt \#enhance}''
+(see below).
 
 %.hn 3
 \subsection*{Throwing and shooting}
@@ -2163,13 +2272,15 @@ can achieve for each group.  For instance, wizards can become highly
 skilled in daggers or staves but not in swords or bows.
 
 %.pg
-The `{\tt \#enhance}' extended command is used to review current weapons proficiency
+The ``{\tt \#enhance}'' extended command is used to review current weapons
+proficiency
 (also spell proficiency) and to choose which skill(s) to improve when
 you've used one or more skills enough to become eligible to do so.  The
 skill rankings are ``none'' (sometimes also referred to as ``restricted'',
 because you won't be able to advance), ``unskilled'', ``basic'', ``skilled'',
 and ``expert''.  Restricted skills simply will not appear in the list
-shown by `{\tt \#enhance}'.  (Divine intervention might unrestrict a particular
+shown by ``{\tt \#enhance}''.
+(Divine intervention might unrestrict a particular
 skill, in which case it will start at unskilled and be limited to basic.)
 Some characters can enhance their barehanded combat or martial arts skill
 beyond expert to ``master'' or ``grand master''.
@@ -2184,7 +2295,8 @@ higher.  A successful hit has a chance to boost your training towards
 the next skill level (unless you've already reached the limit for this
 skill).  Once such training reaches the threshold for that next level,
 you'll be told that you feel more confident in your skills.  At that
-point you can use `{\tt \#enhance}' to increase one or more skills.  Such skills
+point you can use ``{\tt \#enhance}'' to increase one or more skills.
+Such skills
 are not increased automatically because there is a limit to your total
 overall skills, so you need to actively choose which skills to enhance
 and which to ignore.
@@ -2207,12 +2319,14 @@ as alternate weapon.)
 
 %.pg
 If your primary weapon is wielded but your off hand is empty or has
-the wrong weapon, use the sequence `{\tt x}', `{\tt w}', `{\tt x}' to first swap your
+the wrong weapon, use the sequence `{\tt x}', `{\tt w}', `{\tt x}' to
+first swap your
 primary into your off hand, wield whatever you want as secondary
 weapon, then swap them both back into the intended hands.
 If your secondary or alternate weapon is correct but your primary
 one is not, simply use `{\tt w}' to wield the primary.
-Lastly, if neither hand holds the correct weapon, use `{\tt w}', `{\tt x}', `{\tt w}'
+Lastly, if neither hand holds the correct weapon,
+use `{\tt w}', `{\tt x}', `{\tt w}'
 to first wield the intended secondary, swap it to off hand, and then
 wield the primary.
 
@@ -2226,8 +2340,9 @@ intend to be secondary, and then wield the one you want as primary
 which will push the first into secondary position.
 
 %.pg
-When in two-weapon combat mode, using the ``{\tt \#twoweapon}'' command
-toggles back to single-weapon mode.  Throwing or dropping either of the
+When in two-weapon combat mode, using the `{\tt X}' command
+toggles back to single-weapon mode.
+Throwing or dropping either of the
 weapons or having one of them be stolen or destroyed will also make you
 revert to single-weapon combat.
 
@@ -2259,7 +2374,7 @@ leather jacket         & 9 &                   & no armor              & 10\\
 \end{center}
 
 %.pg
-\nd You can also wear other pieces of armor (ex.\ helmets, boots,
+\nd You can also wear other pieces of armor (for example, helmets, boots,
 shields, cloaks)
 to lower your armor class even further, but you can only wear one item
 of each category (one suit of armor, one cloak, one helmet, one
@@ -2319,7 +2434,7 @@ The command to eat food is `{\tt e}'.
 
 %.pg
 Scrolls are labeled with various titles, probably chosen by ancient wizards
-for their amusement value (ex.\ ``READ ME,'' or ``THANX MAUD'' backwards).
+for their amusement value (for example, ``READ ME,'' or ``THANX MAUD'' backwards).
 Scrolls disappear after you read them (except for blank ones, without
 magic spells on them).
 
@@ -2461,7 +2576,7 @@ Other spells don't require any direction or target.
 Just as weapons are divided into groups in which a character can become
 proficient (to varying degrees), spells are similarly grouped.
 Successfully casting a spell exercises its skill group; using the
-`{\tt \#enhance}' command to advance a sufficiently exercised skill
+``{\tt \#enhance}'' command to advance a sufficiently exercised skill
 will affect all spells within the group.  Advanced skill may increase the
 potency of spells, reduce their risk of failure during casting attempts,
 and improve the accuracy of the estimate for how much longer they will
@@ -2570,13 +2685,14 @@ you are carrying (shopkeepers aside).
 
 %.pg
 Normally, if you have seen an object at a particular map location and
-move to another location which can't directly see that object any
+move to another location where you can't directly see that object any
 more, if will continue to be displayed on your map.
 That remains the case even if it is not actually there any more--
 perhaps a monster has picked it up or it has rotted away--
 until you can see or feel that location again.
 One notable exception is that if the object gets covered by the
-``remembered, unseen monster'' marker and that marker is later removed
+``remembered, unseen monster'' marker.
+When that marker is later removed
 after you've verified that no monster is there, you will forget that
 there was any object there regardless of whether the unseen monster
 actually took the object.
@@ -2588,7 +2704,7 @@ The situation is the same for a pile of objects, except that only the
 top item of the pile is displayed.
 The
 {\it hilite\verb+_+pile\/}
-option can be enabled in order to show an item differently when is
+option can be enabled in order to show an item differently when it is
 the top one of a pile.
 
 %.hn 1
@@ -2679,7 +2795,7 @@ fire, and kick weapons; use a wand, spell, or other type of item;
 or fight with your hands and feet.
 
 %.pg
-In {\it NetHack\/}, a pacifist refuses to cause the death of any other monster
+In {\it NetHack}, a pacifist refuses to cause the death of any other monster
 (i.e. if you would get experience for the death).  This is a particularly
 difficult challenge, although it is still possible to gain experience
 by other means.
@@ -2687,7 +2803,7 @@ by other means.
 %.pg
 An illiterate character cannot read or write.  This includes reading
 a scroll, spellbook, fortune cookie message, or t-shirt; writing a
-scroll; or making an engraving of anything other than a single ``x'' (the
+scroll; or making an engraving of anything other than a single ``X'' (the
 traditional signature of an illiterate person).  Reading an engraving,
 or any item that is absolutely necessary to win the game, is not counted
 against this conduct.  The identity of scrolls and spellbooks (and
@@ -2737,9 +2853,9 @@ for system administrators.
 
 %.pg
 The default name of the configuration file varies on different
-operating systems. On DOS and Windows, it is \mbox{``defaults.nh''}
-in the same folder as \mbox{{\it nethack.exe\/}} or \mbox{{\it nethackW.exe\/}}. 
-On Unix, Linux and Mac OS X it is \mbox{``.nethackrc''} in the user's home 
+operating systems. On MS-DOS and Windows, it is \mbox{``defaults.nh''} in
+the same folder as \mbox{{\it nethack.exe\/}} or \mbox{{\it nethackW.exe\/}}.
+On Unix, Linux and Mac OS X it is \mbox{``.nethackrc''} in the user's home
 directory. The file may not exist, but it is a normal ASCII text file and
 can be created with any text editor.
 
@@ -2770,7 +2886,8 @@ Prefix a boolean option with `no' or `!' to turn it off.
 For compound options, the option name and value are separated by a colon.
 Some options are persistent, and apply only to new games.
 You can specify multiple OPTIONS statements, and multiple options
-in a single OPTIONS statement.
+separated by commas in a single OPTIONS statement.
+(Comma separated options are processed from right to left.)
 
 %.pg
 Example:
@@ -2789,23 +2906,23 @@ so setting HACKDIR to override that is not usually necessary or recommended.
 %.lp
 \item[\bb{LEVELDIR}]
 The location that in-progress level files are stored. Defaults to HACKDIR,
-must be writeable.
+must be writable.
 %.lp
 \item[\bb{SAVEDIR}]
 The location where saved games are kept. Defaults to HACKDIR, must be
-writeable.
+writable.
 %.lp
 \item[\bb{BONESDIR}]
 The location that bones files are kept. Defaults to HACKDIR, must be
-writeable.
+writable.
 %.lp
 \item[\bb{LOCKDIR}]
 The location that file synchronization locks are stored. Defaults to
-HACKDIR, must be writeable.
+HACKDIR, must be writable.
 %.lp
 \item[\bb{TROUBLEDIR}]
 The location that a record of game aborts and self-diagnosed game problems
-is kept. Defaults to HACKDIR, must be writeable.
+is kept. Defaults to HACKDIR, must be writable.
 %.lp
 \item[\bb{AUTOCOMPLETE}]
 Enable or disable an extended command autocompletion.
@@ -2882,9 +2999,10 @@ Example:
 
 %.lp
 \item[\bb{WIZKIT}]
-Wizard-mode extra items, in a text file containing item names,
-one per line, up to a maximum of 128 lines. Each line is processed
-by the function that handles wishing.
+Debug mode only:  extra items to add to initial inventory.
+Value is the name of a text file containing a list of item names,
+one per line, up to a maximum of 128 lines.
+Each line is processed by the function that handles wishing.
 %.pg
 Example:
 %.sd
@@ -2908,7 +3026,7 @@ Here is a short example of config file contents:
     # Set your character's role, race, gender, and alignment.
     OPTIONS=role:Valkyrie, race:Human, gender:female, align:lawful
 
-    # Turn on autopickup, and set automatically picked up object types
+    # Turn on autopickup, set automatically picked up object types
     OPTIONS=autopickup,pickup_types:$"=/!?+
     # Show colored text if possible
     OPTIONS=color
@@ -2919,6 +3037,7 @@ Here is a short example of config file contents:
     OPTIONS=!splash_screen
 \end{verbatim}
 %.ed
+%.BR 2
 
 %.hn 2
 \subsection*{Using the NETHACKOPTIONS environment variable}
@@ -2934,29 +3053,45 @@ the option name, a colon or equals sign, and then the value of the string.
 The value is terminated by the next comma or the end of string.
 
 %.pg
-For example, to set up an environment variable so that {\it autoquiver\/}
-is on, {\it autopickup\/} is off, the {\it name\/} is set to ``Blue Meanie'',
-and the {\it fruit\/} is set to ``papaya'', you would enter the command
-%.sd
+For example, to set up an environment variable so that
+{\it color\/} is {\tt on},
+{\it legacy\/} is {\tt off},
+character {\it name\/} is set to ``{\tt Blue Meanie}'',
+and named {\it fruit\/} is set to ``{\tt lime}'',
+you would enter the command
+%.SD i
 \begin{verbatim}
-    setenv NETHACKOPTIONS "autoquiver,\!autopickup,name:Blue Meanie,fruit:papaya"
+    setenv NETHACKOPTIONS "color,\!leg,name:Blue Meanie,fruit:lime"
 \end{verbatim}
-%.ed
+%.ED
 
 \nd in {\it csh}
-(note the need to escape the ! since it's special to the shell), or
-%.sd
+(note the need to escape the `!' since it's special
+to that shell), or the pair of commands
+%.SD i
 \begin{verbatim}
-    NETHACKOPTIONS="autoquiver,!autopickup,name:Blue Meanie,fruit:papaya"
+    NETHACKOPTIONS="color,!leg,name:Blue Meanie,fruit:lime"
     export NETHACKOPTIONS
 \end{verbatim}
-%.ed
+%.ED
+
+\nd in {\it sh}, {\it ksh}, or {\it bash}.
 
-\nd in {\it sh\/} or {\it ksh}.
+%.pg
+The NETHACKOPTIONS value is effectively the same as a single OPTIONS
+statement in a configuration file.
+The ``OPTIONS='' prefix is implied and comma separated options are
+processed from right to left.
+Other types of configuration statements such as BIND or MSGTYPE are
+not allowed.
 
 %.pg
-NETHACKOPTIONS can also be set to the full name of a configuration file you
-want to use (possibly preceded by an `{\tt @}').
+Instead of a comma-separated list of options,
+NETHACKOPTIONS can be set to the full name of a configuration file you
+want to use.
+If that full name doesn't start with a slash, precede it with `{\tt @}'
+(at-sign) to let NetHack know that the rest is intended as a file name.
+If it does start with `{\tt /}', the at-sign is optional.
 
 %.hn 2
 \subsection*{Customization options}
@@ -2988,8 +3123,8 @@ Cannot be set with the `{\tt O}' command.  Persistent.
 %.lp
 \item[\ib{autodescribe}]
 Automatically describe the terrain under cursor when asked to get a location
-on the map.  The
-{\it whatis\verb+_+coord\/}
+on the map (default true).
+The {\it whatis\verb+_+coord\/}
 option controls whether the description includes map coordinates.
 %.lp
 \item[\ib{autodig}]
@@ -3005,32 +3140,33 @@ See ``{\it pickup\verb+_+types\/}'' to refine the behavior.
 %.lp
 \item[\ib{autoquiver}]
 This option controls what happens when you attempt the `f' (fire)
-command with an empty quiver (or quiver sack or have nothing at the ready).
+command when nothing is quivered or readied (default false).
 When true, the computer will fill
-your quiver or quiver sack or make ready some suitable weapon.  Note that it
-will not take
+your quiver or quiver sack or make ready some suitable weapon.
+Note that it will not take
 into account the blessed/cursed status, enchantment, damage, or
-quality of the weapon; you are free to manually fill your quiver or quiver sack
-or make ready
-with the `Q' command instead.  If no weapon is found or the option is
-false, the `t' (throw) command is executed instead.  Persistent.  (default false)
+quality of the weapon; you are free to manually fill your quiver
+or quiver sack or make ready
+with the `Q' command instead.
+If no weapon is found or the option is
+false, the `t' (throw) command is executed instead.  Persistent.
 %.lp
 \item[\ib{blind}]
-Start the character permanently blind.  Persistent. (default false)
+Start the character permanently blind (default false).  Persistent.
 %.lp
 \item[\ib{bones}]
-Allow saving and loading bones files.  Persistent.  (default true)
+Allow saving and loading bones files (default true).  Persistent.
 %.lp
 \item[\ib{boulder}]
 Set the character used to display boulders (default is the ``large rock''
 class symbol, `{\tt `}').
 %.lp
 \item[\ib{catname}]
-Name your starting cat (ex.\ ``{\tt catname:Morris}'').
+Name your starting cat (for example, ``{\tt catname:Morris}'').
 Cannot be set with the `{\tt O}' command.
 %.lp character
 \item[\ib{character}]
-Pick your type of character (ex.\ ``{\tt character:Monk}'');
+Pick your type of character (for example, ``{\tt character:Monk}'');
 synonym for ``{\it role\/}''.  See {\it role\/} for more details.
 %.lp
 \item[\ib{checkpoint}]
@@ -3059,7 +3195,7 @@ peaceable creatures (default on).  Persistent.
 %.lp
 %.lp
 \item[\ib{dark\verb+_+room}]
-Show out-of-sight areas of lit rooms (default off).  Persistent.
+Show out-of-sight areas of lit rooms (default on).  Persistent.
 \item[\ib{disclose}]
 Controls what information the program reveals when the game ends.
 Value is a space separated list of prompting/category pairs
@@ -3104,11 +3240,11 @@ Asking refers to picking one of the orderings from a menu.
 The `{\tt +}' disclose without prompting choice,
 or being prompted and answering `{\tt y}' rather than `{\tt a}',
 will default to showing monsters in the traditional order,
-from high level to low level.
+from high level to low level.\\
 .lp ""
 
 %.lp ""
-(ex.\ ``{\tt disclose:yi na +v -g o}'')
+(for example, ``{\tt disclose:yi na +v -g o}'')
 The example sets
 {\tt inventory} to {\it prompt\/} and default to {\it yes\/},
 {\tt attributes} to {\it prompt\/} and default to {\it no\/},
@@ -3124,14 +3260,19 @@ And the dungeon overview shows all levels you had visited but does not
 reveal things about them that you hadn't discovered.
 %.lp
 \item[\ib{dogname}]
-Name your starting dog (ex.\ ``{\tt dogname:Fang}'').
+Name your starting dog (for example, ``{\tt dogname:Fang}'').
 Cannot be set with the `{\tt O}' command.
 %.lp
 \item[\ib{extmenu}]
 Changes the extended commands interface to pop-up a menu of available commands.
 It is keystroke compatible with the traditional interface except that it does
-not require that you hit Enter.  It is implemented only by the tty port
-(default off), when the game has been compiled to support tty graphics.
+not require that you hit Enter.
+It is implemented for the tty interface (default off).
+.lp ""
+For the X11 interface, which always uses a menu for choosing an extended
+command, it controls whether the menu shows all available commands (on)
+or just the subset of commands which have traditionally been considered
+extended ones (off).
 %.lp
 \item[\ib{female}]
 An obsolete synonym for ``{\tt gender:female}''.  Cannot be set with the
@@ -3147,7 +3288,7 @@ Commands asking for an inventory item show a menu instead of
 a text query with possible menu letters. Default is off.
 %.lp
 \item[\ib{fruit}]
-Name a fruit after something you enjoy eating (ex.\ ``{\tt fruit:mango}'')
+Name a fruit after something you enjoy eating (for example, ``{\tt fruit:mango}'')
 (default ``{\tt slime mold}''). Basically a nostalgic whimsy that
 {\it NetHack\/} uses from time to time.  You should set this to something you
 find more appetizing than slime mold.  Apples, oranges, pears, bananas, and
@@ -3180,13 +3321,17 @@ might miss some interesting and/or important information.  Persistent.
 \item[\ib{herecmd\verb+_+menu}]
 When using a windowport that supports mouse and clicking on yourself or
 next to you, show a menu of possible actions for the location.
-Same as herecmdmenu and therecmdmenu commands.
+Same as ``{\tt \#herecmdmenu}'' and ``{\tt \#therecmdmenu}'' commands.
 %.lp
 \item[\ib{hilite\verb+_+pet}]
 Visually distinguish pets from similar animals (default off).
 The behavior of this option depends on the type of windowing you use.
 In text windowing, text highlighting or inverse video is often used;
 with tiles, generally displays a heart symbol near pets.
+%.lp ""
+With the curses interface, the {\it petattr\/}
+option controls how to highlight pets and setting it will turn the
+{\it hilite\verb+_+pet\/} option on or off as warranted.
 %.lp
 \item[\ib{hilite\verb+_+pile}]
 Visually distinguish piles of objects from individual objects (default off).
@@ -3196,7 +3341,7 @@ with tiles, generally displays a small plus-symbol beside the object
 on the top of the pile.
 %.lp
 \item[\ib{horsename}]
-Name your starting horse (ex.\ ``{\tt horsename:Trigger}'').
+Name your starting horse (for example, ``{\tt horsename:Trigger}'').
 Cannot be set with the `{\tt O}' command.
 %.lp
 \item[\ib{hitpointbar}]
@@ -3218,8 +3363,9 @@ Show corridor squares seen by night vision or a light source held by your
 character as lit (default off).  Persistent.
 %.lp
 \item[\ib{lootabc}]
-Use the old `{\tt a}', `{\tt b}', and `{\tt c}' keyboard shortcuts when
-looting, rather than the mnemonics `{\tt o}', `{\tt i}', and `{\tt b}' (default off).
+When using a menu to interact with a container,
+use the old `{\tt a}', `{\tt b}', and `{\tt c}' keyboard shortcuts
+rather than the mnemonics `{\tt o}', `{\tt i}', and `{\tt b}' (default off).
 Persistent.
 %.lp
 \item[\ib{mail}]
@@ -3310,14 +3456,43 @@ Default `.'.
 Menu character accelerator to select all items on this page of a menu.
 Implemented by the Amiga, Gem and tty ports.
 Default `,'.
+% %.lp
+% \item[\ib{menu\verb+_+tab\verb+_+sep}]
+% Format menu entries using TAB to separate columns (default off).
+% Only applicable to some menus, and only useful to some interfaces.
+% Debug mode only.
+%.lp
+\item[\ib{monpolycontrol}]
+Prompt for new form whenever any monster changes shape (default off).
+Debug mode only.
+%.lp
+\item[\ib{mouse\verb+_+support}]
+Allow use of the mouse for input and travel.
+Valid settings are:
+
+%.sd
+%.si
+{\tt 0} --- disabled\\
+{\tt 1} --- enabled and make OS adjustment to support mouse use in the game\\
+{\tt 2} --- enabled like {\tt 1}, but does not make any OS adjustments\\
+%.ei
+%.ed
+
+Omitting a value is the same as specifying {\tt 1}
+and negating
+{\it mouse\verb+_+support\/}
+is the same as specifying {\tt 0}.
 %.lp
 \item[\ib{msghistory}]
-The number of top line messages to save (and recall with `{\tt \^{}P}')
-(default 20). Cannot be set with the `{\tt O}' command.
+The number of top line messages to save (and be able to recall
+with `{\tt \^{}P}') (default 20).
+Cannot be set with the `{\tt O}' command.
 %.lp
 \item[\ib{msg\verb+_+window}]
 Allows you to change the way recalled messages are displayed.
-(It is currently implemented for tty only.) The possible values are:
+Currently it is only supported for tty (all four choices) and for curses
+(`{\tt f}' and `{\tt r}' choices, default `{\tt r}').
+The possible values are:
 
 %.sd
 %.si
@@ -3365,7 +3540,7 @@ Valid settings are:
 \numbox{1} --- move by numbers; digit `{\tt 5}' acts as `{\tt G}' movement prefix\\
 \numbox{2} --- like {\tt 1} but `{\tt 5}' works as `{\tt g}' prefix instead of as `{\tt G}'\\
 \numbox{3} --- by numbers using phone key layout; {\tt 123} above, {\tt 789} below\\
-\numbox{4} --- combines {\tt 3} with {\tt 2}; phone layout plus MSDOS compatibility\\
+\numbox{4} --- combines {\tt 3} with {\tt 2}; phone layout plus MS-DOS compatibility\\
 \numbox{-1} --- by letters but use `{\tt z}' to go northwest, `{\tt y}' to zap wands
 %.ei
 %.ed
@@ -3374,7 +3549,7 @@ For backward compatibility, omitting a value is the same as specifying {\tt 1}
 and negating
 {\it number\verb+_+pad\/}
 is the same as specifying {\tt 0}.
-(Settings {\tt 2} and {\tt 4} are for compatibility with MSDOS or old PC Hack;
+(Settings {\tt 2} and {\tt 4} are for compatibility with MS-DOS or old PC Hack;
 in addition to the different behavior for `{\tt 5}', `{\tt Alt-5}' acts as `{\tt G}'
 and `{\tt Alt-0}' acts as `{\tt I}'.
 Setting {\tt -1} is to accommodate some QWERTZ keyboards which have the
@@ -3441,7 +3616,39 @@ such as ``{\it par\-a\-noid\verb+_+con\-fir\-ma\-tion:attack~pray~Remove}''.
 \item[\ib{perm\verb+_+invent}]
 If true, always display your current inventory in a window.  This only
 makes sense for windowing system interfaces that implement this feature.
-Persistent.
+%.lp
+%.\" petattr is a wincap option but we'll document it here...
+\item[\ib{petattr}]
+Specifies one or more text highlighting attributes to use when showing
+pets on the map.
+Effectively a superset of the {\it hilite\verb+_+pet\/} boolean option.
+Curses interface only; value is one or more of the following letters.
+
+%.sd
+%.si
+{\tt n} --- Normal text (no highlighting)\\
+{\tt i} --- Inverse video (default)\\
+{\tt b} --- Bold text\\
+{\tt u} --- Underlined text\\
+{\tt k} --- blinKing text\\
+{\tt d} --- Dim text\\
+{\tt t} --- iTalic text\\
+{\tt l} --- Left line indicator\\
+{\tt r} --- Right line indicator\\
+%.ei
+%.ed
+
+Some of those choices might not work, particularly the final three,
+depending upon terminal hardware or terminal emulation software.
+
+%.lp ""
+Currently multiple highlight-style letters can be combined by simply
+stringing them together (for example, ``bk''), but in the future
+they might require being separated by plus signs (such as ``b\verb&+&k'',
+which works already).
+When using the `n' choice, it should be specified on its own,
+not in combination with any of the other letters.
+
 %.lp
 \item[\ib{pettype}]
 Specify the type of your initial pet, if you are playing a character class
@@ -3507,7 +3714,7 @@ Make the space bar a synonym for the `{\tt .}' (\#wait) command (default off).
 Persistent.
 %.lp
 \item[\ib{role}]
-Pick your type of character (ex.\ ``{\tt role:Samurai}'');
+Pick your type of character (for example, ``{\tt role:Samurai}'');
 synonym for ``{\it character\/}''.  See ``{\it name\/}'' for an alternate method
 of specifying your role.  Normally only the first letter of the
 value is examined; `r' is an exception with ``{\tt Rogue}'', {\tt Ranger}'',
@@ -3549,9 +3756,13 @@ depend upon the window port used or on the type of terminal.  Persistent.
 %.lp
 \item[\ib{safe\verb+_+pet}]
 Prevent you from (knowingly) attacking your pets (default on).  Persistent.
+%+.lp
+\item[\ib{sanity\verb+_+check}]
+Evaluate monsters, objects, and map prior to each turn (default off).
+Debug mode only.
 %.lp
 \item[\ib{scores}]
-Control what parts of the score list you are shown at the end (ex.\
+Control what parts of the score list you are shown at the end (for example,
 ``{\tt scores:5top scores/4around my score/own scores}'').  Only the first
 letter of each category (`{\tt t}', `{\tt a}' or `{\tt o}') is necessary.
 Persistent.
@@ -3609,7 +3820,7 @@ Allow updates to the status lines at the bottom of the screen (default true).
 \item[\ib{suppress\verb+_+alert}]
 This option may be set to a {\it NetHack\/} version level to suppress
 alert notification messages about feature changes for that
-and prior versions (ex.\ ``{\tt suppress\verb+_+alert:3.3.1}'')
+and prior versions (for example, ``{\tt suppress\verb+_+alert:3.3.1}'')
 %.lp
 \item[\ib{symset}]
 This option may be used to select one of the named symbol sets found within
@@ -3639,6 +3850,10 @@ the score list around after game end on a terminal or emulating window.
 Allow the travel command (default on).  Turning this option off will
 prevent the game from attempting unintended moves if you make inadvertent
 mouse clicks on the map window.  Persistent.
+% %.lp
+% \item[ib{travel\verb+_+debug}]
+% Display intended path during each step of travel (default off).
+% Debug mode only.
 %.lp
 \item[\ib{verbose}]
 Provide more commentary during the game (default on).  Persistent.
@@ -3647,7 +3862,7 @@ Provide more commentary during the game (default on).  Persistent.
 When using the `{\tt /}' or `{\tt ;}' commands to look around on the map with
 ``{\tt autodescribe}''
 on, display coordinates after the description.
-Also works in other situations where you are asked to pick a location.
+Also works in other situations where you are asked to pick a location.\\
 
 %.lp ""
 The possible settings are:
@@ -3673,7 +3888,7 @@ where the `{\it none\/}' setting is overridden with `{\it map}'.
 \item[\ib{whatis\verb+_+filter}]
 When getting a location on the map, and using the keys to cycle through
 next and previous targets, allows filtering the possible targets.
-(default none)
+(default none)\\
 %.lp ""
 The possible settings are:
 
@@ -3685,11 +3900,12 @@ The possible settings are:
 %.ei
 %.ed
 %.lp ""
-The area-filter tries to be slightly predictive - if you're standing on a doorway,
-it will consider the area on the side of the door you were last moving towards.
+The area-filter tries to be slightly predictive -- if you're standing
+on a doorway, it will consider the area on the side of the door you
+were last moving towards.\\
 %.lp ""
-Filtering can also be changed when getting a location with the ``getpos.filter''
-key.
+Filtering can also be changed when getting a location with
+the ``getpos.filter'' key.
 %.lp
 \item[\ib{whatis\verb+_+menu}]
 When getting a location on the map, and using a key to cycle through
@@ -3703,9 +3919,22 @@ move by skipping the same glyphs.
 (default off)
 %.lp
 \item[\ib{windowtype}]
-Select which windowing system to use, such as ``{\tt tty}'' or ``{\tt X11}''
-(default depends on version).
+When the program has been built to support multiple interfaces,
+select whichone to use, such as ``{\tt tty}'' or ``{\tt X11}''
+(default depends on build-time settings; use ``{\tt \#version}'' to check).
 Cannot be set with the `{\tt O}' command.
+
+%.lp ""
+When used, it should be the first option set since its value might
+enable or disable the availability of various other options.
+For multiple lines in a configuration file, that would be the first
+non-comment line.
+For a comma-separated list in NETHACKOPTIONS or an OPTIONS line in a
+configuration file, that would be the {\it rightmost\/} option in the list.
+%.lp
+\item[\ib{wizweight}]
+Augment object descriptions with their objects' weight (default off).
+Debug mode only.
 %.lp
 \item[\ib{zerocomp}]
 When writing out a save file, perform zero-comp compression of the
@@ -3786,15 +4015,17 @@ If {\it NetHack\/} can, it should use this size font for text windows.
 \item[\ib{fullscreen}]
 If {\it NetHack\/} can, it should try and display on the entire screen rather than in a window.
 %.lp
+\item[\ib{guicolor}]
+Use color text and/or highlighting attributes when displaying some
+non-map data (such as menu selector letters).
+Curses interface only; default is on.
+%.lp
 \item[\ib{large\verb+_+font}]
 If {\it NetHack\/} can, it should use a large font.
 %.lp
 \item[\ib{map\verb+_+mode}]
 If {\it NetHack\/} can, it should display the map in the manner specified.
 %.lp
-\item[\ib{mouse\verb+_+support}]
-Allow use of the mouse for input and travel.
-%.lp
 \item[\ib{player\verb+_+selection}]
 If {\it NetHack\/} can, it should pop up dialog boxes or use prompts for character selection.
 %.lp
@@ -3803,7 +4034,7 @@ If {\it NetHack\/} can, it should pop up dialog boxes for input.
 %.lp
 \item[\ib{preload\verb+_+tiles}]
 If {\it NetHack\/} can, it should preload tiles into memory.
-For example, in the protected mode MSDOS version, control whether tiles
+For example, in the protected mode MS-DOS version, control whether tiles
 get pre-loaded into RAM at the start of the game.  Doing so
 enhances performance of the tile graphics, but uses more memory. (default on).
 Cannot be set with the `{\tt O}' command.
@@ -3821,10 +4052,26 @@ If {\it NetHack\/} can, it should display a menu of existing saved games for the
 choose from at game startup, if it can. Not all ports support this option.
 %.lp
 \item[\ib{softkeyboard}]
-If {\it NetHack\/} can, it should display an onscreen keyboard.  Handhelds are most likely to support this option.
+If {\it NetHack\/} can, it should display an onscreen keyboard.
+Handhelds are most likely to support this option.
 %.lp
 \item[\ib{splash\verb+_+screen}]
-If {\it NetHack\/} can, it should display an opening splash screen when it starts up (default yes).
+If {\it NetHack\/} can, it should display an opening splash screen when
+it starts up (default yes).
+%.lp
+\item[\ib{statuslines}]
+Number of lines for traditional below-the-map status display.
+Acceptable values are 2 and 3 (default is 2).
+Curses and tty interfaces only.
+%.lp
+\item[\ib{term\verb+_+cols}\ \ {\it and}]"
+%.lp
+\item[\ib{term\verb+_+rows}]
+Curses interface only.
+Number of columns and rows to use for the display.
+Curses will attempt to resize to the values specified but will settle
+for smaller sizes if they are too big.
+Default is the current window size.
 %.lp
 \item[\ib{tiled\verb+_+map}]
 If {\it NetHack\/} can, it should display a tiled map if it can.
@@ -3848,9 +4095,49 @@ If {\it NetHack\/} can, it should display inverse when the game specifies it.
 If {\it NetHack\/} can, it should display this number of messages at a time
 in the message window.
 %.lp
+\item[\ib{windowborders}]
+Whether to draw boxes around the map, status area, message area, and
+persistent inventory window if enabled.
+Curses interface only.
+Acceptable values are
+
+%.sd
+%.si
+{\tt 0} --- off, never show borders\\
+{\tt 1} --- on, always show borders\\
+{\tt 2} --- auto, on display is at least
+(\verb&24+2&)x(\verb&80+2&)\ \ (default)\\
+%.ei
+%.ed
+
+%.lp "
+(The 26x82 size threshold for `2' refers to number of rows and
+columns of the display.
+A width of at least 110 columns (\verb&80+2+26+2&) is needed for
+{\it align_status\/}
+set to {tt left} or {\tt right}.)
+%.lp
 \item[\ib{windowcolors}]
 If {\it NetHack\/} can, it should display windows with the specified
-foreground/background colors if it can.
+foreground/background colors. Windows GUI only. The format is
+\begin{verbatim}
+    OPTION=windowcolors:wintype foreground/background
+\end{verbatim}
+
+%.pg
+where wintype is one of {\it menu}, {\it message}, {\it status}, or {\it text}, and
+foreground and background are colors, either a hexadecimal {\it \#rrggbb},
+one of the named colors ({\it black}, {\it red}, {\it green}, {\it brown},
+{\it blue}, {\it magenta}, {\it cyan}, {\it orange},
+{\it brightgreen}, {\it yellow}, {\it brightblue}, {\it brightmagenta},
+{\it brightcyan}, {\it white}, {\it trueblack}, {\it gray}, {\it purple},
+{\it silver}, {\it maroon}, {\it fuchsia}, {\it lime}, {\it olive},
+{\it navy}, {\it teal}, {\it aqua}), or one of Windows UI colors ({\it activeborder},
+{\it activecaption}, {\it appworkspace}, {\it background}, {\it btnface}, {\it btnshadow},
+{\it btntext}, {\it captiontext}, {\it graytext}, {\it greytext}, {\it highlight},
+{\it highlighttext}, {\it inactiveborder}, {\it inactivecaption}, {\it menu},
+{\it menutext}, {\it scrollbar}, {\it window}, {\it windowframe}, {\it windowtext}).
+
 %.lp
 \item[\ib{wraptext}]
 If {\it NetHack\/} can, it should wrap long lines of text if they don't fit
@@ -3955,7 +4242,8 @@ Cannot be set with the `{\tt O}' command.
 
 %.pg
 Regular expressions are normally POSIX extended regular expressions. It is
-possible to compile {\it NetHack\/} without regular expression support on a platform where
+possible to compile {\it NetHack\/} without regular expression support on
+a platform where
 there is no regular expression library. While this is not true of any modern
 platform, if your {\it NetHack\/} was built this way, patterns are instead glob
 patterns. This applies to Autopickup exceptions, Message types, Menu colors,
@@ -3976,7 +4264,7 @@ autopickup something.
 \blist{}
 %.lp
 \item[\ib{autopickup\verb+_+exception}]
-Sets an exception to the `{\it pickup\verb+_+types}' option.
+Sets an exception to the ``{\it pickup\verb+_+types}'' option.
 The {\it autopickup\verb+_+exception\/} option should be followed by a regular
 expression to be used as a pattern to match against the singular form of the
 description of an object at your location.
@@ -3991,7 +4279,7 @@ character in the pattern, specifically:
 %.ei
 %.ed
 
-A `never pickup' rule takes precedence over an `always pickup' rule if
+A ``never pickup'' rule takes precedence over an ``always pickup'' rule if
 both match.
 
 %.lp ""
@@ -4021,8 +4309,8 @@ autopickup.
 %.pg
 It is possible to change the default key bindings of some special commands,
 menu accelerator keys, and extended commands, by using BIND stanzas in the
-configuration file. Format is key, followed by the command to bind to, separated
-by a colon. The key can be a single character (``{\tt x}''),
+configuration file. Format is key, followed by the command to bind to,
+separated by a colon. The key can be a single character (``{\tt x}''),
 a control key (``{\tt \^{}X}'', ``{\tt C-x}''), a meta key (``{\tt M-x}''),
 or a three-digit decimal ASCII code.
 
@@ -4050,7 +4338,7 @@ in the config file. You cannot bind object symbols into menu accelerators.
 %.lp "Special command keys"
 \item[\tb{Special command keys}]
 Below are the special commands you can rebind. Some of them can be bound to
-same keys with no problems, others are in the same "context", and if bound
+same keys with no problems, others are in the same ``context'', and if bound
 to same keys, only one of those commands will be available. Special command
 can only be bound to a single key.
 
@@ -4058,121 +4346,151 @@ can only be bound to a single key.
 \blist{}
 %.lp
 \item{\bb{count}}
-Prefix key to start a count, to repeat a command this many times. With {\it number\verb+_+pad\/} only. Default is ``{\tt n}''.
+Prefix key to start a count, to repeat a command this many times.
+With {\it number\verb+_+pad\/} only. Default is `{\tt n}'.
 %.lp
 \item{\bb{doinv}}
-Show inventory. With {\it number\verb+_+pad\/} only. Default is ``{\tt 0}''.
+Show inventory. With {\it number\verb+_+pad\/} only. Default is `{\tt 0}'.
 %.lp
 \item{\bb{fight}}
-Prefix key to force fight a direction. Default is ``{\tt F}''.
+Prefix key to force fight a direction. Default is `{\tt F}'.
 %.lp
 \item{\bb{fight.numpad}}
-Prefix key to force fight a direction. With {\it number\verb+_+pad\/} only. Default is ``{\tt -}''.
+Prefix key to force fight a direction. With {\it number\verb+_+pad\/} only.
+Default is `{\tt -}'.
 %.lp
 \item{\bb{getdir.help}}
-When asked for a direction, the key to show the help. Default is ``{\tt ?}''.
+When asked for a direction, the key to show the help. Default is `{\tt ?}'.
 %.lp
 \item{\bb{getdir.self}}
-When asked for a direction, the key to target yourself. Default is ``{\tt .}''.
+When asked for a direction, the key to target yourself. Default is `{\tt .}'.
 %.lp
 \item{\bb{getdir.self2}}
-When asked for a direction, the key to target yourself. Default is ``{\tt s}''.
+When asked for a direction, the key to target yourself. Default is `{\tt s}'.
 %.lp
 \item{\bb{getpos.autodescribe}}
-When asked for a location, the key to toggle {\it autodescribe\/}. Default is ``{\tt \#}''.
+When asked for a location, the key to toggle {\it autodescribe\/}.
+Default is `{\tt \#}'.
 %.lp
 \item{\bb{getpos.all.next}}
-When asked for a location, the key to go to next closest interesting thing. Default is ``{\tt a}''.
+When asked for a location, the key to go to next closest interesting thing.
+Default is `{\tt a}'.
 %.lp
 \item{\bb{getpos.all.prev}}
-When asked for a location, the key to go to previous closest interesting thing. Default is ``{\tt A}''.
+When asked for a location, the key to go to previous closest interesting thing.
+Default is `{\tt A}'.
 %.lp
 \item{\bb{getpos.door.next}}
-When asked for a location, the key to go to next closest door or doorway. Default is ``{\tt d}''.
+When asked for a location, the key to go to next closest door or doorway.
+Default is `{\tt d}'.
 %.lp
 \item{\bb{getpos.door.prev}}
-When asked for a location, the key to go to previous closest door or doorway. Default is ``{\tt D}''.
+When asked for a location, the key to go to previous closest door or doorway.
+Default is `{\tt D}'.
 %.lp
 \item{\bb{getpos.help}}
-When asked for a location, the key to show help. Default is ``{\tt ?}''.
+When asked for a location, the key to show help. Default is `{\tt ?}'.
 %.lp
 \item{\bb{getpos.mon.next}}
-When asked for a location, the key to go to next closest monster. Default is ``{\tt m}''.
+When asked for a location, the key to go to next closest monster.
+Default is `{\tt m}'.
 %.lp
 \item{\bb{getpos.mon.prev}}
-When asked for a location, the key to go to previous closest monster. Default is ``{\tt M}''.
+When asked for a location, the key to go to previous closest monster.
+Default is `{\tt M}'.
 %.lp
 \item{\bb{getpos.obj.next}}
-When asked for a location, the key to go to next closest object. Default is ``{\tt o}''.
+When asked for a location, the key to go to next closest object.
+Default is `{\tt o}'.
 %.lp
 \item{\bb{getpos.obj.prev}}
-When asked for a location, the key to go to previous closest object. Default is ``{\tt O}''.
+When asked for a location, the key to go to previous closest object.
+Default is `{\tt O}'.
 %.lp
 \item{\bb{getpos.menu}}
-When asked for a location, and using one of the next or previous keys to cycle through targets, toggle showing a menu instead. Default is '{\tt !}'.
+When asked for a location, and using one of the next or previous keys to
+cycle through targets, toggle showing a menu instead. Default is `{\tt !}'.
 %.lp
 \item{\bb{getpos.moveskip}}
-When asked for a location, and using the shifted movement keys or meta-digit keys to fast-move around, move by skipping the same glyphs instead of by 8 units. Default is ``{\tt *}''.
+When asked for a location, and using the shifted movement keys or
+meta-digit keys to fast-move around, move by skipping the same glyphs
+instead of by 8 units.
+Default is `{\tt *}'.
 %.lp
 \item{\bb{getpos.filter}}
-When asked for a location, change the filtering mode when using one of the next or previous keys to cycle through targets. Toggles between no filtering, in view only, and in the same area only. Default is '{\tt "}'.
+When asked for a location, change the filtering mode when using one of
+the next or previous keys to cycle through targets. Toggles between no
+filtering, in view only, and in the same area only. Default is `{\tt "}'.
 %.lp
 \item{\bb{getpos.pick}}
-When asked for a location, the key to choose the location, and possibly ask for more info. Default is ``{\tt .}''.
+When asked for a location, the key to choose the location, and possibly
+ask for more info. Default is `{\tt .}'.
 %.lp
 \item{\bb{getpos.pick.once}}
-When asked for a location, the key to choose the location, and skip asking for more info. Default is ``{\tt ,}''.
+When asked for a location, the key to choose the location, and skip
+asking for more info. Default is `{\tt ,}'.
 %.lp
 \item{\bb{getpos.pick.quick}}
-When asked for a location, the key to choose the location, skip asking for more info, and exit the location asking loop. Default is ``{\tt ;}''.
+When asked for a location, the key to choose the location, skip asking
+for more info, and exit the location asking loop. Default is `{\tt ;}'.
 %.lp
 \item{\bb{getpos.pick.verbose}}
-When asked for a location, the key to choose the location, and show more info without asking. Default is ``{\tt :}''.
+When asked for a location, the key to choose the location, and show more
+info without asking. Default is `{\tt :}'.
 %.lp
 \item{\bb{getpos.self}}
-When asked for a location, the key to go to your location. Default is ``{\tt @}''.
+When asked for a location, the key to go to your location.
+Default is `{\tt @}'.
 %.lp
 \item{\bb{getpos.unexplored.next}}
-When asked for a location, the key to go to next closest unexplored location. Default is ``{\tt x}''.
+When asked for a location, the key to go to next closest unexplored location.
+Default is `{\tt x}'.
 %.lp
 \item{\bb{getpos.unexplored.prev}}
-When asked for a location, the key to go to previous closest unexplored location. Default is ``{\tt X}''.
+When asked for a location, the key to go to previous closest unexplored
+location. Default is `{\tt X}'.
 %.lp
 \item{\bb{getpos.valid}}
-When asked for a location, the key to go to show valid target locations. Default is ``{\tt \$}''.
+When asked for a location, the key to go to show valid target locations.
+Default is `{\tt \$}'.
 %.lp
 \item{\bb{getpos.valid.next}}
-When asked for a location, the key to go to next closest valid location. Default is ``{\tt z}''.
+When asked for a location, the key to go to next closest valid location.
+Default is `{\tt z}'.
 %.lp
 \item{\bb{getpos.valid.prev}}
-When asked for a location, the key to go to previous closest valid location. Default is ``{\tt Z}''.
+When asked for a location, the key to go to previous closest valid location.
+Default is `{\tt Z}'.
 %.lp
 \item{\bb{nopickup}}
-Prefix key to move without picking up items. Default is ``{\tt m}''.
+Prefix key to move without picking up items. Default is `{\tt m}'.
 %.lp
 \item{\bb{redraw}}
-Key to redraw the screen. Default is ``{\tt \^{}R}''.
+Key to redraw the screen. Default is `{\tt \^{}R}'.
 %.lp
 \item{\bb{redraw.numpad}}
-Key to redraw the screen. With {\it number\verb+_+pad\/} only. Default is ``{\tt \^{}L}''.
+Key to redraw the screen. With {\it number\verb+_+pad\/} only.
+Default is `{\tt \^{}L}'.
 %.lp
 \item{\bb{repeat}}
-Key to repeat previous command. Default is ``{\tt \^{}A}''.
+Key to repeat previous command. Default is `{\tt \^{}A}'.
 %.lp
 \item{\bb{reqmenu}}
-Prefix key to request menu from some commands. Default is ``{\tt m}''.
+Prefix key to request menu from some commands. Default is `{\tt m}'.
 %.lp
 \item{\bb{run}}
-Prefix key to run towards a direction. Default is ``{\tt G}''.
+Prefix key to run towards a direction. Default is `{\tt G}'.
 %.lp
 \item{\bb{run.nopickup}}
-Prefix key to run towards a direction without picking up items on the way. Default is ``{\tt M}''.
+Prefix key to run towards a direction without picking up items on the way.
+Default is `{\tt M}'.
 %.lp
 \item{\bb{run.numpad}}
-Prefix key to run towards a direction. With {\it number\verb+_+pad\/} only. Default is ``{\tt 5}''.
+Prefix key to run towards a direction. With {\it number\verb+_+pad\/} only.
+Default is `{\tt 5}'.
 %.lp
 \item{\bb{rush}}
-Prefix key to rush towards a direction. Default is ``{\tt g}''.
+Prefix key to rush towards a direction. Default is `{\tt g}'.
 \elist
 \elist
 
@@ -4200,7 +4518,8 @@ how the message should be shown:
 {\tt show}  --- show message normally.\\
 {\tt hide}  --- never show the message.\\
 {\tt stop}  --- wait for user with more-prompt.\\
-{\tt norep} --- show the message once, but not again if no other message is shown in between.
+{\tt norep} --- show the message once, but not again if no other message is
+shown in between.
 %.ei
 %.ed
 %.lp
@@ -4263,12 +4582,15 @@ The pattern should be a regular expression.
 %.lp ""
 Allowed colors are {\it black}, {\it red}, {\it green}, {\it brown},
 {\it blue}, {\it magenta}, {\it cyan}, {\it gray}, {\it orange},
-{\it lightgreen}, {\it yellow}, {\it lightblue}, {\it lightmagenta},
-{\it lightcyan}, and {\it white}.
+{\it light-green}, {\it yellow}, {\it light-blue}, {\it light-magenta},
+{\it light-cyan}, and {\it white}.
+And {\it no-color}, the default foreground color, which isn't necessarily
+the same as any of the other colors.
 
 %.lp ""
 Allowed attributes are {\it none}, {\it bold}, {\it dim}, {\it underline},
 {\it blink}, and {\it inverse}.
+{\it Normal\/} is a synonym for {\it none}.
 Note that the platform used may interpret the attributes any way it
 wants.
 
@@ -4282,9 +4604,9 @@ pattern matching facility:
     MENUCOLOR="* cursed *(being worn)"=red&underline
 \end{verbatim}
 
-specifies that any menu line with " blessed " contained
-in it will be shown in green color, lines with " cursed " will be
-shown in red, and lines with " cursed " followed by "(being worn)"
+specifies that any menu line with ``~blessed~'' contained
+in it will be shown in green color, lines with ``~cursed~'' will be
+shown in red, and lines with ``~cursed~'' followed by ``(being worn)''
 on the same line will be shown in red color and underlined.
 You can have multiple MENUCOLOR entries in your config file,
 and the last MENUCOLOR-line in your config file that matches
@@ -4292,7 +4614,7 @@ a menu line will be used for the line.
 
 %.pg
 Note that if you intend to have one or more color specifications match
-" uncursed ", you will probably want to turn the
+``~uncursed~'', you will probably want to turn the
 {\it implicit\verb+_+uncursed\/}
 option off so that all items known to be uncursed are actually
 displayed with the ``uncursed'' description.
@@ -4338,40 +4660,68 @@ The pattern should be a regular expression.
 \subsection*{Configuring Status Hilites}
 
 %.pg
-Your copy of {\it NetHack\/} may have been compiled with support for {\it Status Hilites}.
+Your copy of {\it NetHack\/} may have been compiled with support
+for {\it Status Hilites}.
 If so, you can customize your game display by setting thresholds to
 change the color or appearance of fields in the status display.
-%.pg
-The format for defining status colors is:
+
+The format for defining status colors is:\\
 \begin{verbatim}
-    OPTION=hilite_status: field-name/behavior/color&attributes
+OPTION=hilite_status:field-name/behavior/color&attributes
 \end{verbatim}
-%.pg
-For example, the following line in your config file will cause
+
+For example, the following line in your configuration file will cause
 the hitpoints field to display in the color red if your hitpoints
-drop to or below a threshold of 30%:
+drop to or below a threshold of 30%:\\
 \begin{verbatim}
-    OPTION=hilite_status: hitpoints/<30%/red/normal
+OPTION=hilite_status:hitpoints/<=30%/red/normal
 \end{verbatim}
-%.pg
-For another example, the following line in your config file will cause
-wisdom to be displayed red if it drops and green if it rises.
+(That example is actually specifying {\tt red\&normal} for  {\tt <=30\%}
+and {\tt no-color\&normal} for {\tt >30\%}.)\\
+
+For another example, the following line in your configuration file will cause
+wisdom to be displayed red if it drops and green if it rises:\\
 \begin{verbatim}
-    OPTION=hilite_status: wisdom/down/red/up/green
+OPTION=hilite_status:wisdom/down/red/up/green
 \end{verbatim}
+
+Allowed colors are black, red, green, brown, blue, magenta, cyan, gray,
+orange, light-green, yellow, light-blue, light-magenta, light-cyan, and white.
+And {\it no-color}, the default foreground color on the display, which
+is not necessarily the same as black or white or any of the other colors.
+
+Allowed attributes are none, bold, dim, underline, blink, and inverse.
+``Normal'' is a synonym for ``none''; they should not be used in
+combination with any of the other attributes.
+
+To specify both a color and an attribute, use `\&' to combine them.
+To specify multiple attributes, use `+' to combine those.
+For example: {\tt magenta\&inverse+dim}.
+
+Note that the display may substitute or ignore particular attributes
+depending upon its capabilities, and in general may interpret the
+attributes any way it wants.
+For example, on some display systems a request for bold might yield
+blink or vice versa.
+On others, issuing an attribute request while another is already
+set up will replace the earlier attribute rather than combine with it.
+Since nethack issues attribute requests sequentially (at least with
+the {\it tty} interface) rather than all at once, the only way a
+situation like that can be controlled is to specify just one attribute.
+
 You can adjust the display of the following status fields:
 %.sd
 \begin{center}
 \begin{tabular}{lll}
 %TABLE_START
-title & strength & dexterity\\
-constitution & intelligence & wisdom\\
-charisma & alignment & score\\
-carrying-capacity & gold & power\\
-power-max & experience-level & armor-class\\
-HD & time & hunger\\
-hitpoints & hitpoints-max & dungeon-level\\
-experience & condition\\
+title & dungeon-level & experience-level\\
+strength & gold & experience\\
+dexterity & hitpoints & HD\\
+constitution & hitpoints-max & time\\
+intelligence & power & hunger\\
+wisdom & power-max & carrying-capacity\\
+charisma & armor-class & condition\\
+alignment &  & score\\
 %TABLE_END  Do not delete this line.
 \end{tabular}
 \end{center}
@@ -4387,66 +4737,69 @@ depending upon your other option settings.
 Instead of a behavior, `condition' takes the following condition flags:
 {\it stone}, {\it slime}, {\it strngl}, {\it foodpois}, {\it termill},
 {\it blind}, {\it deaf}, {\it stun}, {\it conf}, {\it hallu},
-{\it lev}, {\it fly}, and {\it ride}.  You can use `major\_troubles' as an alias
+{\it lev}, {\it fly}, and {\it ride}.
+You can use `major\_troubles' as an alias
 for stone through termill, `minor\_troubles' for blind through hallu,
 `movement' for lev, fly, and ride, and `all' for every condition.
 
 %.lp ""
-Allowed behaviors are "always", "up", "down", "changed", a
-percentage or absolute number threshold, or text to match against.
+Allowed behaviors are ``always'', ``up'', ``down'', ``changed'', a
+percentage or absolute number threshold, or text to match against.
 
 \blist{}
 %.lp "*"
 \item{\bb{}}
-"always" will set the default attributes for that field.
+``{\tt always}'' will set the default attributes for that field.
 %.lp "*"
 \item{\bb{}}
-"up" and "down" set the field attributes for when the field
+``{\tt up}'' and ``{\tt down}'' set the field attributes for when the field
 value changes upwards or downwards. This attribute times out after
-statushilites turns.
+{\tt statushilites} turns.
 %.lp "*"
 \item{\bb{}}
-"changed" sets the field attribute for when the field value
-changes. This attribute times out after statushilites turns.
+``{\tt changed}'' sets the field attribute for when the field value
+changes. This attribute times out after {\tt statushilites} turns.
+(If a field has both a ``changed'' rule and an ``up'' or ``down''
+rule which matches a change in the field's value,
+the ``up'' or ``down'' one takes precedence.)
 %.lp "*"
 \item{\bb{}}
 percentage sets the field attribute when the field value
-matches the percentage. If the percentage is prefixed with `{\tt <}'
-or `{\tt >}', it also matches when value is below or above the percentage.
-Only valid for `power' and `hitpoints' fields.
+matches the percentage.
+It is specified as a number between 0 and 100, followed by `{\tt \%}'
+(percent sign).
+If the percentage is prefixed with `{\tt <=}' or `{\tt >=}',
+it also matches when value is below or above the percentage.
+Use prefix `{\tt <}' or `{\tt >}' to match when strictly below or above.
+(The numeric limit is relaxed slightly for those: {\tt >-1\%}
+and {\tt <101\%} are allowed.)
+Only valid for ``{\it hitpoints\/}'' and ``{\it power\/}'' fields.
 %.lp "*"
 \item{\bb{}}
 absolute value sets the attribute when the field value
-matches that number. If the number is prefixed with `{\tt <}'
-or `{\tt >}', it also matches when value is below or above.
+matches that number.
+The number must be 0 or higher, except for ``{\it armor-class\/} which
+allows negative values, and may optionally be preceded by `{\tt =}'.
+If the number is preceded by `{\tt <=}' or `{\tt >=}' instead,
+it also matches when value is below or above.
+If the prefix is `{\tt <}' or `{\tt >}', only match when strictly
+above or below.
 %.lp "*"
 \item{\bb{}}
-text match sets the attribute when the field value
-matches the text. Text matches can only be used for `alignment',
-`carrying-capacity', and `dungeon-level'.
+text match sets the attribute when the field value matches the text.
+Text matches can only be used for ``{\it alignment\/}'',
+``{\it carrying-capacity\/}'', ``{\it hunger\/}'', ``{\it dungeon-level\/}'',
+and ``{\it title\/}''.
+For title, only the role's rank title
+is tested; the character's name is ignored.
 %.ei
 \elist
 
-%.lp ""
-Allowed colors are {\it black}, {\it red}, {\it green}, {\it brown},
-{\it blue}, {\it magenta}, {\it cyan}, {\it gray}, {\it orange},
-{\it lightgreen}, {\it yellow}, {\it lightblue}, {\it lightmagenta},
-{\it lightcyan}, and {\it white}.
-
-%.lp ""
-Allowed attributes are {\it bold}, {\it inverse}, {\it underline},
-{\it blink}, {\it dim}, and {\it normal}.
-Note that the platform used may interpret the attributes any way it
-wants.
-
-%.lp ""
 The in-game options menu can help you determine the correct syntax for a
 config file.
 
-%.lp ""
 The whole feature can be disable by setting option {\it statushilites} to 0.
 
-%.lp ""
 Example hilites:
 \begin{verbatim}
     OPTION=hilite_status: gold/up/yellow/down/brown
@@ -4712,10 +5065,13 @@ These co-ordinates are often useful in giving players a better sense of the
 overall location of items on the screen.
 %.pg
 {\it NetHack\/} can also be compiled with support for sending the game messages
-to an external program, such as a text-to-speech synthesizer. If the \#version
-extended command shows "external program as a message handler", your {\it NetHack\/}
-has been compiled with the capability. When compiling {\it NetHack\/} from source
-on Linux and other POSIX systems, define {\it MSGHANDLER\/} to enable it. To use
+to an external program, such as a text-to-speech synthesizer. If the
+``{\tt \#version}'' extended command shows ``external program as a
+message handler'', your {\it NetHack\/}
+has been compiled with the capability. When compiling {\it NetHack\/}
+from source
+on Linux and other POSIX systems, define {\it MSGHANDLER\/} to enable it.
+To use
 the capability, set the environment variable {\it NETHACK\_MSGHANDLER\/} to an
 executable, which will be executed with the game message as the program's
 only parameter.
@@ -4793,9 +5149,10 @@ system).
 \blist{}
 %.lp
 \item[\ib{WIZARDS}]
-A space-separated list of user name who are allowed to play in wizard
-mode (the debugging mode, not the magic-useing role). A value of a single
-asterisk (*) allows anyone to start a game in wizard mode.
+A space-separated list of user name who are allowed to
+play in debug mode (commonly referred to as wizard mode).
+A value of a single
+asterisk (*) allows anyone to start a game in debug mode.
 %.lp
 \item[\ib{SHELLERS}]
 A list of users who are allowed to use the shell escape command (`{\tt !}').
@@ -4851,7 +5208,7 @@ if your game is compiled with DUMPLOG. Allows the following placeholders:
 %.sd
 %.si
 {\tt \%\%}  --- literal `{\tt \%}'\\
-{\tt \%v}  --- version (eg. "3.6.1-0")\\
+{\tt \%v}  --- version (eg. ``{\tt 3.6.2-0}'')\\
 {\tt \%u}  --- game UID\\
 {\tt \%t}  --- game start time, UNIX timestamp format\\
 {\tt \%T}  --- current time, UNIX timestamp format\\
@@ -4921,10 +5278,13 @@ the trepid reader to discover.
 
 %.pg
 Debug mode, also known as wizard mode, is undocumented aside from this
-brief description.  It is intended for tracking down problems within the
+brief description and the various ``debug mode only'' commands listed
+among the command descriptions.
+It is intended for tracking down problems within the
 program rather than to provide god-like powers to your character, and
 players who attempt debugging are expected to figure out how to use it
-themselves.  It is initiated by starting the game with the
+themselves.
+It is initiated by starting the game with the
 {\tt -D}
 command-line switch or with the
 {\it playmode:debug\/}
@@ -4935,8 +5295,7 @@ For some systems, the player must be logged in
 under a particular user name to be allowed to use debug mode; for others,
 the hero must be given a particular character name (but may be any role;
 there's no connection between ``wizard mode'' and the {\it Wizard\/} role).
-And on any system, the program might have been configured to omit debug
-mode entirely.  Attempting to start a game in debug mode when not allowed
+Attempting to start a game in debug mode when not allowed
 or not available will result in falling back to explore mode instead.
 
 %.hn
@@ -4998,7 +5357,7 @@ NetHack\/} 3.0c.
 \medskip
 \nd {\it NetHack\/} 3.0 was ported to the Atari by {\it Eric R. Smith}, to OS/2 by
 {\it Timo Hakulinen}, and to VMS by {\it David Gentzel}.  The three of them
-and {\it Kevin Darcy\/} later joined the main development team to produce
+and {\it Kevin Darcy\/} later joined the main {\it NetHack Development Team} to produce
 subsequent revisions of 3.0.
 
 %.pg
@@ -5013,7 +5372,7 @@ revisions of 3.0.
 %.pg
 \medskip
 \nd Headed by {\it Mike Stephenson\/} and coordinated by {\it Izchak Miller\/} and
-{\it Janet Walz}, the development team which now included {\it Ken Arromdee},
+{\it Janet Walz}, the {\it NetHack Development Team} which now included {\it Ken Arromdee},
 {\it David Cohrs}, {\it Jean-Christophe Collet}, {\it Kevin Darcy},
 {\it Matt Day}, {\it Timo Hakulinen}, {\it Steve Linhart}, {\it Dean Luick},
 {\it Pat Rankin}, {\it Eric Raymond}, and {\it Eric Smith\/} undertook a radical
@@ -5056,12 +5415,12 @@ was responsible for the VMS version of {\it NetHack\/} 3.1.
 \nd {\it Dean Luick}, with help from {\it David Cohrs}, developed {\it NetHack\/}
 3.1 for X11.
 {\it Warwick Allison} wrote a tiled version of {\it NetHack\/} for the Atari;
-he later contributed the tiles to the DevTeam and tile support was
+he later contributed the tiles to the {\it NetHack Development Team} and tile support was
 then added to other platforms.
 
 %.pg
 \medskip
-\nd The 3.2 development team, comprised of {\it Michael Allison}, {\it Ken
+\nd The 3.2 {\it NetHack Development Team}, comprised of {\it Michael Allison}, {\it Ken
 Arromdee}, {\it David Cohrs}, {\it Jessie Collet}, {\it Steve Creps}, {\it
 Kevin Darcy}, {\it Timo Hakulinen}, {\it Steve Linhart}, {\it Dean Luick},
 {\it Pat Rankin}, {\it Eric Smith}, {\it Mike Stephenson}, {\it Janet Walz},
@@ -5071,9 +5430,9 @@ and {\it Paul Winner}, released version 3.2 in April of 1996.
 \medskip
 \nd Version 3.2 marked the tenth anniversary of the formation of the development
 team.  In a testament to their dedication to the game, all thirteen members
-of the original development team remained on the team at the start of work on
+of the original {\it NetHack Development Team} remained on the team at the start of work on
 that release.  During the interval between the release of 3.1.3 and 3.2,
-one of the founding members of the development team, {\it Dr. Izchak Miller},
+one of the founding members of the {\it NetHack Development Team}, {\it Dr. Izchak Miller},
 was diagnosed with cancer and passed away.  That release of the game was
 dedicated to him by the development and porting teams.
 
@@ -5098,10 +5457,10 @@ casting system with the Wizard Patch.
 %.pg
 \medskip
 {\it Warren Cheung} combined {\it SLASH} with the Wizard Patch
-to produce {\it Slash'em\/}, and
+to produce {\it Slash'EM\/}, and
 with the help of {\it Kevin Hugo}, added more features.
 Kevin later joined the
-DevTeam and incorporated the best of these ideas into {\it NetHack\/} 3.3.
+{\it NetHack Development Team} and incorporated the best of these ideas into {\it NetHack\/} 3.3.
 
 %.pg
 \medskip
@@ -5110,7 +5469,7 @@ simultaneously with 3.3.0 in December 1999 just in time for the Year 2000.
 
 %.pg
 \medskip
-The 3.3 development team, consisting of {\it Michael Allison}, {\it Ken Arromdee},
+The 3.3 {\it NetHack Development Team}, consisting of {\it Michael Allison}, {\it Ken Arromdee},
 {\it David Cohrs}, {\it Jessie Collet}, {\it Steve Creps}, {\it Kevin Darcy},
 {\it Timo Hakulinen}, {\it Kevin Hugo}, {\it Steve Linhart}, {\it Ken Lorber},
 {\it Dean Luick}, {\it Pat Rankin}, {\it Eric Smith}, {\it Mike Stephenson},
@@ -5132,7 +5491,7 @@ more than a year and a half.
 
 %.pg
 \medskip
-The 3.4 development team initially consisted of
+The 3.4 {\it NetHack Development Team} initially consisted of
 {\it Michael Allison}, {\it Ken Arromdee},
 {\it David Cohrs}, {\it Jessie Collet}, {\it Kevin Hugo}, {\it Ken Lorber},
 {\it Dean Luick}, {\it Pat Rankin}, {\it Mike Stephenson},
@@ -5193,7 +5552,7 @@ resurrected it for 3.3.1.
 The release of {\it NetHack\/} 3.4.3 in December 2003 marked the beginning of
 a long release hiatus. 3.4.3 proved to be a remarkably stable version that
 provided continued enjoyment by the community for more than a decade. The
-devteam slowly and quietly continued to work on the game behind the scenes
+{\it NetHack Development Team} slowly and quietly continued to work on the game behind the scenes
 during the tenure of 3.4.3. It was during that same period that several new
 variants emerged within the {\it NetHack\/} community. Notably sporkhack by
 Derek S. Ray, {\it unnethack\/} by Patric Mueller, {\it nitrohack\/} and its
@@ -5208,7 +5567,7 @@ released publicly by other parties. Since that code was a work-in-progress
 and had not gone through the process of debugging it as a suitable release,
 it was decided that the version numbers present on that code snapshot would
 be retired and never used in an official {\it NetHack\/} release. An
-announcement was posted on the devteam's official {\it nethack.org\/} website
+announcement was posted on the {\it NetHack Development Team}'s official {\it nethack.org\/} website
 to that effect, stating that there would never be a 3.4.4, 3.5, or 3.5.0
 official release version.
 
@@ -5219,7 +5578,7 @@ In January 2015, preparation began for the release of NetHack 3.6.
 %.pg
 \medskip
 At the beginning of development for what would eventually get released
-as 3.6.0, the development team consisted of {\it Warwick Allison},
+as 3.6.0, the {\it NetHack Development Team} consisted of {\it Warwick Allison},
 {\it Michael Allison}, {\it Ken Arromdee},
 {\it David Cohrs}, {\it Jessie Collet},
 {\it Ken Lorber}, {\it Dean Luick}, {\it Pat Rankin},
@@ -5230,9 +5589,9 @@ joined the {\it NetHack\/} development team.
 
 %.pg
 \medskip
-Near the end of the development of 3.6.0, one of the significant inspirations 
-for many of the humorous and fun features found in the game, 
-author Terry Pratchett, passed away. {\it NetHack\/} 3.6.0 introduced 
+Near the end of the development of 3.6.0, one of the significant inspirations
+for many of the humorous and fun features found in the game,
+author Terry Pratchett, passed away. {\it NetHack\/} 3.6.0 introduced
 a tribute to him.
 
 %.pg
@@ -5243,19 +5602,7 @@ patches.  Many bugs were fixed and some code was restructured.
 
 %.pg
 \medskip
-In late April 2018, several hundred bug fixes for 3.6.0 and some new features
-were assembled and released as NetHack 3.6.1. The development team at the 
-time of release of 3.6.1 consisted of 
-{\it Warwick Allison}, {\it Michael Allison}, {\it Ken Arromdee}, 
-{\it David Cohrs}, {\it Jessie Collet},
-{\it Pasi Kallinen}, {\it Ken Lorber}, {\it Dean Luick},
-{\it Patric Mueller}, {\it Pat Rankin}, {\it Derek S. Ray},
-{\it Alex Smith}, {\it Mike Stephenson}, {\it Janet Walz}, and
-{\it Paul Winner}.
-
-%.pg
-\medskip
-The development team, as well as {\it Steve VanDevender} and
+The {\it NetHack Development Team}, as well as {\it Steve VanDevender} and
 {\it Kevin Smolkowski}, ensured that {\it NetHack\/} 3.6 continued to
 operate on various Unix flavors and maintained the X11 interface.
 
@@ -5273,18 +5620,35 @@ maintained the port of  {\it NetHack\/} 3.6 for Microsoft Windows.
 
 %.pg
 \medskip
-{\it Pat Rankin} attempted to keep the VMS port running for NetHack 3.6.1,
-hindered by limited access.  {it Kevin Smolkowski} has updated and tested it
+{\it Pat Rankin} attempted to keep the VMS port running for NetHack 3.6,
+hindered by limited access.  {\it Kevin Smolkowski} has updated and tested it
 for the most recent version of OpenVMS (V8.4 as of this writing) on Alpha
 and Integrity (aka Itanium aka IA64) but not VAX.
 
 %.pg
 \medskip
-{\it Ray Chason}  resurrected the msdos port for 3.6.1 and contributed the
+{\it Ray Chason}  resurrected the msdos port for 3.6 and contributed the
 necessary updates to the community at large.
 
 %.pg
 \medskip
+In late April 2018, several hundred bug fixes for 3.6.0 and some new features
+were assembled and released as NetHack 3.6.1. The {\it NetHack Development Team} at the
+time of release of 3.6.1 consisted of
+{\it Warwick Allison}, {\it Michael Allison}, {\it Ken Arromdee},
+{\it David Cohrs}, {\it Jessie Collet},
+{\it Pasi Kallinen}, {\it Ken Lorber}, {\it Dean Luick},
+{\it Patric Mueller}, {\it Pat Rankin}, {\it Derek S. Ray},
+{\it Alex Smith}, {\it Mike Stephenson}, {\it Janet Walz}, and
+{\it Paul Winner}.
+
+%.pg
+\medskip
+In early May 2019, another 320 bug fixes along with some enhancements and 
+the adopted curses window port, were released as 3.6.2.
+
+%.pg
+\medskip
 \nd The official {\it NetHack\/} web site is maintained by {\it Ken Lorber} at
 {\catcode`\#=11
 \special{html:<a href="http://www.nethack.org/">}}
@@ -5297,62 +5661,67 @@ http:{\tt /}{\tt /}www.nethack.org{\tt /}.
 
 \subsection*{Special Thanks}
 \nd On behalf of the {\it NetHack\/} community, thank you very much once
-again to {\it M. Drew Streib}, {\it Pasi Kallinen} and {\it Robin Bandy} for
-providing public {\it NetHack\/} servers at  {\it nethack.alt.org\/} and
-{\it devnull.net\/} and/or for hosting annual {\it NetHack\/} tournaments.
+again to {\it M. Drew Streib} and {\it Pasi Kallinen} for providing a
+public NetHack server at nethack.alt.org. Thanks to {\it Keith Simpson}
+and {\it Andy Thomson} for hardfought.org. Thanks to all those
+unnamed dungeoneers who invest their time and effort into annual
+{\it NetHack\/} tournaments such as {\it Junethack}, 
+{\it The November NetHack Tournament} and in days past,
+{\it devnull.net\/} (gone for now, but not forgotten).
 \clearpage
 
 %.hn
 \section*{Dungeoneers}
 %.pg
 \nd From time to time, some depraved individual out there in netland sends a
-particularly intriguing modification to help out with the game.  The Gods of
-the Dungeon sometimes make note of the names of the worst of these miscreants
-in this, the list of Dungeoneers:
+particularly intriguing modification to help out with the game.  The 
+{\it NetHack Development Team} sometimes makes note of the names of the worst
+of these miscreants in this, the list of Dungeoneers:
 %.sd
 \begin{center}
 \begin{tabular}{llll}
 %TABLE_START
-Adam Aronow & J. Ali Harlow & Mikko Juola\\
-Alex Kompel & Janet Walz & Nathan Eady\\
-Alex Smith & Janne Salmij\"{a}rvi & Norm Meluch\\
-Andreas Dorn & Jean-Christophe Collet & Olaf Seibert\\
-Andy Church & Jeff Bailey & Pasi Kallinen\\
-Andy Swanson & Jochen Erwied & Pat Rankin\\
-Ari Huttunen & John Kallen & Patric Mueller\\
-Barton House & John Rupley & Paul Winner\\
-Benson I. Margulies & John S. Bien & Pierre Martineau\\
-Bill Dyer & Johnny Lee & Ralf Brown\\
-Boudewijn Waijers & Jon W\{tte & Ray Chason\\
-Bruce Cox & Jonathan Handler & Richard Addison\\
-Bruce Holloway & Joshua Delahunty & Richard Beigel\\
-Bruce Mewborne & Keizo Yamamoto & Richard P. Hughey\\
-Carl Schelin & Ken Arnold & Rob Menke\\
-Chris Russo & Ken Arromdee & Robin Bandy\\
-David Cohrs & Ken Lorber & Robin Johnson\\
-David Damerell & Ken Washikita & Roderick Schertler\\
-David Gentzel & Kevin Darcy & Roland McGrath\\
-David Hairston & Kevin Hugo & Ron Van Iwaarden\\
-Dean Luick & Kevin Sitze & Ronnen Miller\\
-Del Lamb & Kevin Smolkowski & Ross Brown\\
-Derek S. Ray & Kevin Sweet & Sascha Wostmann\\
-Deron Meranda & Lars Huttar & Scott Bigham\\
-Dion Nicolaas & Leon Arnott & Scott R. Turner\\
-Dylan O'Donnell & M. Drew Streib & Sean Hunt\\
-Eric Backus & Malcolm Ryan & Stephen Spackman\\
-Eric Hendrickson & Mark Gooderum & Stefan Thielscher\\
-Eric R. Smith & Mark Modrall & Stephen White\\
-Eric S. Raymond & Marvin Bressler & Steve Creps\\
-Erik Andersen & Matthew Day & Steve Linhart\\
-Frederick Roeber & Merlyn LeRoy & Steve VanDevender\\
-Gil Neiger & Michael Allison & Teemu Suikki\\
-Greg Laskin & Michael Feir & Tim Lennan\\
-Greg Olson & Michael Hamel & Timo Hakulinen\\
-Gregg Wonderly & Michael Sokolov & Tom Almy\\
-Hao-yang Wang & Mike Engber & Tom West\\
-Helge Hafting & Mike Gallop & Warren Cheung\\
-Irina Rempt-Drijfhout & Mike Passaretti & Warwick Allison\\
-Izchak Miller & Mike Stephenson & Yitzhak Sapir
+Adam Aronow & Janet Walz & Nathan Eady\\
+Alex Kompel & Janne Salmij\"{a}rvi & Norm Meluch\\
+Alex Smith & Jean-Christophe Collet & Olaf Seibert\\
+Andreas Dorn & Jeff Bailey & Pasi Kallinen\\
+Andy Church & Jochen Erwied & Pat Rankin\\
+Andy Swanson & John Kallen & Patric Mueller\\
+Ari Huttunen & John Rupley & Paul Winner\\
+Barton House & John S. Bien & Pierre Martineau\\
+Benson I. Margulies & Johnny Lee & Ralf Brown\\
+Bill Dyer & Jon W\{tte & Ray Chason\\
+Boudewijn Waijers & Jonathan Handler & Richard Addison\\
+Bruce Cox & Joshua Delahunty & Richard Beigel\\
+Bruce Holloway & Karl Garrison & Richard P. Hughey\\
+Bruce Mewborne & Keizo Yamamoto & Rob Menke\\
+Carl Schelin & Ken Arnold & Robin Bandy\\
+Chris Russo & Ken Arromdee & Robin Johnson\\
+David Cohrs & Ken Lorber & Roderick Schertler\\
+David Damerell & Ken Washikita & Roland McGrath\\
+David Gentzel & Kevin Darcy & Ron Van Iwaarden\\
+David Hairston & Kevin Hugo & Ronnen Miller\\
+Dean Luick & Kevin Sitze & Ross Brown\\
+Del Lamb & Kevin Smolkowski & Sascha Wostmann\\
+Derek S. Ray & Kevin Sweet & Scott Bigham\\
+Deron Meranda & Lars Huttar & Scott R. Turner\\
+Dion Nicolaas & Leon Arnott & Sean Hunt\\
+Dylan O'Donnell & M. Drew Streib & Stephen Spackman\\
+Eric Backus & Malcolm Ryan & Stefan Thielscher\\
+Eric Hendrickson & Mark Gooderum & Stephen White\\
+Eric R. Smith & Mark Modrall & Steve Creps\\
+Eric S. Raymond & Marvin Bressler & Steve Linhart\\
+Erik Andersen & Matthew Day & Steve VanDevender\\
+Frederick Roeber & Merlyn LeRoy & Teemu Suikki\\
+Gil Neiger & Michael Allison & Tim Lennan\\
+Greg Laskin & Michael Feir & Timo Hakulinen\\
+Greg Olson & Michael Hamel & Tom Almy\\
+Gregg Wonderly & Michael Sokolov & Tom West\\
+Hao-yang Wang & Mike Engber & Warren Cheung\\
+Helge Hafting & Mike Gallop & Warwick Allison\\
+Irina Rempt-Drijfhout & Mike Passaretti & Yitzhak Sapir\\
+Izchak Miller & Mike Stephenson\\
+J. Ali Harlow & Mikko Juola
 %TABLE_END  Do not delete this line.
 \end{tabular}
 \end{center}
@@ -5366,7 +5735,7 @@ Izchak Miller & Mike Stephenson & Yitzhak Sapir
 %UNIX is a registered trademark of AT\&T.\\
 %Lattice is a trademark of Lattice, Inc.\\
 %Atari and 1040ST are trademarks of Atari, Inc.\\
-%AMIGA is a trademark of Commodore-Amiga, Inc.\\
+%Amiga is a trademark of Commodore-Amiga, Inc.\\
 %%.sm
 %Brand and product names are trademarks or registered trademarks
 %of their respective holders.