Guidebook update; mostly paranoid_confirmation

add paranoid_confirmation:AutoAll
update paranoid_confirmation:pray (for paranoid_confirm:Confirm)
update paranoid_confirmation:swim (reorder, and on by default)

update menustyle:full (for paranoid_confirm:AutoAll)

Guidebook.tex is updated but not tested.

doc/Guidebook.mn

@@ -37,7 +37,7 @@
 .ds f0 "\*(vr
 .ds f1
 .\"DO NOT REMOVE NH_DATESUB .ds f2 "DATE(%B %-d, %Y)
-.ds f2 "June 8, 2023
+.ds f2 "June 25, 2023
 .
 .\" A note on some special characters:
 .\" \(lq = left double quote
@@ -924,7 +924,7 @@ If you're wearing more than one, you'll be prompted for which one to
 remove.
 When you're only wearing one, then by default it will be removed
 without asking, but you can set the
-.op paranoid_confirmation
+.op paranoid_confirmation:Remove
 option to require a prompt.
 .lp ""
 This command may also be used to take off armor.
@@ -979,7 +979,7 @@ and/or a shirt, or a suit covering a shirt, as if the underlying items
 weren't there.)
 When you're only wearing one, then by default it will
 be taken off without asking, but you can set the
-.op paranoid_confirmation
+.op paranoid_confirmation:Remove
 option to require a prompt.
 .lp ""
 This command may also be used to remove accessories.
