javadoc added by graham