Add a few things to the arena documentation.

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

1 files changed, 18 insertions, 5 deletions

diff --git a/crawl-ref/docs/arena.txt b/crawl-ref/docs/arena.txt
index 4f97843f31..b4339c32a7 100644
--- a/crawl-ref/docs/arena.txt
+++ b/crawl-ref/docs/arena.txt
@@ -41,24 +41,35 @@ 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.
 
+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
+will be uniques. For example:
+
+    crawl -arena "random_uniques random v random"
+
 If you want endless hordes of monsters to kill each other forever you can
 use the test spawner, an unkillable monster which does nothing but sit there
 and summon monsters with the Shadow Creatures spell:
 
     crawl -arena "test spawner v test spawner"
 
+
                            Options and parameters
 ------------------------------------------------------------------------------
-There are three arena parameters that you can set in your crawl options file:
+There are four arena parameters that you can set in your crawl options file:
 
 * arena_delay: The delay in milliseconds between turns within the arena.
-      Can be set to 0 to make the simulation zip along.
+      Can be set to 0 to make the simulation zip along. Defaults to 600.
 
 * arena_dump_msgs: If set to true causes messages to be dumped to the file
-      arena.result
+      arena.result. Defaults to false.
 
 * arena_dump_msgs_all: If both this and arena_dump_msgs are set to true
       then diagnostic messages will be dumped as well as other messages.
+      Defaults to false.
+
+* arena_list_eq: (?) Defaults to false.
+
 
 The are also a number a parameters you can use by putting them in the
 string which specifies the monsters:
@@ -71,7 +82,7 @@ The parameters include:
       in (defaults to "arena:default").  See source/dat/arena.des for
       a list.
 
-* no_force_ai: The monsters in the arena are somewhat smatter than they are
+* no_force_ai: The monsters in the arena are somewhat smarter than they are
       than when they're facing the player.  This parameter removes that
       extra intelligence.
 
@@ -109,7 +120,9 @@ 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: Any monster using Shadow Creatures will summon uniques.
+* 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
       being placed in the arena.  For instance, "ban_glyphs:&C" prevents