Outsource randart names.

Also:
- Move database text files into subfolder "database", yay!
- Don't print "uncursed" for identified randart weapons/jewellery 
  as the status should be obvious once the name is known.
- A bit of code cleanup (change in enum.h breaks saves!)


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

1 files changed, 115 insertions, 0 deletions

diff --git a/crawl-ref/source/dat/database/help.txt b/crawl-ref/source/dat/database/help.txt
new file mode 100644
index 0000000000..e21ab52078
--- /dev/null
+++ b/crawl-ref/source/dat/database/help.txt
@@ -0,0 +1,115 @@
+%%%%
+stash-search.prompt
+
+<h>Searching the stash-tracker</h>
+
+You can search for items and dungeon features by name (or a substring of the
+name). In the list of search results, you can select a search result by its
+hotkey to travel to its location.
+
+You can also examine shops and items in the search results by pressing <w>?</w>
+and then hitting the hotkey for the search result. This will show you a
+description of the item or the contents of the shop.
+
+Some examples of search strings:
+<w>cure mutation</w> find all potions of cure mutation, including potions
+              in shops.
+<w>cloak</w>         find all cloaks in the dungeon.
+<w>Lair:2</w>        find everything known to be on Lair:2.
+<w>Lair:[2-4]</w>    finds everything on Lair:2-4. Regexes are allowed! Note
+              that Lair:[3-10] will not work as intended, since [x-y] is
+              a regex character range.
+<w>.</w>             is a shortcut to find everything on your current level.
+<w>Lair.*axe</w> 
+or
+<w>axe && Lair</w>   both show all axes in the Lair.
+
+The stash search string is case-insensitive.
+
+
+<h>Searching by item properties:</h>
+
+You can search for spell names (such as <w>Ignite Poison</w>) to find spellbooks
+or rods that contain the spell.
+
+You can search for artefact item properties (such as <w>prevents.*teleport</w>)
+to find artefacts that have the property.
+
+If you're using stash.lua, you can also search by some additional item 
+properties:
+<w>artefact</w> will find identified artefacts.
+Skill names (such as <w>Polearms</w> or <w>Long Blades</w>) will find all
+weapons that train that skill.
+
+If you're using stash.lua and have set annotate_item_class = true in your
+init.txt, you can also search by item types such as <w>book</w> or
+<w>jewellery</w>.
+
+
+<h>Finding Dungeon Features:</h>
+
+You can search for dungeon features by name: all shops will be found by a 
+search for <w>shop</w> (including shops that do not have "shop" in their name); 
+other dungeon features can also be found by name: <w>fountain</w>, <w>axe trap</w>,
+<w>altar</w>, etc. You can also search for altars by deity name: <w>Zin</w>.
+
+
+<h>Non-regex operators:</h>
+
+You can use !! to negate a search string, && for a boolean AND, || for
+boolean OR, and <<<< >> for grouping.
+
+For instance, to find rings (jewellery) but not ring mail you could use:
+<w>ring && !!mail</w>
+%%%%
+level-map
+
+<h>Level Map ('<w>X</w><h>' in the main screen):
+<w>Esc</w>    : Leave level map (also <w>Space</w> or any unused key).
+<w>Dir.</w>   : Move the cursor.
+<w>/ Dir.</w> : Move the cursor in larger steps (also <w>Shift-Dir.</w>).
+<w>-</w>/<w>+</w>    : Scroll level map up/down
+<w>.</w>      : Start travel (also <w>Enter</w> and <w>,</w> and <w>;</w>).
+                (Moves cursor to the last travel destination if still on @.)
+<w><<</w>/<w>></w>    : Cycle through up/down stairs.
+<w>^</w>      : Cycle through traps.
+<w>Tab</w>    : Cycle through shops and portals.
+<w>X</w>      : Cycle through travel eXclusions.
+<w>x</w>      : Change the radius of a travel exclusion in three steps.
+<w>W</w>      : Cycle through waypoints.
+<w>*</w>      : Cycle forward through stashes (by default, all items).
+<w>/</w>      : Cycle backward through stashes (by default, all items).
+<w>_</w>      : Cycle through altars.
+<w>Ctrl-X</w> : Set travel exclusion.
+<w>Ctrl-E</w> : Erase all travel exclusions.
+<w>Ctrl-W</w> : Set waypoint.
+<w>Ctrl-C</w> : Clear level and main maps.
+<w>Ctrl-F</w> : Forget level map.
+%%%%
+interlevel-travel.branch.prompt
+
+<h>Interlevel Travel (choose a branch):
+ Use the shortcut letter for a branch to select the branch for travel.
+
+ Once you select a branch, you will be prompted for a depth in that
+ branch (more help is available there).
+
+ <w>Enter</w>  : Repeat last interlevel travel.
+ <w>.</w>      : Travel to a level in the current branch.
+ <w><<</w>      : Go up the nearest stairs.
+ <w>></w>      : Go down the nearest stairs.
+ <w>Ctrl-P</w> : Travel to a level in the branch above this one.
+ <w>*</w>      : Show available waypoints (if any are set).
+ <w>0</w>-<w>9</w>    : Go to the numbered waypoint.
+%%%%
+interlevel-travel.depth.prompt
+
+<h>Interlevel Travel (go to a specific level in the selected branch)
+ Type in the level number you want to go to and hit Enter, or use:
+ <w>Enter</w>  : Go to the default level.
+ <w><<</w>      : Change the default to one level above the current.
+ <w>></w>      : Change default to one level below the current.
+ <w>-</w>/<w>p</w>    : Change default to the branch above this one.
+ <w>$</w>      : Change default to deepest visited level in this branch.
+ <w>^</w>      : Change default to the entrance to the current level.
+%%%%