Bump max arity for matcher factories to 9, and improve the Scaladoc.


git-svn-id: http://scalatest.googlecode.com/svn/trunk@5153 fd1274fd-080f-5963-8033-43ee40fcd1de