Outsource the tutorial descriptions of skills, and make them searchable

in the database. Apply Zaba's patch to view skills from the skill menu
('m'). The melee, ranged and magic skills currently only have really 
generic descriptions shamelessly copied from the tutorial. There's a
front end function get_skill_description that appends extra information
like what types of unarmed attacks the current character is capable of
(kicking, clawing, punching, ...)


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

1 files changed, 256 insertions, 0 deletions

diff --git a/crawl-ref/source/dat/descript/skills.txt b/crawl-ref/source/dat/descript/skills.txt
new file mode 100644
index 0000000000..fc194e6686
--- /dev/null
+++ b/crawl-ref/source/dat/descript/skills.txt
@@ -0,0 +1,256 @@
+%%%%
+Buggy
+
+Buggy
+(It's a bug if you ever see this.)
+%%%%
+Fighting
+
+Apart from making you more proficient in hand-to-hand combat, Fighting 
+also increases your maximum hitpoints.
+%%%%
+Short Blades
+
+Being skilled with a particular type of weapon will make it easier to 
+fight with all weapons of this type and make you deal more damage with 
+them. It is generally recommended to concentrate your efforts on one or 
+two weapon types to become more powerful in them.
+
+If you're already skilled in Short Blades, it is easier to become 
+skilled in Long Blades.
+%%%%
+Long Blades
+
+Being skilled with a particular type of weapon will make it easier to 
+fight with all weapons of this type and make you deal more damage with 
+them. It is generally recommended to concentrate your efforts on one or 
+two weapon types to become more powerful in them.
+
+If you're already skilled in Short Blades, it is easier to become 
+(more) skilled in Long Blades.
+%%%%
+Axes
+
+Being skilled with a particular type of weapon will make it easier to 
+fight with all weapons of this type and make you deal more damage with 
+them. It is generally recommended to concentrate your efforts on one or 
+two weapon types to become more powerful in them.
+
+Being skilled in Axes makes learning to fight with Maces or Polearms
+easier.
+%%%%
+Maces & Flails
+
+Being skilled with a particular type of weapon will make it easier to 
+fight with all weapons of this type and make you deal more damage with 
+them. It is generally recommended to concentrate your efforts on one or 
+two weapon types to become more powerful in them.
+
+Being skilled in Maces & Flails makes it easier to also become skilled
+when fighting with Axes.
+%%%%
+Polearms
+
+Being skilled with a particular type of weapon will make it easier to 
+fight with all weapons of this type and make you deal more damage with 
+them. It is generally recommended to concentrate your efforts on one or 
+two weapon types to become more powerful in them.
+
+Being skilled in Polearms eases training in Maces/Flails or Staves.
+%%%%
+Staves
+
+Being skilled with a particular type of weapon will make it easier to 
+fight with all weapons of this type and make you deal more damage with 
+them. It is generally recommended to concentrate your efforts on one or 
+two weapon types to become more powerful in them.
+
+Being skilled in Staves makes becoming skilled in Polearms easier.
+%%%%
+Slings
+
+Being skilled in a particular type of ranged attack will let you deal 
+more damage when using the appropriate launcher an dammunition.
+
+If you're already trained in Throwing, you'll pick up the Slings skill
+faster, and vice versa.
+%%%%
+Bows
+
+Being skilled in a particular type of ranged attack will let you deal 
+more damage when using the appropriate launcher an dammunition.
+%%%%
+Crossbows
+
+Being skilled in a particular type of ranged attack will let you deal 
+more damage when using the appropriate launcher an dammunition.
+%%%%
+Darts
+
+Being skilled in a particular type of ranged attack will let you deal 
+more damage when using the appropriate launcher an dammunition.
+%%%%
+Throwing
+
+Training Throwing will make thrown weapons (as opposed to ones fired 
+from a launcher) more effective. In particular, it makes weapons of 
+returning more likely to actually return to their thrower.
+
+If you're already trained in Slings, you'll pick up the Throwing skill
+faster, and vice versa.
+%%%%
+Armour
+
+Armour skill helps lessen the hinderance of heavy armour on moving, 
+spellcasting and other actions.
+%%%%
+Dodging
+
+Obviously, the Dodging skill will affect your chance of dodging an 
+attack, be it melee, ranged, or magical. You cannot dodge enchantments, 
+sadly. Rather, to resist them, you'll need magic resistance.
+%%%%
+Stealth
+
+By training stealth, you can make it less likely that monsters will 
+notice you. Note that monsters become more suspicious and observant as 
+you descend.
+%%%%
+Stabbing
+
+Stabbing is the skill that governs the likeliness of doing a great 
+amount of damage on a distracted or helpless creature. 
+Some gods may disapprove of this.
+%%%%
+Shields
+
+A high Shields skill of blocking a melee or ranged attack with your 
+equipped (or a magical) shield.
+%%%%
+Traps & Doors
+
+A character trained in Traps & Doors will be more observant to his or 
+her surroundings and be quicker in noticing traps and secret doors.
+%%%%
+Unarmed Combat
+
+A character trained in unarmed combat will occasionally do an 
+additional melee attack, provided they have the means to do so. 
+Of course, this skill also trains your proficiency in barehanded 
+combat.
+%%%%
+Spellcasting
+
+Now that you have the basic Spellcasting skill, you can learn and cast 
+spells, if you wish to. In addition, gaining another level in 
+Spellcasting will occasionally grant your more magic and "spell slots" 
+to spend on new spells. A high Spellcasting skill will also decrease 
+the amount by which casting a high level spell makes you hunger.
+%%%%
+Conjurations
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Enchantments
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Summonings
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Necromancy
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Translocations
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Transmigration
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Divinations
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Fire Magic
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+
+Being skilled in Fire Magic makes Ice Magic harder to learn, and vice
+versa.
+%%%%
+Ice Magic
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+
+Being skilled in Ice Magic makes Fire Magic harder to learn, and vice
+versa.
+%%%%
+Air Magic
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+
+Being skilled in Air Magic makes Earth Magic harder to learn, and vice
+versa.
+%%%%
+Earth Magic
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+
+Being skilled in Earth Magic makes Ice Magic harder to learn, and vice
+versa.
+%%%%
+Poison Magic
+
+Being skilled in a magical "school" makes it easier to learn and cast
+spells of this school. Many spells belong to a combination of several 
+schools, in which case the average skill in these schools will decide 
+on spellcasting success and power.
+%%%%
+Invocations
+
+Your Invocations skill affects the likelihood trying to use a
+divine ability will be successful.
+%%%%
+Evocations
+
+Evocations is all about using magical items like wands, decks or
+other uncommon objects. The higher your skill, the more likely is a
+positive outcome when evoking items.
+%%%%