javadoc updates
terminology: use "property", not "field"