minor update to comments and add missing JavaDoc
Authored by: kappa1 2011-07-10
Parent: [r3558]
Child: [r3560]