whatis_coord - rename 'getpos_coord' option

Rename the option for adding coordinates to autodescribe feedback for
the '/' and ';' commands from 'getpos_coord' to 'whatis_coord', after
the '/' command that uses it instead of after the internal routine
that implements it.  The 'whatis' name was only in dat/hh as far as I
could find, so this changes it to 'what-is' and also updates dat/help
and the Guidebook to mention the name too.

Add a 'screen' choice to the option to show coordinates as row,column
rather than x,y or compass direction(s).  Revise the /m, /M, /o, /O
operations of 'what-is' to honor the whatis_coord option (mostly; a
value of 'none' gets overridden by 'map' to force coordinates).

Also, update the description of the functionality of the '/' command
in the Guidebook.  The .mn version is tested, the .tex one isn't.
This commit is contained in:
PatR
2016-01-18 19:27:53 -08:00
parent 8cd65daf39
commit 83a4234292
11 changed files with 2174 additions and 1949 deletions

View File

@@ -45,7 +45,7 @@
%.au
\author{Original version - Eric S. Raymond\\
(Edited and expanded for 3.6 by Mike Stephenson and others)}
\date{December 16, 2015}
\date{January 18, 2016}
\maketitle
@@ -586,24 +586,44 @@ helpful texts. Here are the commands for your reference:
Help menu: display one of several help texts available.
%.lp
\item[\tb{/}]
Tell what a symbol represents. You may choose to specify a location
The {\tt what-is} command, to
tell what a symbol represents. You may choose to specify a location
or type a symbol (or even a whole word) to explain.
Specifying a location is done by moving the cursor to a particular spot
on the map and then pressing one of `{\tt .}', `{\tt ,}', `{\tt ;}',
or `{\tt :}'. `{\tt .}' will explain the symbol at the chosen location,
information, then let you pick another location;
conditionally check for ``{\tt More info?}'' depending upon whether the
{\it help\/}
`{\it help\/}'
option is on, and then you will be asked to pick another location;
`{\tt ,}' will explain the symbol but skip any additional
information; `{\tt ;}' will skip additional info and also not bother asking
`{\tt ;}' will skip additional info and also not bother asking
you to choose another location to examine; `{\tt :}' will show additional
info, if any, without asking for confirmation. When picking a location,
pressing the {\tt ESC} key will terminate this command, or pressing `{\tt ?}'
will give a brief reminder about how it works.
%.pg
%.lp ""
If the
{\it autodescribe\/}
option is on, a short description of what you see at each location is
shown as you move the cursor. Typing `{\tt #}' while picking a location will
toggle that option on or off.
The
{\it whatis\verb+_+coord\/}
option controls whether the short description includes map coordinates.
%.lp ""
Specifying a name rather than a location
always gives any additional information available about that name.
%.lp ""
You may also request a description of nearby monsters,
all monsters currently displayed, nearby objects, or all objects.
The
{\it whatis\verb+_+coord\/}
option controls which format of map coordinate is included with their
descriptions.
%.lp
\item[\tb{\&}]
Tell what a command does.
@@ -802,7 +822,7 @@ 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.
The behavior can be varied via the {\it msg\verb+_+window\/} option.
%.lp
\item[\tb{q}]
Quaff (drink) something (potion, water, etc).
@@ -2407,7 +2427,9 @@ 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.
on the map. The
{\it whatis\verb+_+coord\/}
option controls whether the description includes map coordinates.
%.lp
\item[\ib{autodig}]
Automatically dig if you are wielding a digging tool and moving into a place
@@ -2548,7 +2570,7 @@ Name a fruit after something you enjoy eating (ex.\ ``{\tt fruit:mango}'')
{\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
melons already exist in {\it NetHack}, so don't use those.
%.Ip
%.lp
\item[\ib{gender}]
Your starting gender ({\tt gender:male} or {\tt gender:female}).
You may specify just the first letter. Although you can
@@ -2559,12 +2581,6 @@ If you prefix `{\tt !}' or ``{\tt no}'' to the value, you can
exclude that gender from being picked randomly.
Cannot be set with the `{\tt O}' command. Persistent.
%.lp
\item[\ib{getpos\verb+_+coord}]
When using the `{\tt /}' command to look around on the map with
``{\tt autodescribe}'' on, display coordinates after the description.
The value specified should be the first letter of one of the following:
compass, map, or none. Default is none.
%.lp
\item[\ib{help}]
If more information is available for an object looked at
with the `{\tt /}' command, ask if you want to see it (default on).
@@ -3015,6 +3031,32 @@ mouse clicks on the map window. Persistent.
\item[\ib{verbose}]
Provide more commentary during the game (default on). Persistent.
%.lp
\item[\ib{whatis\verb+_+coord}]
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.
%.lp ""
The possibile settings are:
%.sd
%.si
{\tt c} --- \verb#compass ('east' or '3s' or '2n,4w')#;
{\tt m} --- \verb#map <x,y> (map column x=0 is not used)#;
{\tt s} --- \verb#screen [row,column] (row is offset to match tty usage)#;
{\tt n} --- \verb#none (no coordinates shown) [default]#.
%.ei
%.ed
%.lp ""
+The
{\it whatis\verb+_+coord\/}
option is also used with
the `{\tt /m}', `{\tt /M}', `{\tt /o}', and `{\tt /O}' sub-commands
of `{\tt /}',
where the `{\it none\/}' setting is overridden with `{\it map}'.
%.lp
\item[\ib{windowtype}]
Select which windowing system to use, such as ``{\tt tty}'' or ``{\tt X11}''
(default depends on version).