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

@@ -5,7 +5,7 @@
.ds vr "NetHack 3.6
.ds f0 "\*(vr
.ds f1
.ds f2 "December 16, 2015
.ds f2 "January 18, 2016
.\" labeled paragraph start (should be part of tmac.n, but I don't want to
.\" make changes to that file)
.\" .PS word
@@ -476,7 +476,8 @@ helpful texts. Here are the commands for your reference:
.lp ?
Help menu: display one of several help texts available.
.lp /
Tell what a symbol represents. You may choose to specify a location
The ``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 `.', `,', `;',
@@ -485,14 +486,31 @@ conditionally check for ``More info?'' depending upon whether the
.op help
option is on, and then you will be asked to pick another location;
`,' will explain the symbol but skip any additional
information; `;' will skip additional info and also not bother asking
information, then let you pick another location;
`;' will skip additional info and also not bother asking
you to choose another location to examine; `:' will show additional
info, if any, without asking for confirmation. When picking a location,
pressing the ESC key will terminate this command, or pressing `?'
will give a brief reminder about how it works.
.pg
.lp ""
If the
.op autodescribe
option is on, a short description of what you see at each location is
shown as you move the cursor. Typing `#' while picking a location will
toggle that option on or off.
The
.op whatis_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
.op whatis_coord
option controls which format of map coordinate is included with their
descriptions.
.lp &
Tell what a command does.
.lp <
@@ -1995,7 +2013,9 @@ exclude that alignment from being picked randomly.
Cannot be set with the `O' command. Persistent.
.lp autodescribe
Automatically describe the terrain under cursor when asked to get a location
on the map.
on the map. The
.op whatis_coord
option controls whether the description includes map coordinates.
.lp autodig
Automatically dig if you are wielding a digging tool and moving into a place
that can be dug (default false). Persistent.
@@ -2125,11 +2145,6 @@ The default is to randomly pick an appropriate gender.
If you prefix a `!' or ``no'' to the value, you can
exclude that gender from being picked randomly.
Cannot be set with the `O' command. Persistent.
.lp getpos_coord
When using the `/' command to look around on the map with
``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 "help "
If more information is available for an object looked at
with the `/' command, ask if you want to see it (default on). Turning help
@@ -2514,6 +2529,27 @@ prevent the game from attempting unintended moves if you make inadvertent
mouse clicks on the map window. Persistent.
.lp verbose
Provide more commentary during the game (default on). Persistent.
.lp whatis_coord
When using the `/' or `;' commands to look around on the map with
.op 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
.CC c "compass ('east' or '3s' or '2n,4w');"
.CC m "map <x,y> (map column x=0 is not used);"
.CC s "screen [row,column] (row is offset to match tty usage);"
.CC n "none (no coordinates shown) [default]."
.ei
.ed
.lp ""
The
.op whatis_coord
option is also used with
the `/m', `/M', `/o', and `/O' sub-commands of `/',
where the `none' setting is overridden with `map'.
.lp windowtype
Select which windowing system to use, such as ``tty'' or ``X11''
(default depends on version).