]> granicus.if.org Git - nethack/commitdiff
minor Guidebook update
authorPatR <rankin@nethack.org>
Tue, 23 Feb 2016 01:52:55 +0000 (17:52 -0800)
committerPatR <rankin@nethack.org>
Tue, 23 Feb 2016 01:52:55 +0000 (17:52 -0800)
Miscellaneous changes suggested during beta testing.  There were more,
but I've run out of gas.

Guidebook.mn has been tested, Guidebook.tex has not.

doc/Guidebook.mn
doc/Guidebook.tex

index 4ba47ad1b0585ade5ec05052be6d8cef43f45546..aab1169f9966c13325bded14912729e95d152406 100644 (file)
@@ -1,11 +1,11 @@
-.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.202 $ $NHDT-Date: 1456187657 2016/02/23 00:34:17 $
+.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.203 $ $NHDT-Date: 1456192371 2016/02/23 01:52:51 $
 .ds h0 "NetHack Guidebook
 .ds h1
 .ds h2 %
 .ds vr "NetHack 3.6
 .ds f0 "\*(vr
 .ds f1
-.ds f2 "January 18, 2016
+.ds f2 "February 22, 2016
 .\" labeled paragraph start (should be part of tmac.n, but I don't want to
 .\" make changes to that file)
 .\" .PS word
@@ -295,6 +295,9 @@ do other tasks requiring agility or manipulation of objects.
 .lp Constitution
 Constitution affects your ability to recover from injuries and other
 strains on your stamina.
+When strength is low or modest, consitution also affects how much you
+can carry.  With sufficiently high strength, the contribution to
+carrying capacity from your constitution no longer matters.
 .lp Intelligence
 Intelligence affects your ability to cast spells and read spellbooks.
 .lp Wisdom
@@ -1308,7 +1311,8 @@ you what you just picked up.
 As you add items to your inventory, you also add the weight of that object
 to your load.  The amount that you can carry depends on your strength and
 your constitution.  The
-stronger you are, the less the additional load will affect you.  There comes
+stronger and sturdier
+you are, the less the additional load will affect you.  There comes
 a point, though, when the weight of all of that stuff you are carrying around
 with you through the dungeon will encumber you.  Your reactions
 will get slower and you'll burn calories faster, requiring food more frequently
@@ -1579,6 +1583,7 @@ elven mithril-coat        5
 chain mail     5
 orcish chain mail      6
 scale mail     6
+dragon scales  7
 studded leather armor  7
 ring mail      7
 orcish ring mail       8
@@ -1674,10 +1679,12 @@ The command to drink a potion is `q' (quaff).
 .hn 2
 Wands (`/')
 .pg
