Documentation polishing.

adventure.yaml

@@ -1835,6 +1835,8 @@ locations: !!omap
       {verbs: [DOWN], action: [goto, LOC_LOWROOM]},
       {verbs: [UPWAR], action: [goto, LOC_SWCHASM]},
     ]
+  # Following three rooms are where the dragon lives.  The code has a
+  # wired-in assumption that the dragon corpse goes to LOC_SECRET5,
 - LOC_SECRET4:
     description:
       long: 'You are in a secret canyon which exits to the north and east.'

main.c

@@ -433,9 +433,7 @@ static bool dwarfmove(void)
         }
     }
 
-    /*  Now we know what's happening.  Let's tell the poor sucker about it.
+    /*  Now we know what's happening.  Let's tell the poor sucker about it. */
-     *  Note that various of the "knife" messages must have specific relative
-     *  positions in the rspeak database. */
     if (game.dtotal == 0)
         return true;
     rspeak(game.dtotal == 1 ? DWARF_SINGLE : DWARF_PACK, game.dtotal);