From f9438f6e530d9cd442ec16bda5af5be62bb185d5 Mon Sep 17 00:00:00 2001
From: Pasi Kallinen <paxed@alt.org>
Date: Mon, 13 Mar 2017 17:17:58 +0200
Subject: [PATCH] Document explicitly what m-prefix does to each command

---
 doc/Guidebook.mn  | 5 +++++
 doc/Guidebook.tex | 6 ++++++
 2 files changed, 11 insertions(+)

diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn
index cf0c5f73c..d9263acf9 100644
--- a/doc/Guidebook.mn
+++ b/doc/Guidebook.mn
@@ -929,6 +929,7 @@ dungeon level.  All levels with annotations are displayed by the
 ``#overview'' command. Autocompletes. Default key is 'M-A', and '^N' if number_pad is on.
 .lp #apply
 Apply (use) a tool such as a pick-axe, a key, or a lamp. Default key is 'a'.
+If the tool used acts on items on the floor, using the `m' prefix skips those items.
 .lp #attributes
 Show your attributes. Default key is '^X'.
 .lp #autopickup
@@ -957,6 +958,7 @@ Drop an item. Default key is 'd'.
 Drop specific item types. Default key is 'D'.
 .lp "#eat "
 Eat something. Default key is 'e'.
+The `m' prefix skips eating items on the floor.
 .lp #engrave
 Engrave writing on the floor. Default key is 'E'.
 .lp #enhance
@@ -1008,6 +1010,7 @@ Name a monster, an individual object, or a type of object.  Same as #call.
 Autocompletes. Default keys are 'N', 'M-n', and 'M-N'.
 .lp #offer
 Offer a sacrifice to the gods. Autocompletes. Default key is 'M-o'.
+The `m' prefix skips offering items on the altar.
 .lp ""
 You'll need to find an altar to have any chance at success.
 Corpses of recently killed monsters are the fodder of choice.
@@ -1029,6 +1032,7 @@ Test the panic routine. Autocompletes. Wizard-mode only.
 Pay your shopping bill. Default key is 'p'.
 .lp #pickup
 Pick up things at the current location. Default key is ','.
+The `m' prefix forces use of a menu.
 .lp #polyself
 Polymorph self. Autocompletes. Wizard-mode only.
 .lp #pray
@@ -1118,6 +1122,7 @@ Look at the timeout queue. Autocompletes. Wizard-mode only.
 .lp "#tip "
 Tip over a container (bag or box) to pour out its contents.
 Autocompletes. Default key is 'M-T'.
+The `m' prefix makes the command use a menu.
 .lp #travel
 Travel to a specific location on the map. Default key is '_'.
 Using the ``request menu'' prefix shows a menu of interesting targets in sight
diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex
index e2ea3bbf6..11c40a89a 100644
--- a/doc/Guidebook.tex
+++ b/doc/Guidebook.tex
@@ -1113,6 +1113,8 @@ and '{\tt \^{}N}' if {\it number\verb+_+pad\/} is on.
 \item[\tb{\#apply}]
 Apply (use) a tool such as a pick-axe, a key, or a lamp.
 Default key is '{\tt a}'.
+If the tool used acts on items on the floor, using the `{\tt m}' prefix
+skips those items.
 %.lp
 \item[\tb{\#attributes}]
 Show your attributes. Default key is '{\tt \^{}X}'.\\
@@ -1154,6 +1156,7 @@ Drop specific item types. Default key is '{\tt D}'.
 %.lp
 \item[\tb{\#eat}]
 Eat something. Default key is '{\tt e}'.
+The `{\tt m}' prefix skips eating items on the floor.
 %.lp
 \item[\tb{\#engrave}]
 Engrave writing on the floor. Default key is '{\tt E}'.
@@ -1230,6 +1233,7 @@ Autocompletes. Default keys are '{\tt N}', '{\tt M-n}', and '{\tt M-N}'.
 %.lp
 \item[\tb{\#offer}]
 Offer a sacrifice to the gods. Autocompletes. Default key is '{\tt M-o}'.\\
+The `{\tt m}' prefix skips offering items on the altar.
 %.lp ""
 You'll need to find an altar to have any chance at success.
 Corpses of recently killed monsters are the fodder of choice.
@@ -1257,6 +1261,7 @@ Pay your shopping bill. Default key is '{\tt p}'.
 %.lp
 \item[\tb{\#pickup}]
 Pick up things at the current location. Default key is '{\tt ,}'.
+The `{\tt m}' prefix forces use of a menu.
 %.lp
 \item[\tb{\#polyself}]
 Polymorph self. Autocompletes. Wizard-mode only.
@@ -1384,6 +1389,7 @@ Look at the timeout queue. Autocompletes. Wizard-mode only.
 \item[\tb{\#tip}]
 Tip over a container (bag or box) to pour out its contents.
 Autocompletes. Default key is '{\tt M-T}'.
+The `{\tt m}' prefix makes the command use a menu.
 %.lp
 \item[\tb{\#travel}]
 Travel to a specific location on the map. Default key is '{\tt _}'.
-- 
2.40.0