Guidebook update

Document m\ and m`.

Several years ago there was a suggestion--aka complaint--that
"menustyle:Traditional was the only alternative for early versions"
was too vague and requested that the version be included.  It was
probably accurate at the time it was included, but I've changed it
from "early versions" to "very early versions" now.  :-}
This commit is contained in:
PatR
2021-01-06 18:54:42 -08:00
parent 7ba7873a41
commit 39fbf083a2
2 changed files with 52 additions and 31 deletions

View File

@@ -1,4 +1,4 @@
.\" $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.411 $ $NHDT-Date: 1609636060 2021/01/03 01:07:40 $
.\" $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.412 $ $NHDT-Date: 1609988081 2021/01/07 02:54:41 $
.\"
.\" This is an excerpt from the 'roff' man page from the 'groff' package.
.\" Guidebook.mn currently does *not* fully adhere to these guidelines.
@@ -35,7 +35,7 @@
.ds vr "NetHack 3.7
.ds f0 "\*(vr
.ds f1
.ds f2 "January 2, 2021
.ds f2 "January 6, 2021
.
.\" A note on some special characters:
.\" \(lq = left double quote
@@ -633,22 +633,29 @@ Go in that direction until you hit a wall or run into something.
Prefix: move without picking up objects or fighting (even if you remember
a monster there).
.lp ""
A few non-movement commands use the \(oqm\(cq prefix to request operating
via menu (to temporarily override the
A few non-movement commands use the \(oq\f(CRm\fP\(cq prefix to request
operating via menu (to temporarily override the
.op menustyle:Traditional
option).
Primarily useful for \(oq,\(cq (pickup) when there is only one class of
objects present (where there won't be any \(lqwhat kinds of objects?\(rq
prompt,
so no opportunity to answer \(oqm\(cq at that prompt).
Primarily useful for \(oq\f(CR,\fP\(cq (pickup) when there is only one class
of objects present (where there won't be any \(lqwhat kinds of objects?\(rq
prompt, so no opportunity to answer \(oqm\(cq at that prompt).
.lp ""
A few other commands (eat food, offer sacrifice, apply tinning-kit) use
the \(oqm\(cq prefix to skip checking for applicable objects on the floor
and go straight to checking inventory,
or (for \(lq#loot\(rq to remove a saddle),
skip containers and go straight to adjacent monsters.
The prefix will
make \(lq#travel\(rq command show a menu of interesting targets in sight.
It can also be used with the \(oq\f(CR\\\fP\(cq (known, show a
list of all discovered objects) and the \(oq\f(CR\`\fP\(cq (knownclass,
show a list of discovered objects in a particular class) commands to offer
a menu of several sorting alternatives (which sets a new value for the
.op sortdiscoveries
option).
.lp ""
A few other commands (eat food, offer sacrifice, apply tinning-kit) use
the \(oq\f(CRm\fP\(cq prefix to skip checking for applicable objects on
the floor and go straight to checking inventory,
or (for \(lq#loot\(rq to remove a saddle),
skip containers and go straight to adjacent monsters.
.lp ""
In debug mode (aka \(lqwizard mode\(rq), the \(oqm\(cq prefix may also be
used with the \(lq#teleport\(rq and \(lq#wizlevelport\(rq commands.
.lp F[yuhjklbn]
@@ -3748,10 +3755,12 @@ Enable coloring menu lines (default off).
See \(lqConfiguring Menu Colors\(rq on how to configure the colors.
.lp menustyle
Controls the interface used when you need to choose various objects (in
response to the Drop command, for instance). The value specified should
be the first letter of one of the following: traditional, combination,
full, or partial.
Traditional was the only interface available for
response to the Drop command, for instance).
The value specified should be the first letter of one of the following:
traditional, combination, full, or partial.
Persistent.
.lp ""
Traditional was the only interface available for very
early versions; it consists of a prompt for object class characters,
followed by an object-by-object prompt for all items matching the selected
object class(es).
@@ -3763,7 +3772,6 @@ object classes rather than a character prompt, and then a menu of matching
objects for selection.
Partial skips the object class filtering and
immediately displays a menu of all objects.
Persistent.
.lp menu_deselect_all
Menu character accelerator to deselect all items in a menu.
Implemented by the Amiga, Gem, X11 and tty ports.