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
@@ -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).
|
||||
|
||||
@@ -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).
|
||||
|
||||
3796
doc/Guidebook.txt
3796
doc/Guidebook.txt
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user