diff --git a/src/arenas/PythonSampleAgents.py b/src/arenas/PythonSampleAgents.py
index cdaab5f58356fcc5f74b77f84b1e6b109d732303..e3e0ea880ed2d60887ff0109dfb335165780fcf7 100755
--- a/src/arenas/PythonSampleAgents.py
+++ b/src/arenas/PythonSampleAgents.py
@@ -1,6 +1,6 @@
 #!/usr/bin/python2.5
 '''PythonSampleAgents.py
-An areana that runs the sample bots in python.
+An arena that runs the sample bots in python.
 Written by Daniel Axtens <dja@ucc.asn.au> for the UCC Programming Competition in 2010.
 
 Licensed under an MIT-style license: see the LICENSE file for details.
@@ -8,7 +8,5 @@ Licensed under an MIT-style license: see the LICENSE file for details.
 
 from SampleAgents import Angel, Lucifer, Dummy, Wash, Streetfighter
 
-
-# Import and add your agents here:
 class arena:
     Agents =  [Angel,Lucifer,Streetfighter,Wash]
diff --git a/src/conf.py b/src/conf.py
index 0969b271393fc4b1f9daf472f4677d15b279f8db..e8f1d88fb3a682d6d560118b53e2fb0cc5be7eaa 100644
--- a/src/conf.py
+++ b/src/conf.py
@@ -11,10 +11,10 @@ DEBUG = False
 # How many iterations to run before quitting.
 MAX_ITERATIONS = 1000
 
-# How many of each agent to create initially.
+# How many of each agent to create initially. (or use -n)
 STARTING_POPULATION = 10
 
-# ???
+# Number of times the simulation is run. (or use -t)
 TRIALS = 1
 
 # How much health to give each agent on birth.
@@ -29,8 +29,7 @@ DIE_HEALTH = 0
 # The age at which to kill any agent.
 MAX_AGE = 100
 
-
-# Cap the number of agents:
+# Cap the number of agents (set to 0 to disable)
 MAX_TOTAL_AGENTS = 255
 
 # Game dynamics: