fix #K112 - fumbling vs autoopen

Report complained that having autoopen not work when fumbling was
inconvenient and mentioned that the "ouch! you bump into a door"
result didn't take any time.  This updates the documentation to
state that autoopen won't work while fumbling (so the inconvenient
behavior persists) but changes movement so that bumping into a door
now takes time.  (Despite "ouch!", it doesn't inflict any damage.)

Also, document the recently added autounlock option.

doc/Guidebook.mn

@@ -1,4 +1,4 @@
-.\" $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.345 $ $NHDT-Date: 1577050469 2019/12/22 21:34:29 $
+.\" $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.346 $ $NHDT-Date: 1578448653 2020/01/08 01:57:33 $
 .\"
 .\" This is an excerpt from the 'roff' man page from the 'groff' package.
 .\" NetHack's Guidebook.mn currently does *not* adhere to these guidelines.
@@ -24,7 +24,7 @@
 .ds vr "NetHack 3.7
 .ds f0 "\*(vr
 .ds f1
-.ds f2 "December 18, 2019
+.ds f2 "January 7, 2020
 .
 .\" A note on some special characters:
 .\" \(lq = left double quote
@@ -1607,30 +1607,75 @@ Any lit areas within your line of sight will be displayed;
 dark areas are only displayed if they are within one space of you.
 Walls and corridors remain on the map as you explore them.
 .pg
-Secret corridors are hidden.  You can find them with the \(oqs\(cq (search)
-command.
+Secret corridors are hidden and appear to be solid rock.
+You can find them with the \(oqs\(cq (search) command when adjacent
+to them.
+Multiple search attempts may be needed.
+When searching is successful, secret corridors become ordinary open
+corridor locations.
+Mapping magic reveals secret corridors, so converts them into ordinary
+corridors and shows them as such.
 .hn 2
 Doorways
 .pg
-Doorways connect rooms and corridors.  Some doorways have no doors;
-you can walk right through.  Others have doors in them, which may be
-open, closed, or locked.  To open a closed door, use the \(oqo\(cq (open)
+Doorways connect rooms and corridors.
+Some doorways have no doors; you can walk right through.
+Others have doors in them, which may be open, closed, or locked.
+To open a closed door, use the \(oqo\(cq (open)
 command; to close it again, use the \(oqc\(cq (close) command.
-.pg
-You can get through a locked door by using a tool to pick the lock
-with the \(oqa\(cq (apply) command, or by kicking it open with
-the \(oq\(haD\(cq (kick) command.
+By default the
+.op autoopen
+option is enabled, so simply attempting to walk onto a closed door's
+location will attempt to open it without needing \(oqo\(cq.
+Opening via
+.op autoopen
+will not work if you are \fIconfused\fP or \fIstunned\fP or suffer from
+the \fIfumbling\fP attribute.
 .pg
 Open doors cannot be entered diagonally; you must approach them
-straight on, horizontally or vertically.  Doorways without doors are
-not restricted in this fashion.
+straight on, horizontally or vertically.
+Doorways without doors are
+not restricted in this fashion except on one particular level
+.\" the rogue level
+(described by \(lq#overview\(rq as \(lqa primitive area\(rq).
 .pg
-Doors can be useful for shutting out monsters.  Most monsters cannot
-open doors, although a few don't need to (for example, ghosts can walk through
-doors).
+Unlocking magic exists but usually won't be available early on.
+You can get through a locked door without magic by first using an
+unlocking tool with the \(oqa\(cq (apply) command, and then opening it.
+By default the
+.op autounlock
+option is also enabled, so if you attempt to open (via \(oqo\(cq or
+.op autoopen)
+a locked door while carrying an unlocking tool, you'll be asked whether
+to use it on the door's lock.
+Alternatively, you can break a closed door (whether locked or not) down
+by kicking it via the \(oq\(haD\(cq (kick) command.
+Kicking down a door destroys it and makes a lot of noise which might
+wake sleeping monsters.
 .pg
-Secret doors are hidden.  You can find them with the \(oqs\(cq (search)
-command.  Once found they are in all ways equivalent to normal doors.
+Some closed doors are booby-trapped and will explode if an attempt is made
+to open (when unlocked) or unlock (when locked) or kick down.
+Like kicking, an explosion destroys the door and makes a lot of noise.
+The \(lq#untrap\(rq command can be used to search a door for traps but
+might take multiple attempts to find one.
+When one is found, you'll be asked whether to try to disarm it.
+If you accede, success will eliminate the trap but
+failure will set off the trap's explosion.
+(If you decline, you effectively forget that a trap was found there.)
+.pg
+Closed doors can be useful for shutting out monsters.
+Most monsters cannot open closed doors, although a few don't need to
+(for example, ghosts can walk through doors and fog clouds can flow
+under them).
+Some monsters who can open doors can also use unlocking tools.
+And some (giants) can smash doors.
+.pg
+Secret doors are hidden and appear to be ordinary wall (from inside a
+room) or solid rock (from outside).
+You can find them with the \(oqs\(cq (search) command but it might
+take multiple tries.
+Once found they are in all ways equivalent to normal doors.
+Mapping magic does not reveal secret doors.
 .hn 2
 Traps (\(oq\(ha\(cq)
 .pg
@@ -2901,11 +2946,14 @@ The
 option controls whether the description includes map coordinates.
 .lp autodig
 Automatically dig if you are wielding a digging tool and moving into a place
-that can be dug (default false). Persistent.
+that can be dug (default false).
+Persistent.
 .lp autoopen
-Walking into a door attempts to open it (default true). Persistent.
+Walking into a closed door attempts to open it (default true).
+Persistent.
 .lp "autopickup  "
-Automatically pick up things onto which you move (default on). Persistent.
+Automatically pick up things onto which you move (default on).
+Persistent.
 See
 .op pickup_types
 to refine the behavior.
@@ -2922,6 +2970,11 @@ with the \(oqQ\(cq command instead.
 If no weapon is found or the option is
 false, the \(oqt\(cq (throw) command is executed instead.
 Persistent.
+.lp autounlock
+Walking into a locked door or looting a locked container while carrying
+an unlocking tool (such as a key) will ask whether to use that tool to
+unlock the door or container (default true).
+Persistent.
 .lp blind
 Start the character permanently blind (default false).
 Persistent.