formatting (80 characters per line is good)

new chapter on studying skills

doc/introduction.md

@@ -1,16 +1,35 @@
 # Introduction
 
-Eressea is a play-by-email strategy role-playing game that simulates a fantasy world. Unlike most video games, there are are no fancy graphics, but everything that happens is communicated by text.
+Eressea is a play-by-email strategy role-playing game that simulates a
+fantasy world. Unlike most video games, there are are no fancy
+graphics, but everything that happens is communicated by text.
 
-As a player, you are in control of a number of characters, which are referred to as units, which combine to make a faction. Your faction competes with other factions over the resources of the world that you explore together. Sometimes this leads to war, and sometimes to friendship between factions, and eventually it all adds up to a rich history of the world, with its own heroes and legends.
+As a player, you are in control of a number of characters, which are
+referred to as units, which combine to make a faction. Your faction
+competes with other factions over the resources of the world that you
+explore together. Sometimes this leads to war, and sometimes to
+friendship between factions, and eventually it all adds up to a rich
+history of the world, with its own heroes and legends.
 
-Eressea is different from most games in many respects, but most of all in that there is no declared winner. There is not even a goal, other than to enjoy yourself, and set your own goals. Do you want to monopolize a natural resource? Become the strongest military force? Create a democratic government for the factions in your part of the world? Collect trophies from slain dragons? Map the entire globe? Those are all valid goals to set for yourself, but you might find your own.
+Eressea is different from most games in many respects, but most of all
+in that there is no declared winner. There is not even a goal, other
+than to enjoy yourself, and set your own goals. Do you want to
+monopolize a natural resource? Become the strongest military force?
+Create a democratic government for the factions in your part of the
+world? Collect trophies from slain dragons? Map the entire globe?
+Those are all valid goals to set for yourself, but you might find your
+own.
 
 ### How to play
 
-Eressea is played in weekly turns. Every weekend, you receive a textual report containing your units, the part of the world that they can observe, and any events that happened since the last report. 
+Eressea is played in weekly turns. Every weekend, you receive a
+textual report containing your units, the part of the world that they
+can observe, and any events that happened since the last report. 
 
-Based on that report, players send an email to the game's server that contains orders for all of their units. A week later, the server evaluates the orders from all players, updates the state of the world, and sends out new reports.
+Based on that report, players send an email to the game's server that
+contains orders for all of their units. A week later, the server
+evaluates the orders from all players, updates the state of the world,
+and sends out new reports.
 
 A (slightly simplified) report may look like this:
 
@@ -47,15 +66,42 @@ A (slightly simplified) report may look like this:
 	  + Osswid the Destroyer (wtmj), Vikings (atnf), 1
 	    dwarf, has: 1 iron.
 
-What you see here are two units, Osswid (wtmj) and the Fighters of Pelenth (r6b0). The fighters are our own unit, but Osswid belongs to the faction Vikings (atnf). Every unit, faction or other object in the game is identified by a four-letter code, and it is common to append it to the name in parentheses. The fort of Pelenth (opw4) is a building, and our fighters are inside, which causes them to be indented a little more, and gives them some benefits including additional protection in combat.
+What you see here are two units, Osswid (wtmj) and the Fighters of
+Pelenth (r6b0). The fighters are our own unit, but Osswid belongs to
+the faction Vikings (atnf). Every unit, faction or other object in the
+game is identified by a four-letter code, and it is common to append
+it to the name in parentheses. The fort of Pelenth (opw4) is a
+building, and our fighters are inside, which causes them to be
+indented a little more, and gives them some benefits including
+additional protection in combat.
 
-While Osswid is a single dwarf, our unit of fighters consists of several elves. Units can any number of men, which are always of the same race. Each unit can learn any number of skills, and our Fighters are skilled in melee combat at a respectable level 5. They own a sword and one platemail, which means that one of them will be well equipped when going into battle, while the other three will fight with their bare hands. The unit also has 500 pieces of silver, the currency of the game.
+While Osswid is a single dwarf, our unit of fighters consists of
+several elves. Units can any number of men, which are always of the
+same race. Each unit can learn any number of skills, and our Fighters
+are skilled in melee combat at a respectable level 5. They own a sword
+and one platemail, which means that one of them will be well equipped
+when going into battle, while the other three will fight with their
+bare hands. The unit also has 500 pieces of silver, the currency of
+the game.
 
-Since he isn't of our own faction, we cannot tell what skills Osswid has, but we can tell that he's unarmed.
+Since he isn't of our own faction, we cannot tell what skills Osswid
+has, but we can tell that he's unarmed.
 
