javadoc update
Describe the API with examples
Move to Play 2.2.1
Add tests to make sure that the documentation is in sync with the actual code.