diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn index 56309501f..1d0baab22 100644 --- 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 "" -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. diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex index e96fccc03..fef2c8a4c 100644 --- 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.