update javadoc: move the return from the previous method here