137 java doc class patterns

Flushed out the JavaDoc as discussed.

Hopefully I can get 2 people to agree to this quickly. Then I will create a new pull request containing the compiled JavaDoc HTML.