Updated documentation

Updated documentation for the change to using @Security.Authenticated.
More fixes.
More doc updates.
Merge pull request #7 from chothia/master

Updated the readme to explain the change to the @Security.Authenticated` annotation.