-Magic wands usually have multiple magical charges.  Some wands are
-directional\(emyou must give a direction in which to zap them.  You can also
+Wands usually have multiple magical charges.
+Some types of wands require a direction in which to zap them.
+You can also
 zap them at yourself (just give a `.' or `s' for the direction). Be warned,
-however, for this is often unwise.  Other wands are nondirectional\(emthey
+however, for this is often unwise.
+Other types of wands
 don't require a direction.  The number of charges in a wand is random and
 decreases by one whenever you use it.
 .pg
@@ -1733,16 +1740,18 @@ energy and the time required in casting.
 .pg
 Casting a spell calls forth magical energies and focuses them with
 your naked mind.  Some of the magical energy released comes from within
-you, and casting several spells in a row may tire you.
+you.
+Casting temporarily drains your magical power, which will slowly be
+recovered, and causes you to need additional food.
 Casting of spells also requires practice.  With practice, your
 skill in each category of spell casting will improve.  Over time, however,
 your memory of each spell will dim, and you will need to relearn it.
 .pg
-Some spells are
-directional\(emyou must give a direction in which to cast them.  You can also
-cast them at yourself (just give a `.' or `s' for the direction). Be warned,
-however, for this is often unwise.  Other spells are nondirectional\(emthey
-don't require a direction.
+Some spells require a direction in which to cast them, similar to wands.
+To cast one at yourself, just give a `.' or `s' for the direction.
+A few spells require you to pick a target location rather than just specify
+a particular direction.
+Other spells don't require any direction or target.
 .pg
 Just as weapons are divided into groups in which a character can become
 proficient (to varying degrees), spells are similarly grouped.
@@ -1818,6 +1827,9 @@ heavy.  It is rumored that some statues are not what they seem.
 .pg
 Very large humanoids (giants and their ilk) have been known to use boulders
 as weapons.
+.pg
+For some configurations of the program, statues are no longer shown as `\`'
+but by the letter representing the monster they depict instead.
 .hn 2
 Gold (`$')
 .pg
@@ -2034,7 +2046,7 @@ Persistent.
 Your starting alignment (align:lawful, align:neutral,
 or align:chaotic).  You may specify just the first letter.
 The default is to randomly pick an appropriate alignment.
-If you prefix a `!' or ``no'' to the value, you can
+If you prefix the value with `!' or ``no'', you will
 exclude that alignment from being picked randomly.
 Cannot be set with the `O' command.  Persistent.
 .lp autodescribe
@@ -2069,22 +2081,26 @@ Start the character permanently blind.  Persistent. (default false)
 .lp bones
 Allow saving and loading bones files.  Persistent. (default true)
 .lp boulder
-Set the character used to display boulders (default is rock class symbol).
+Set the character used to display boulders (default is the ``large rock''
+class symbol, `\`').
 .lp catname
 Name your starting cat (ex. ``catname:Morris'').
 Cannot be set with the `O' command.
 .lp character
-Pick your type of character (ex. ``character:Monk'');
-synonym for ``role''.  See ``name'' for an alternate method
-of specifying your role.  Normally only the first letter of
-the value is examined; the string ``random'' is an exception.
+Synonym for ``role'' to pick the type of your character
+(ex. ``character:Monk'').
+See
+.op role
+for more details.
 .lp checkpoint
 Save game state after each level change, for possible recovery after
 program crash (default on).  Persistent.
 .lp checkspace
 Check free disk space before writing files to disk (default on).
 You may have to turn this off if you have more than 2 GB free space
-on the partition used for your save and level files.
+on the partition used for your save and level files
+(because too much space might overflow the calculation and end up
+looking like insufficient space).
 Only applies when MFLOPPY was defined during compilation.
 .lp clicklook
 Allows looking at things on the screen by navigating the mouse
@@ -2169,7 +2185,7 @@ You may specify just the first letter.  Although you can
 still denote your gender using the ``male'' and ``female''
 options, the ``gender'' option will take precedence.
 The default is to randomly pick an appropriate gender.
-If you prefix a `!' or ``no'' to the value, you can
+If you prefix the value with `!' or ``no'', you will
 exclude that gender from being picked randomly.
 Cannot be set with the `O' command.  Persistent.
 .lp "help    "
@@ -2444,7 +2460,7 @@ Likewise for the `a' (apply) command if it causes the applied item to
 become wielded.  Persistent.
 .lp "race    "
 Selects your race (for example, ``race:human'').  Default is random.
-If you prefix a `!' or ``no'' to the value, you can
+If you prefix the value with `!' or ``no'', you will
 exclude that race from being picked randomly.
 Cannot be set with the `O' command.  Persistent.
 .lp rest_on_space
@@ -2455,8 +2471,10 @@ Pick your type of character (ex. ``role:Samurai'');
 synonym for ``character''.  See ``name'' for an alternate method
 of specifying your role.  Normally only the first letter of the
 value is examined; `r' is an exception with ``Rogue'', ``Ranger'',
-and ``random'' values. If you prefix a `!' or ``no'' to the value, you can
-exclude that role from being picked randomly.  Persistent.
+and ``random'' values.
+If you prefix the value with `!' or ``no'', you will
+exclude that role from being picked randomly.
+Cannot be set with the `O' command.  Persistent.
 .lp roguesymset
 This option may be used to select one of the named symbol sets found within
 ``symbols'' to alter the symbols displayed on the screen on the rogue level.
@@ -3253,59 +3271,55 @@ The options recognized in this file are listed below.  Any option not
 set uses a compiled-in default (which may not be appropriate for your
 system).
 .pg
+.\"  '\ =\ Word'  follow each option name with space+equals+space+first
+.\"               word of sentence in a way that won't have spaces inserted
+.\"               there if that line is padded from left to right;
+.\"               essentially, "OPTION = Word" becomes one token as far
+.\"               as filling and justifying are concerned
 .lp
-WIZARDS
-A space-separated list of user names who are allowed to play in wizard
+WIZARDS\ =\ A space-separated list of user names who are allowed to
+play in wizard
 mode (the debugging mode, not the magic-using role).  A value of a single
 asterisk (*) allows anyone to start a game in wizard mode.
 .lp
-SHELLERS
-A list of users who are allowed to use the shell escape command (!).  The
-syntax is the same as WIZARDS.
+SHELLERS\ =\ A list of users who are allowed to use the shell
+escape command (!).  The syntax is the same as WIZARDS.
 .lp
-EXPLORERS
-A list of users who are allowed to use the explore mode.  The
+EXPLORERS\ =\ A list of users who are allowed to use the explore mode.  The
 syntax is the same as WIZARDS.
 .lp
-MAXPLAYERS
-Limit the maximum number of games that can be running at the same time.
+MAXPLAYERS\ =\ Limit the maximum number of games that can be running
+at the same time.
 .lp
-SUPPORT
-A string explaining how to get local support (no default value).
+SUPPORT\ =\ A string explaining how to get local support (no default value).
 .lp
-RECOVER
-A string explaining how to recover a game on this system (no default value).
+RECOVER\ =\ A string explaining how to recover a game on this system
+(no default value).
 .lp
-SEDUCE
-0 or 1 to disable or enable, respectively, the SEDUCE option (see the source
-for details on this function).
+SEDUCE\ =\ 0 or 1 to disable or enable, respectively, the SEDUCE option.
+When disabled, incubi and succubi behave like nymphs.
 .lp
-CHECK_PLNAME
-Setting this to 1 will make the EXPLORERS, WIZARDS, and SHELLERS check
-for the player name instead of the user's login name.
+CHECK_PLNAME\ =\ Setting this to 1 will make the EXPLORERS, WIZARDS, and
+SHELLERS check for the player name instead of the user's login name.
 .lp
-CHECK_SAVE_UID
-0 or 1 to disable or enable, respectively, the UID checking for savefiles.
+CHECK_SAVE_UID\ =\ 0 or 1 to disable or enable, respectively, the UID
+(used identification number) checking for save files (to verify that the
+user who is restoring is the same one who saved).
 .pg
 The following options affect the score file:
 .pg
 .lp
-PERSMAX
-Maximum number of entries for one person.
+PERSMAX\ =\ Maximum number of entries for one person.
 .lp
-ENTRYMAX
-Maximum number of entries in the score file.
+ENTRYMAX\ =\ Maximum number of entries in the score file.
 .lp
-POINTSMIN
-Minimum number of points to get an entry in the score file.
+POINTSMIN\ =\ Minimum number of points to get an entry in the score file.
 .lp
-PERS_IS_UID
-0 or 1 to use user names or numeric userids, respectively, to identify
-unique people for the score file.
+PERS_IS_UID\ =\ 0 or 1 to use user names or numeric userids, respectively,
+to identify unique people for the score file.
 .lp
-MAX_STATUENAME_RANK
-Maximum number of score file entries to use for random statue names
-(default is 10).
+MAX_STATUENAME_RANK\ =\ Maximum number of score file entries to use for
+random statue names (default is 10).
 .hn 1
 Scoring
 .pg
index 5f13e784f7dd82b28b883abf5f130a51bcbd2cfb..8f2e601b4db821f83020a5ed5390dca3bf63236a 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{January 18, 2016}
+\date{February 22, 2016}
 
 \maketitle
 
@@ -346,6 +346,9 @@ do other tasks requiring agility or manipulation of objects.
 \item[\bb{Constitution}]
 Constitution affects your ability to recover from injuries and other
 strains on your stamina.
+When strength is low or modest, consitution also affects how much you
+can carry.  With sufficiently high strength, the contribution to
+carrying capacity from your constitution no longer matters.
 %.lp
 \item[\bb{Intelligence}]
 Intelligence affects your ability to cast spells and read spellbooks.
@@ -1599,7 +1602,8 @@ to your pack and tell you what you just picked up.
 As you add items to your inventory, you also add the weight of that object
 to your load.  The amount that you can carry depends on your strength and
 your constitution.  The
-stronger you are, the less the additional load will affect you.  There comes
+stronger and sturdier
+you are, the less the additional load will affect you.  There comes
 a point, though, when the weight of all of that stuff you are carrying around
 with you through the dungeon will encumber you.  Your reactions
 will get slower and you'll burn calories faster, requiring food more frequently
@@ -1897,10 +1901,10 @@ crystal plate mail     & 3 &                   & bronze plate mail     & 4\\
 splint mail            & 4 &                   & banded mail           & 4\\
 dwarvish mithril-coat  & 4 &                   & elven mithril-coat    & 5\\
 chain mail             & 5 &                   & orcish chain mail     & 6\\
-scale mail             & 6 &                   & studded leather armor & 7\\
-ring mail              & 7 &                   & orcish ring mail      & 8\\
-leather armor          & 8 &                   & leather jacket        & 9\\
-no armor               & 10
+scale mail             & 6 &                   & dragon scales         & 7\\
+studded leather armor  & 7 &                   & ring mail             & 7\\
+orcish ring mail       & 8 &                   & leather armor         & 8\\
+leather jacket         & 9 &                   & no armor              & 10\\
 \end{tabular}
 \end{center}
 
@@ -2015,11 +2019,13 @@ The command to drink a potion is `{\tt q}' (quaff).
 \subsection*{Wands (`{\tt /}')}
 
 %.pg
-Magic wands usually have multiple magical charges.  Some wands are
-directional---you must give a direction in which to zap them.  You can also
+Wands usually have multiple magical charges.
+Some types of wands require a direction in which to zap them.
+You can also
 zap them at yourself (just give a `{\tt .}' or `{\tt s}' for the direction).
-Be warned, however, for this is often unwise.  Other wands are
-nondirectional---they don't require a direction.  The number of charges in a
+Be warned, however, for this is often unwise.
+Other types of wands
+don't require a direction.  The number of charges in a
 wand is random and decreases by one whenever you use it.
 
 %.pg
@@ -2087,17 +2093,19 @@ energy and the time required in casting.
 %.pg
 Casting a spell calls forth magical energies and focuses them with
 your naked mind.  Some of the magical energy released comes from within
-you, and casting several spells in a row may tire you.
+you.
+Casting temporarily drains your magical power, which will slowly be
+recovered, and causes you to need additional food.
 Casting of spells also requires practice.  With practice, your
 skill in each category of spell casting will improve.  Over time, however,
 your memory of each spell will dim, and you will need to relearn it.
 
 %.pg
-Some spells are
-directional---you must give a direction in which to cast them.  You can also
-cast them at yourself (just give a `{\tt .}' or `{\tt s}' for the direction).
-Be warned, however, for this is often unwise.  Other spells are
-nondirectional---they don't require a direction.
+Some spells require a direction in which to cast them, similar to wands.
+To cast one at yourself, just give a `{\tt .}' or `{\tt s}' for the direction.
+A few spells require you to pick a target location rather than just specify
+a particular direction.
+Other spells don't require any direction or target.
 
 %.pg
 Just as weapons are divided into groups in which a character can become
@@ -2193,6 +2201,11 @@ heavy.  It is rumored that some statues are not what they seem.
 Very large humanoids (giants and their ilk) have been known to use boulders
 as weapons.
 
+%.pg
+For some configurations of the program, statues are no longer shown
+as `{\tt `}'
+but by the letter representing the monster they depict instead.
+
 %.hn 2
 \subsection*{Gold (`{\tt \$}')}
 
@@ -2447,7 +2460,7 @@ Persistent.
 Your starting alignment ({\tt align:lawful}, {\tt align:neutral},
 or {\tt align:chaotic}).  You may specify just the first letter.
 The default is to randomly pick an appropriate alignment.
-If you prefix `{\tt !}' or ``{\tt no}'' to the value, you can 
+If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
 exclude that alignment from being picked randomly.
 Cannot be set with the `{\tt O}' command.  Persistent.
 %.lp
@@ -2487,7 +2500,8 @@ Start the character permanently blind.  Persistent. (default false)
 Allow saving and loading bones files.  Persistent.  (default true)
 %.lp
 \item[\ib{boulder}]
-Set the character used to display boulders (default is rock class symbol).
+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}'').
@@ -2495,9 +2509,7 @@ Cannot be set with the `{\tt O}' command.
 %.lp character
 \item[\ib{character}]
 Pick your type of character (ex.\ ``{\tt character:Monk}'');
-synonym for ``{\it role\/}''.  See ``{\it name\/}'' for an alternate method
-of specifying your role.  Normally only the first letter of
-the value is examined; the string ``{\tt random}'' is an exception.
+synonym for ``{\it role\/}''.  See {\it role\/} for more details.
 %.lp
 \item[\ib{checkpoint}]
 Save game state after each level change, for possible recovery after
@@ -2506,7 +2518,9 @@ program crash (default on).  Persistent.
 \item[\ib{checkspace}]
 Check free disk space before writing files to disk (default on).
 You may have to turn this off if you have more than 2 GB free space
-on the partition used for your save and level files.
+on the partition used for your save and level files
+(because too much space might overflow the calculation and end up
+looking like insufficient space).
 Only applies when MFLOPPY was defined during compilation.
 %.lp
 \item[\ib{clicklook}]
@@ -2603,7 +2617,7 @@ You may specify just the first letter.  Although you can
 still denote your gender using the ``{\tt male}'' and ``{\tt female}''
 options, the ``{\tt gender}'' option will take precedence.
 The default is to randomly pick an appropriate gender.
-If you prefix `{\tt !}' or ``{\tt no}'' to the value, you can 
+If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
 exclude that gender from being picked randomly. 
 Cannot be set with the `{\tt O}' command.  Persistent.
 %.lp
@@ -2917,7 +2931,7 @@ become wielded.  Persistent.
 %.Ip
 \item[\ib{race}]
 Selects your race (for example, ``{\tt race:human}'').  Default is random.
-If you prefix `{\tt !}' or ``{\tt no}'' to the value, you can 
+If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
 exclude that race from being picked randomly. 
 Cannot be set with the `{\tt O}' command.  Persistent.
 %.lp
@@ -2930,9 +2944,10 @@ Pick your type of character (ex.\ ``{\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}'',
-and ``{\tt random}'' values. If you prefix `{\tt !}' or ``{\tt no}'' to the 
-value, you can exclude that role from being picked randomly.
-Persistent.
+and ``{\tt random}'' values.
+If you prefix the value with `{\tt !}' or ``{\tt no}'', you will
+exclude that role from being picked randomly.
+Cannot be set with the `{\tt O}' command.  Persistent.
 %.lp
 \item[\ib{roguesymset}]
 This option may be used to select one of the named symbol sets found within
@@ -3885,7 +3900,7 @@ mode (the debugging mode, not the magic-useing role). A value of a single
 asterisk (*) allows anyone to start a game in wizard mode.
 %.lp
 \item[\ib{SHELLERS}]
-A list of users who are allowed to use the shell escape command (!).
+A list of users who are allowed to use the shell escape command (`{\tt !}').
 The syntax is the same as WIZARDS.
 %.lp
 \item[\ib{EXPLORERS}]