TAB-4946 Doc changes plus CR-19 comments incorporated.

git-svn-id: http://svn.terracotta.org/svn/ehcache@9250 b9324663-ca0f-0410-8574-be9b3887307d