Guidebook update: map display of mons and objs

Mostly add a paragraph clarifying the classification of WONTFIX for
a reported bug ('I' unseen monster clobbers remembered object at the
location).  It felt like it needed a parallel paragraph for monsters.

diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn
index cf6b8aaa65c79d5cf0bdb63afe53a626de5b2c12..f84612b59520ceb9dee10f1c4c872b4a7ffa407e 100644 (file)
--- a/doc/Guidebook.mn
+++ b/doc/Guidebook.mn
@@ -1,4 +1,4 @@
-.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.259 $ $NHDT-Date: 1524208826 2018/04/20 07:20:26 $
+.\" $NHDT-Branch: NetHack-3.6.0 $:$NHDT-Revision: 1.261 $ $NHDT-Date: 1524452470 2018/04/23 03:01:10 $
 .\"
 .\" This is an excerpt from the 'roff' man page from the 'groff' package.
 .\" NetHack's Guidebook.mn currently does *not* adhere to these guidelines.
@@ -1644,6 +1644,21 @@ however, they are likely to be cursed.  Beware of whatever killed the
 former player; it is probably still lurking around, gloating over its
 last victory.
 .
+.hn 2
+Persistence of Monsters
+.pg
+Monsters (a generic reference which includes humans and pets) are only
+shown while they can be seen or otherwise sensed.
+Moving to a location where you can't see or sense a monster any more
+will result in it disappearing from your map.
+.pg
+However, if you encounter a monster which you can't see or sense \(em
+perhaps it is invisible and has just tapped you on the noggin \(em
+a special ``remembered, unseen monster'' marker will be displayed at
+the location where you think it is.  That will persist until you have
+proven that there is no monster there, even if the unseen monster
+moves to another location or dies.
+.
 .hn 1
 Objects
 .pg
@@ -2189,6 +2204,30 @@ There are a number
 of monsters in the dungeon that may be influenced by the amount of gold
 you are carrying (shopkeepers aside).
 .
+.hn 2
+Persistence of Objects
+.pg
+Normally, if you have seen an object at a particular map location and
+move to another location which can't directly see that object any
+more, if will continue to be displayed on your map.
+That remains the case even if it is not actually there any more \(em
+perhaps a monster has picked it up or it has rotted away \(em
+until you can see or feel that location again.
+One notable exception is that if the object gets covered by the
+``remembered, unseen monster'' marker and that marker is later removed
+after you've verified that no monster is there, you will forget that
+there was any object there regardless of whether the unseen monster
+actually took the object.
+If the object is still there, then once you see or feel that location
+again you will re-discover the object and resume remembering it.
+.pg
+The situation is the same for a pile of objects, except that only the
+top item of the pile is displayed.
+The
+.op hilite_pile
+option can be enabled in order to show an item differently when is
+the top one of a pile.
+.
 .hn 1
 Conduct
 .pg

diff --git a/doc/Guidebook.tex b/doc/Guidebook.tex
index 625d3235340e869c352f5d9cf85536bb3d871d27..b28c732e849e849120cacc8aeb500e2791c70fec 100644 (file)
--- a/doc/Guidebook.tex
+++ b/doc/Guidebook.tex
@@ -1915,6 +1915,23 @@ however, they are likely to be cursed.  Beware of whatever killed the
 former player; it is probably still lurking around, gloating over its
 last victory.
 
+%.hn 2
+\subsection*{Persistence of Monsters}
+
+%.pg
+Monsters (a generic reference which includes humans and pets) are only
+shown while they can be seen or otherwise sensed.
+Moving to a location where you can't see or sense a monster any more
+will result in it disappearing from your map.
+
+%.pg
+However, if you encounter a monster which you can't see or sense--
+perhaps it is invisible and has just tapped you on the noggin--
+a special ``remembered, unseen monster'' marker will be displayed at
+the location where you think it is.  That will persist until you have
+proven that there is no monster there, even if the unseen monster
+moves to another location or dies.
+
 %.hn 1
 \section{Objects}
 
@@ -2545,6 +2562,32 @@ There are a number
 of monsters in the dungeon that may be influenced by the amount of gold
 you are carrying (shopkeepers aside).
 
+%.hn 2
+\subsection*{Persistence of Objects}
+
+%.pg
+Normally, if you have seen an object at a particular map location and
+move to another location which can't directly see that object any
+more, if will continue to be displayed on your map.
+That remains the case even if it is not actually there any more--
+perhaps a monster has picked it up or it has rotted away--
+until you can see or feel that location again.
+One notable exception is that if the object gets covered by the
+``remembered, unseen monster'' marker and that marker is later removed
+after you've verified that no monster is there, you will forget that
+there was any object there regardless of whether the unseen monster
+actually took the object.
+If the object is still there, then once you see or feel that location
+again you will re-discover the object and resume remembering it.
+
+%.pg
+The situation is the same for a pile of objects, except that only the
+top item of the pile is displayed.
+The
+{\it hilite\verb+_+pile\/}
+option can be enabled in order to show an item differently when is
+the top one of a pile.
+
 %.hn 1
 \section{Conduct}