VE-471: more doc comments and minor cleanup.