fixing obvious javadoc mistakes in core (the kind that cause the javadoc command to generate warning messages)