minor javadoc updates to make diff simpler
Authored by: vincent_cave 2012-07-26
Parent: [r5630]
Child: [r5632]