another javadoc added by graham