#124: more docs for JSR-303
#124: changes explained