Update documentation.

David, could you please make sure the pdf files are up-to-date?


git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/branches/stone_soup-0.5@9925 c06c8d41-db1a-0410-9941-cceddc491573

4 files changed, 39 insertions, 39 deletions

diff --git a/crawl-ref/README.txt b/crawl-ref/README.txt
index e1ea2cf8d0..60cc344a13 100644
--- a/crawl-ref/README.txt
+++ b/crawl-ref/README.txt
@@ -24,7 +24,7 @@ There is a list of frequently asked questions which you can access pressing
 1. Getting started
 ------------------
 If you'd like to dive in immediately, your best bets are to
-* start up a game and choose a tutorial (press 'T' when asked for race), or
+* start a game and pick a tutorial (press 'Ctrl-T' when asked for species), or
 * read quickstart.txt (in the docs/ directory), or
 * for studious readers, browse the manual (see below for all doc files).
 
diff --git a/crawl-ref/docs/options_guide.txt b/crawl-ref/docs/options_guide.txt
index dee3660fee..c11d65026f 100644
--- a/crawl-ref/docs/options_guide.txt
+++ b/crawl-ref/docs/options_guide.txt
@@ -200,7 +200,6 @@ are as follows:
    weapon              = hand axe, for Berserkers
    book                = random, for Conjurers
 and, for Tiles,
-   tile_show_items     = !?/%=([)x}+\_.
    tile_tag_pref       = tutorial
 
 0-c     Aliases and variables.
diff --git a/crawl-ref/docs/tiles_help.txt b/crawl-ref/docs/tiles_help.txt
index f043482cc5..9edf241c77 100644
--- a/crawl-ref/docs/tiles_help.txt
+++ b/crawl-ref/docs/tiles_help.txt
@@ -11,13 +11,13 @@ case but to run the console version instead or switch to a different machine.
 
                   Tiles mouseclick item interaction
 
-If you're playing with Tiles compiled, you'll find several shortcuts to 
-regular commands using mouseclicks. 
+If you're playing with Tiles compiled, you'll find several shortcuts to
+regular commands using mouseclicks.
 
 
 PLAYER AVATAR
 
-left mouseclick            Pick up items on ground ('g' command). 
+left mouseclick            Pick up items on ground ('g' command).
                            A second click will take you to the pickup menu.
 
 right mouseclick           Character overview ('%' command).
@@ -31,44 +31,44 @@ INVENTORY MANAGEMENT
 
 left mouseclick            Execute the most common action for this item type.
 
-  weapons:        wield    ('w')
-  misc. items:    wield    ('w')
-  armour:         Wear     ('W')
-  food:           eat      ('e')
-  scroll, manual: read     ('r')
-  potion:         quaff    ('q')
-  jewellery:      Put on   ('P')
-  spellbook:      Memorise ('M')
-  missiles:       fire     ('f')
-  corpse:         eat      ('e'), for Vampires
+  weapon, deck:      wield    ('w')
+  armour:            Wear     ('W')
+  food:              eat      ('e')
+  scroll, manual:    read     ('r')
+  potion:            quaff    ('q')
+  jewellery:         Put on   ('P')
+  spellbook:         Memorise ('M')
+  missiles:          fire     ('f')
+  wand, misc. item:  evoke    ('V')
+  corpse:            eat      ('e'), for Vampires
 
 wielded items:
-  rod:            evoke    ('v')
-  misc. item:     evoke    ('v')
-  weapon, staff:  unwield  ('w-')
-  armour,
-  jewellery:      unwield  ('w-')
+  rod, deck:         evoke    ('v')
+  weapon, staff:     unwield  ('w-')
+  armour, jewellery: unwield  ('w-')
   others, as non-wielded
 
 worn items:
-  armour:         Take off ('T')
-  jewellery:      Remove   ('R')
+  armour:            Take off ('T')
+  jewellery:         Remove   ('R')
 
 Sometimes alternative denominators are used such as "draw a card"
 instead of evoke for decks of cards, or "drink blood" instead of eat.
 
+mouse-over                 Display item description in message area.
+
 right mouseclick           Display item information ('i' + item slot).
 
 Shift + left mouseclick    Drop item ('d').
 
 Shift + right mouseclick   Execute secondary action for some item types.
 
-  weapon:         fire    ('f')
-  non-weapon:     wield   ('w'), if corresponding spells memorised
+  weapon:            fire    ('f'), if throwable
+  non-weapon:        wield   ('w'), if corresponding spells memorised
 
 wielded items:
-  weapon:         fire    ('f')
-  anything else:  unwield ('w-')
+  weapon:            fire    ('f')
+  anything else:     unwield ('w-')
 
 
 NON-INVENTORY ITEM MANAGEMENT
@@ -79,15 +79,18 @@ right mouseclick           Display item information.
 
 Shift + left mouseclick    'c'hop up this corpse.
 
-Shift + right mouseclick   'e'at this food item.
+Shift + right mouseclick   'e'at this food item, drain this corpse.
 
 
 MAP INTERACTION
 
+mouse-over                 Display item/monster description in message area.
+
 left mouseclick            Move to adjacent square.
-                           Autotravel to reachable square if currently safe.
-                           Swap places with an adjacent ally.
                            Attack, if adjacent non-friendly monster.
+                           Swap places with an adjacent ally.
+                           Autotravel to reachable square if currently safe.
+                           Move one step closer to targeted grid, if unsafe.
 
 right mouseclick           Display grid information ('xv').
 
@@ -114,10 +117,7 @@ any mouseclick             Search / Rest for a while ('5')
 
 MENU INTERACTION
 
-any click on tiles         Select item.
+left mouseclick on line    Select item, inventory menus only.
 left mouseclick            Scroll to next page.
 right mouseclick           Escape (quit menu).
 
-At inscription prompt:
-left mouseclick            Autoinscribe artefact (where applicable).
-right mouseclick           Escape (quit menu).
diff --git a/crawl-ref/source/util/docs/README.tex b/crawl-ref/source/util/docs/README.tex
index 712058a700..6cef83fe62 100644
--- a/crawl-ref/source/util/docs/README.tex
+++ b/crawl-ref/source/util/docs/README.tex
@@ -60,11 +60,12 @@ standards.
 \subsection*{How to get started? (Information for new players)}
 
 If you'd like to dive in immediately, your best bets are to either
-start up a game and choose one of the tutorials (press \key{T} when 
-asked for race), or print \key{quickstart.pdf} (in the \key{docs} 
-directory). Studious readers might want to browse the manual  (see 
-below). Note that you can read both the quickstart text and the
-manual in-game; pressing \key{?} brings up a menu for that.
+start up a game and choose one of the tutorials (press \key{Ctrl-T} 
+when asked for species), or print \key{quickstart.pdf} (in the 
+\key{docs} directory). Studious readers might want to browse the 
+manual  (see below). Note that you can read both the quickstart 
+text and the manual in-game; pressing \key{?} brings up a menu for 
+that.
 
 \para
 
@@ -109,7 +110,7 @@ spent some time playing the game.
 The following files in the \key{docs} directory may be helpful, all of
 which can be read in-game (press \key{?}):
 \\
-\key{crawl\_manual.txt} is the full manual. It explains all races, classes, 
+\key{crawl\_manual.txt} is the full manual. It explains all species, jobs, 
 item types etc. If you do not delight in manuals, you can put off the 
 reading this file until later.
 \\