From: PatR Date: Thu, 7 Jan 2021 02:54:42 +0000 (-0800) Subject: Guidebook update X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=39fbf083a236053994e235f523b7b5d8f253ad54;p=nethack 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 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 "" +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 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.