NX-620: Javadoc, cleanup, and some refinements wrt logging