@@ -2328,7 +2328,7 @@ moving into its location, you'll be asked to confirm your intent.
 By default an answer of \(oqy\(cq acknowledges that intent,
 which can be error prone if you're using \(oqy\(cq to move.
 You can set the
-.op paranoid_confirmation
+.op paranoid_confirmation:attack
 option to require a response of \(lqyes\(rq instead.
 .pg
 If you can't see a monster (if it is invisible, or if you are blinded),
@@ -4037,13 +4037,14 @@ Persistent.
 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
+Controls the method used when you need to choose various objects (in
-response to the Drop command, for instance).
+response to the \f(CRDrop\fP (aka \f(CRdroptype\fP) command, for instance).
 The value specified should be the first letter of one of the following:
 traditional, combination, full, or partial.
+Default is \f(CRfull\fP.
 Persistent.
 .lp ""
-Traditional was the only interface available for very
+Traditional was the only method 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).
@@ -4053,6 +4054,9 @@ prompting one-by-one.
 Full displays a menu of
 object classes rather than a character prompt, and then a menu of matching
 objects for selection.
+(Choosing its \(oqA\(cq (Autoselect-All) choice skips the second menu.
+To avoid choosing that by accident,
+set \f(CRparanoid_confirm:AutoAll\fP to require confirmation.)
 Partial skips the object class filtering and
 immediately displays a menu of all objects.
 .lp menu_deselect_all
@@ -4216,7 +4220,7 @@ prompting is desired.  The default is \(lqparanoid_confirmation:pray swim\(rq.
 .PL Confirm
 for any prompts which are set to require \(lqyes\(rq rather than \(oqy\(cq,
 also require \(lqno\(rq to reject instead of accepting any non-yes response
-as no
+as no; changes pray and AutoAll to require \(lqyes\(rq or \(oqno\(cq too;
 .PL quit
 require \(lqyes\(rq rather than \(oqy\(cq to confirm quitting
 the game or switching into non-scoring explore mode;
@@ -4227,31 +4231,41 @@ useful in normal play; applies to explore mode);
 require \(lqyes\(rq rather than \(oqy\(cq to confirm saving
 bones data when dying in debug mode;
 .PL attack
-require \(lqyes\(rq rather than \(oqy\(cq to confirm attacking a peaceful monster;
+require \(lqyes\(rq rather than \(oqy\(cq to confirm attacking
+a peaceful monster;
 .PL wand-break
-require \(lqyes\(rq rather than \(oqy\(cq to confirm breaking a wand;
+require \(lqyes\(rq rather than \(oqy\(cq to confirm breaking
+a wand with the \f(CRapply\fP command;
 .PL eating
-require \(lqyes\(rq rather than \(oqy\(cq to confirm whether to continue eating;
+require \(lqyes\(rq rather than \(oqy\(cq to confirm whether to
+continue eating;
 .PL Were-change
-require \(lqyes\(rq rather than \(oqy\(cq to confirm changing form due to lycanthropy
+require \(lqyes\(rq rather than \(oqy\(cq to confirm changing form due
-when hero has polymorph control;
+to lycanthropy when hero has polymorph control;
 .PL pray
 require \(oqy\(cq to confirm an attempt to pray rather
 than immediately praying; on by default;
+(to require \(lqyes\(rq rather than just \(oqy\(cq, set Confirm too);
+.PL swim
+prevent walking into water or lava; on by default; (to deliberately step
+onto/into such terrain when this is set, use the \(oq\f(CRm\fP\(cq
+movement prefix when adjacent);
+.PL AutoAll
+require confirmation when the \(oqA\(cq (Autoselect-All) choice is selected
+in object class filtering menus for \f(CRmenustyle:Full\fP;
+(to require \(lqyes\(rq rather than just \(oqy\(cq, set Confirm too);
 .PL Remove
 require selection from inventory for \(oqR\(cq and \(oqT\(cq
-commands even when wearing just one applicable item.
+commands even when wearing just one applicable item;
-.PL swim
-prevent walking into water or lava.
 .PL all
 turn on all of the above.
 .PE
-By default, the pray choice is enabled, the others disabled.
+By default, the pray and swim choices are enabled, the others disabled.
-To disable it without setting
+To disable them without setting
-any of the other choices, use \(lqparanoid_confirmation:none\(rq.
+any of the other choices, use \f(CRparanoid_confirmation:none\fP.
 To keep
-it enabled while setting any of the others, include it in the list,
+them enabled while setting any of the others, include them in the new list,
-such as \(lqparanoid_confirmation:attack pray Remove\(rq.
+such as \f(CRparanoid_confirmation:attack pray swim Remove\fP.
 .lp perm_invent
 If true, always display your current inventory in a window.  This only
 makes sense for windowing system interfaces that implement this feature.

doc/Guidebook.tex

@@ -46,7 +46,7 @@
 \author{Original version - Eric S. Raymond\\
 (Edited and expanded for 3.7.0 by Mike Stephenson and others)}
 %DO NOT REMOVE NH_DATESUB \date{DATE(%B %-d, %Y)}
-\date{June 8, 2023}
+\date{June 25, 2023}
 
 \maketitle
 
@@ -1024,7 +1024,7 @@ Remove a worn accessory (ring, amulet, or blindfold).\\
 If you're wearing more than one, you'll be prompted for which one to
 remove.  When you're only wearing one, then by default it will be removed
 without asking, but you can set the
-{\it paranoid\verb+_+confirmation\/}
+{\it paranoid\verb+_+confirmation:Remove\/}
 option to require a prompt.\\
 %.lp ""
 This command may also be used to take off armor.  The prompt for which
@@ -1082,7 +1082,7 @@ and/or a shirt, or a suit covering a shirt, as if the underlying items
 weren't there.)
 When you're only wearing one, then by default it will
 be taken off without asking, but you can set the
-{\it paranoid\verb+_+confirmation\/}
+{\it paranoid\verb+_+confirmation:Remove\/}
 option to require a prompt.\\
 %.lp ""
 This command may also be used to remove accessories.  The prompt
@@ -2572,7 +2572,7 @@ In most circumstances, if you attempt to attack a peaceful monster by
 moving into its location, you'll be asked to confirm your intent.  By
 default an answer of `{\tt y}' acknowledges that intent,
 which can be error prone if you're using `{\tt y}' to move.  You can set the
-{\it paranoid\verb+_+confirmation\/}
+{\it paranoid\verb+_+confirmation:attack\/}
 option to require a response of ``{\tt yes}'' instead.
 %.pg
 
@@ -4412,14 +4412,15 @@ Enable coloring menu lines (default off).
 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
+Controls the method used when you need to choose various objects (in
-response to the Drop command, for instance).
+response to the {\tt Drop} (aka {\tt droptype}) command, for instance).
 The value specified should be the first letter of one of the following:
 traditional, combination, full, or partial.
+Default is {\tt full}.
 Persistent.
 \\
 %.lp ""
-Traditional was the only interface available for very
+Traditional was the only method 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).
@@ -4429,6 +4430,9 @@ prompting one-by-one.
 Full displays a menu of
 object classes rather than a character prompt, and then a menu of matching
 objects for selection.
+(Choosing its `A' (Autoselect-All) choice skips the second menu.
+To avoid choosing that by accident,
+set {\it paranoid\verb+_+confirm:AutoAll\/} to require confirmation.)
 Partial skips the object class filtering and
 immediately displays a menu of all objects.
 \item[\ib{menu\verb+_+deselect\verb+_+all}]
@@ -4615,7 +4619,8 @@ are filled in at the end from the previous order.
 %.lp
 \item[\ib{paranoid\verb+_+confirmation}]
 A space separated list of specific situations where alternate
-prompting is desired.  The default is ``{\it paranoid\verb+_+confirmation:pray swim}''.
+prompting is desired.
+The default is ``{\it paranoid\verb+_+confirmation:pray swim}''.
 %.sd
 %.si
 \newlength{\pcwidth}
@@ -4623,9 +4628,9 @@ prompting is desired.  The default is ``{\it paranoid\verb+_+confirmation:pray s
 \addtolength{\pcwidth}{\labelsep}
 \blist{\leftmargin \pcwidth \topsep 1mm \itemsep 0mm}
 \item[{\tt Confirm}]
-for any prompts which are set to require ``yes''
+for any prompts which are set to require ``yes'' rather than `y',
-rather than `y', also require ``no'' to reject instead
+also require ``no'' to reject instead of accepting any non-yes response
-of accepting any non-yes response as no;
+as no; changes pray and AutoAll to require ``yes'' or ``no'' too;
 \item[{\tt quit~~~}]
 require ``{\tt yes}'' rather than `{\tt y}' to confirm quitting
 the game or switching into non-scoring explore mode;
@@ -4640,32 +4645,40 @@ require ``{\tt yes}'' rather than `{\tt y}' to confirm attacking
 a peaceful monster;
 \item[{\tt wand-break}]
 require ``{\tt yes}'' rather than `{\tt y}' to confirm breaking
-a wand;
+a wand with the {\it apply} command;
 \item[{\tt eating}]
 require ``{\tt yes}'' rather than `{\tt y}' to confirm whether to
 continue eating;
 \item[{\tt Were-change}]
-require ``{\tt yes}'' rather than `{\tt y}' to confirm changing form
+require ``{\tt yes}'' rather than `{\tt y}' to confirm changing form due
-due to lycanthropy
+to lycanthropy when hero has polymorph control;
-when hero has polymorph control;
 \item[{\tt pray~~~}]
 require `{\tt y}' to confirm an attempt to pray rather
 than immediately praying; on by default;
-\item[{\tt Remove~}] require selection from inventory for `{\tt R}'
+(to require ``yes'' rather than just `y', set Confirm too);
-and `{\tt T}'
-commands even when wearing just one applicable item.
 \item[{\tt swim~~~}]
-prevent walking into water or lava.
+prevent walking into water or lava; on by default; (to deliberately step
+onto/into such terrain when this is set, use the `{\tt m}'
+movement prefix when adjacent);
+\item[{\tt AutoAll}]
+require confirmation when the `A' (Autoselect-All) choice is selected
+in object class filtering menus for {\it menustyle:Full};
+(to require ``yes'' rather than just `y', set Confirm too);
+\item[{\tt Remove~}]
+require selection from inventory for `{\tt R}' and `{\tt T}'
+commands even when wearing just one applicable item;
 \item[{\tt all~~~~}]
 turn on all of the above.
 \elist
 %.ei
 %.ed
-By default, the pray choice is enabled, the others disabled.
+By default, the pray and swim choices are enabled, the others disabled.
-To disable it without setting
+To disable them without setting
-any of the other choices, use ``{\it paranoid\verb+_+confirmation:none}''.  To keep
+any of the other choices, use ``{\it paranoid\verb+_+confirmation:none}''.
-it enabled while setting any of the others, include it in the list,
+To keep
-such as ``{\it par\-a\-noid\verb+_+con\-fir\-ma\-tion:attack~pray~Remove}''.
+them enabled while setting any of the others, include them in the list,
+such as
+``{\it par\-a\-noid\verb+_+con\-fir\-ma\-tion:attack~pray~swim~Remove}''.
 %.lp
 \item[\ib{perm\verb+_+invent}]
 If true, always display your current inventory in a window.  This only