Upgrade JavaDocs to JDK 17

[calcmogul]

There's a lot of warnings from ./gradlew docs:generateJavaDocs -PdocWarningsAsErrors to fix, which are usually from missing docs.

You can usually find the docs for JNI a layer down, like in the HAL or whatever C++ the JNI wraps.

[rzblue]

Specifically, every java symbol needs to be documented. This can (and should) be done over multiple PRs.

[m10653]

I noticed that many of these Check Style warnings are due to Enums missing javadoc comments. It does not seem like anywhere in wpilib the values of the enums themselves have comments and they can be a bit clunky. Is adding javadoc comments to the values of the enums desired or would modifying the style rules/annotations to ignore this style/docs violation preferred.

Example of these comments

  public enum CalibrationTime {
    /** Calibration time of 32 milliseconds */
    _32ms(0), 
    /** Calibration time of 64 milliseconds */
    _64ms(1)
    }
    

[sciencewhiz]

The warnings are from the javadoc doclint. I have not figured out how to suppress just the missing enuns warning, without suppressing all missing documentation warnings (which we don't want to suppress all)

if this was from checkstyle, they could be suppressed.

If you can figure out how to suppress only the missing enum documentation, that would be preferable.

[Gold856]

Since JDK 18, doclint can be supressed with the usual SuppressWarnings, which isn't helpful for us because we're on JDK 17. And updating to JDK 21 (the next LTS release) brings even more warnings. So maybe ignore the enum stuff for now?

[Gold856]

For posterity, #6119 removed about 3000 warnings.

[Gold856]

#6132 removes 84 warnings.