Improve the documentation a bit.

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

3 files changed, 15 insertions, 6 deletions

diff --git a/crawl-ref/docs/arena.txt b/crawl-ref/docs/arena.txt
index 5fbd93d078..3a1cbee8ee 100644
--- a/crawl-ref/docs/arena.txt
+++ b/crawl-ref/docs/arena.txt
@@ -5,7 +5,7 @@ entertainment.  It can be invoked on the command line like this:
     crawl -arena "kobold v goblin"
 
 Which will cause one kobold to fight one goblin, with crawl shutting down once
-one of them has won.  To be considered valid, a monster's name has to fully 
+one of them has won.  To be considered valid, a monster's name has to fully
 match its definition, e.g. "Blork the orc" rather than simply "Blork".
 
 To make them fight for three rounds you can do:
@@ -25,7 +25,7 @@ will give team A a rat and a cockroach and team B a kobold and a goblin; a
 victory is declared when all of one team is dead and at lest one member of the
 other team is still alive.
 
-Some monsters have a band (that is, a group of monsters) that will be 
+Some monsters have a band (that is, a group of monsters) that will be
 generated with them during normal play. You can use the suffix "band" to
 make a monster appear with its band (if one exists).  For example:
 
@@ -49,6 +49,9 @@ For example:
 
 will choose two random monsters from the 10th level of the Lair and pit them
 against three random monsters from the 7th level of the Vaults.
+The branches need to use the official abbreviations also used e.g. in the
+overmap (Ctrl-O): D, Temple, Orc, Elf, Lair, Swamp, Shoal, Slime, Snake, Hive,
+Vault, Blade, Crypt, Tomb, Hell, Dis, Geh, Coc, Tar, Zot.
 
 To let the game pick monsters completely at random, use "random" as a
 monster name. If you use the tag random_uniques all monsters thus chosen
@@ -146,11 +149,11 @@ The parameters include:
       Creatures spell (including test spawners) then arena cycles through
       the list of valid monsters, rather than taking rarity into account.
 
-* random_uniques: If the team is made up of random monsters 
-      (e.g. "random v random") the chosen monsters will be uniques. Also, 
+* random_uniques: If the team is made up of random monsters
+      (e.g. "random v random") the chosen monsters will be uniques. Also,
       any monster using Shadow Creatures will summon uniques.
 
-* "ban_gylphs:ABC" prevents monsters with the listed ASCII glyphs from
+* "ban_glyphs:ABC" prevents monsters with the listed ASCII glyphs from
       being placed in the arena.  For instance, "ban_glyphs:&C" prevents
       demon lords and giants/cyclopses/titans/etc from being placed.
 
diff --git a/crawl-ref/docs/changes.stone_soup b/crawl-ref/docs/changes.stone_soup
index 9986f75c3e..64f2dbcac2 100644
--- a/crawl-ref/docs/changes.stone_soup
+++ b/crawl-ref/docs/changes.stone_soup
@@ -1,12 +1,15 @@
 Stone Soup 0.5.1 (2009????)
 ---------------------------
 
+Disclaimer: These are merely the highlights, not an exhaustive list of changes.
+
+* Speed-up for the Tiles version.
 * Fix crashes related to giant spores.
 * Fix erroneous "blocked line of fire" warnings.
 * Fix missing items in Tiles inventory.
+* Really allow uniques to retain their spells when polymorphed.
 * Tiles: Allow selection of player dolls.
 * Add missing tiles options to the options guide (docs/, '?&' command).
-* Speed-up for the Tiles version.
 
 Stone Soup 0.5.0 (20090612)
 ---------------------------
diff --git a/crawl-ref/docs/level_design.txt b/crawl-ref/docs/level_design.txt
index 8f6255d8c3..a20d4e747a 100644
--- a/crawl-ref/docs/level_design.txt
+++ b/crawl-ref/docs/level_design.txt
@@ -394,6 +394,9 @@ WEIGHT:   (number with 10 being default)
 
 PLACE:    Used to specify certain special levels. Existing special levels
           include most branch ends.
+          The branches need to use the official abbreviations also used e.g. in
+          the overmap (Ctrl-O): D, Temple, Orc, Elf, Lair, Swamp, Shoal, Slime,
+          Snake, Hive, Vault, Blade, Crypt, Tomb, Hell, Dis, Geh, Coc, Tar, Zot.
 
           PLACE can also be used to specify arbitrary places, like D:3, which
           will force the map (or one of the maps with PLACE: D:3) to be picked