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.  :-}

diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn
index 56309501ffc9bfa0200bfe21aad4099818a8ea48..1d0baab22dc5ef3c7ef9e4ccbe88e7996289c77b 100644 (file)
--- a/doc/Guidebook.mn
+++ b/doc/Guidebook.mn
@@ -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 ""
+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 \(oqm\(cq prefix to skip checking for applicable objects on the floor
-and go straight to checking inventory,
+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.
-The prefix will
-make \(lq#travel\(rq command show a menu of interesting targets in sight.
+.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.

diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex
index e96fccc0308c2a374ae7da6c15889f7fc4fcd31b..fef2c8a4c2949655abd62f5a5b2b813015b43541 100644 (file)
--- a/doc/Guidebook.tex
+++ b/doc/Guidebook.tex
@@ -45,7 +45,7 @@
 %.au
 \author{Original version - Eric S. Raymond\\
 (Edited and expanded for 3.7 by Mike Stephenson and others)}
-\date{January 2, 2021}
+\date{January 6, 2021}
 
 \maketitle
 
@@ -725,20 +725,31 @@ 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 `{\tt m}' prefix to request operating
-via menu (to temporarily override the
+A few non-movement commands use the `{\tt m}' prefix to request
+operating via menu (to temporarily override the
 {\it menustyle:Traditional\/}
 option).
 Primarily useful for `{\tt ,}' (pickup) when there is only one class of
 objects present (where there won't be any ``what kinds of objects?'' prompt,
-so no opportunity to answer `{\tt m}' at that prompt).\\
+so no opportunity to answer `{\tt m}' at that prompt).
+\\
+%.lp ""
+The prefix will
+make ``{\tt \#travel}'' command show a menu of interesting targets in sight.
+It can also be used with the `{\tt $\backslash$}' (known, show a
+list of all discovered objects) and the `{\tt \`} (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
+{\it sortdiscoveries\/} option).
+\\
 %.lp ""
 A few other commands (eat food, offer sacrifice, apply tinning-kit) use
-the `{\tt m}' prefix to skip checking for applicable objects on the floor
-and go straight to checking inventory,
+the `{\tt m}' prefix to skip checking for applicable objects on
+the floor and go straight to checking inventory,
 or (for ``{\tt \#loot}'' to remove a saddle),
-skip containers and go straight to adjacent monsters. The prefix will
-make ``{\tt \#travel}'' command show a menu of interesting targets in sight.
+skip containers and go straight to adjacent monsters.
+\\
+%.lp ""
 In debug mode (aka ``wizard mode''), the `{\tt m}' prefix may also be
 used with the ``{\tt \#teleport}'' and ``{\tt \#wizlevelport}'' commands.
 %.lp
@@ -4052,10 +4063,13 @@ See ``{\it Configuring Menu Colors\/}'' on how to configure the colors.
 %.lp
 \item[\ib{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).
@@ -4067,7 +4081,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.
 \item[\ib{menu\verb+_+deselect\verb+_+all}]
 Menu character accelerator to deselect all items in a menu.
 Implemented by the Amiga, Gem, X11 and tty ports.