Improve class javadoc. In particular, the documented order of security c...

...heckes now matches code