Yikes, so many files! And all I did was add more item evaluation

functions for menu colouring and pickup...

Added: emergency_item, good_item, dangerous_item, bad_item, and
       useless_item, all taking into account player species and
       mutations, so e.g. =see invisible is useless for Naga,
       and !poison is always bad but only useless if you don't
       know Evaporate.

Never autopickup useless, dangerous (e.g. ?immolation) or inedible items, 
and simplify the item colour/pickup options accordingly. I'll have to
see if pickup.lua is still even needed after this.

Removed the menu_colour_prefix_id option as I can't see any reason to
turn it off.

Oh, and fixed a bug where Kenku were unable to stop levitating if they
gained level 15 while levitating.


git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@5658 c06c8d41-db1a-0410-9941-cceddc491573

1 files changed, 32 insertions, 11 deletions

diff --git a/crawl-ref/docs/options_guide.txt b/crawl-ref/docs/options_guide.txt
index 8f802a6853..ea12dd225f 100644
--- a/crawl-ref/docs/options_guide.txt
+++ b/crawl-ref/docs/options_guide.txt
@@ -1221,17 +1221,38 @@ menu_colour = <match>:<colour>:<regex>
            stash         (the results from Ctrl-F)
 
         Crawl has a couple of prefixes defined to make inventory colouring
-        easier. These are:
-           inedible      (you cannot eat this or get no nutrition from it)
-           poisonous     (chunks/corpses that are poisonous)
-           mutagenic     (chunks/corpses that are mutagenic)
-           contaminated  (chunks/corpses that may cause sickness, but
-                          ignored for Kobolds, Ogres, Trolls, and Ghouls)
-           rot-inducing  (chunks/corpses that cause rotting)
-           equipped      (equipped items)
-           artefact      (item is an artefact, whether identified or not)
-           evil_item     (item is hated by the good gods)
-           evil_eating   (eating this item is punished by the good gods)
+        easier. These are, in order of definition:
+           identified      (The item is fully identified.)
+           known           (You recognize the item's subtype.)
+           unidentified    (You don't recognize the item's subtype.)
+
+        The following only apply to items whose subtype is known.
+           evil_item       (Your god would hate it if you used this item.)
+
+           emergency_item  (This item is invaluable in emergencies.)
+           good_item       (This item is generally a good item.)
+           dangerous_item  (Using this item can be dangerous.)
+           bad_item        (This item is generally a bad item.)
+           useless_item    (This item is of no use to you.)
+
+           evil_eating     (Eating this item is punished by the good gods.)
+           inedible        (You cannot eat this or get no nutrition from it.)
+           poisonous       (Chunks/corpses that are poisonous)
+           mutagenic       (Chunks/corpses that are mutagenic)
+           contaminated    (Chunks/corpses that may cause sickness, but
+                            ignored for Kobolds, Ogres, Trolls, and Ghouls.)
+           rot-inducing    (Chunks/corpses that cause rotting.)
+
+           equipped        (Equipped items.)
+           artefact        (For artefacts, whether identified or not.)
+
+        When looking for menu_colour matches, these prefixes are prepended to 
+        the actual item name, e.g. in the form of
+           identified, evil_item wand of draining (4)
+           unidentified, equipped, artefact sparkling ring
+
+        If you want to colour all items that contain a certain prefix, use
+          menu_colour = lightgreen:.*poisonous.*
 
         To colour worn stuff and highlight cursed items, take
           menu_colour = inventory:lightred:equipped.* cursed