please update existing javadoc if a method's functionality changes (otherwise, there's not exactly a point)
minor changes