-We see all this because one of our units is in the region, the highland of Vetkan (10,1). Regions do not have a four-letter identifier, but are instead identified by their coordinates on the map, which makes it easier to visualize the world.
+We see all this because one of our units is in the region, the
+highland of Vetkan (10,1). Regions do not have a four-letter
+identifier, but are instead identified by their coordinates on the
+map, which makes it easier to visualize the world.
 
-The region of Vetkan is surrounded by a number of other regions on six sides, since Eressea's Map uses a hexagonal grid. Every region has a terrain, and we can see highland, mountain, plain and forest regions in our vicinity. Each terrain has different qualities: For example, mountains are good for mining iron ore and quarries, while plains are fertile and forests produce lumber. Each region is inhabited by a peasant population, and you can see that Vetkan has a population of 1012. These peasants are the basis of the region's economy, and they own a combined 13,156 silver that we could try to acquire through taxation or other means.
+The region of Vetkan is surrounded by a number of other regions on six
+sides, since Eressea's Map uses a hexagonal grid. Every region has a
+terrain, and we can see highland, mountain, plain and forest regions
+in our vicinity. Each terrain has different qualities: For example,
+mountains are good for mining iron ore and quarries, while plains are
+fertile and forests produce lumber. Each region is inhabited by a
+peasant population, and you can see that Vetkan has a population of
+1012. These peasants are the basis of the region's economy, and they
+own a combined 13,156 silver that we could try to acquire through
+taxation or other means.
 
 Example orders for this faction may look like this:
 
@@ -74,6 +120,22 @@ Example orders for this faction may look like this:
 		MOVE E
 	END
 
-Every set of orders begins with the faction's id and password, and is followed by orders for one or more units. A unit's orders begin with the word UNIT followed by the unit's id, and one or more orders. In this case, we are giving the unit an order to STUDY the perception skill, and to GIVE silver to three other units. STUDY is a standard action, and each unit can perform exactly one per turn. If you do not specify a standard action, then the unit will usually repeat the action from the previous week. GIVE is a free action, and all units can perform as many free actions in a week as they like.
+Every set of orders begins with the faction's id and password, and is
+followed by orders for one or more units. A unit's orders begin with
+the word UNIT followed by the unit's id, and one or more orders. In
+this case, we are giving the unit an order to STUDY the perception
+skill, and to GIVE silver to three other units. STUDY is a standard
+action, and each unit can perform exactly one per turn. If you do not
+specify a standard action, then the unit will usually repeat the
+action from the previous week. GIVE is a free action, and all units
+can perform as many free actions in a week as they like.
 
-The MAKE TEMP order is special: It creates a new unit with a temporary id (in this case, we're calling them TEMP 1 and TEMP 2). The server will replace this with a unique id by the time it sends the next report, but until then, we can address the new unit by this temporary identifier, for example to give it the silver that it requires for recruiting new members. RECRUIT is another example of a free action, while MOVE is a standard action. The MAKE TEMP order is technically given by the unit whose orders preceded it, and the new unit's orders are finished with the END keyword.
+The MAKE TEMP order is special: It creates a new unit with a temporary
+id (in this case, we're calling them TEMP 1 and TEMP 2). The server
+will replace this with a unique id by the time it sends the next
+report, but until then, we can address the new unit by this temporary
+identifier, for example to give it the silver that it requires for
+recruiting new members. RECRUIT is another example of a free action,
+while MOVE is a standard action. The MAKE TEMP order is technically
+given by the unit whose orders preceded it, and the new unit's orders
+are finished with the END keyword.

doc/study.md

@@ -0,0 +1,31 @@
+# Studying Skills
+
+Every unit in Eressea can be upgraded by learning a number of skills.
+Some examples of skills are mining, riding, archery, and shipcraft.
+Some skills enable a unit to produce a good, such as mining, which
+gives you access to iron and other metals. Other skills improve a
+unit's combat qualities, like archery, melee, and constitution. With
+enough time, all skills can be studied to higher levels, with no upper
+limit, and usually give better benefits the more proficient a unit is.
+
+To study a skill, a unit needs to give the STUDY order, followed by
+the name of the skill:
+
+    UNIT 1234
+      STUDY mining
+
+## Study duration
+
+An unmodified skill takes about a week to learn, higher levels take
+longer. The total time to advance a level is variable per unit, but on
+average, learning up to a new level takes as many weeks' time, so for
+example, starting from level 3 it should take approximately 4 weeks to
+reach level 4 in a skill.
+
+## Skill modifications
+
+Skills can be modified for any number of reasons. Certain races have
+natural modifications on skills, which give a bonus on the skill if it
+has been trained to at least level 1. Some buildings provide their
+inhabitants with a skill boost, and certain skills are modified by the
+terrain that a unit is in.