lobtx opened a new pull request, #29579:
URL: https://github.com/apache/camel/pull/29579
# Description
Follow-up of #15984 and #15986: makes the Javadoc of `core/camel-util` pass
doclint (`-Xdoclint:all,-missing`),
so that doclint can eventually be re-enabled.
- replace `<tt>` (not supported in HTML5) with `<code>`, its HTML5
equivalent (monospace), rather than `<var>` (italic, meant for variables), as
`true`/`null`/scheme names are code literals; `<code>` and `{@code}` are also
what the rest of the codebase mostly uses
- replace self-closing `<p/>` and `<br/>` with `<p>` and `<br>` (kept as
`<p>` rather than blank lines so the rendered paragraphs are preserved)
- remove the `<code>` wrapping around `<pre>` blocks
- fix a malformed `<tt>true</ff>` in `FileUtil#isAbsolute`
- `URISupport`: remove `@throws` for exceptions that are not thrown (and the
now unused import), add the missing `@param encode`
- `ThrowingTriConsumer`: remove `@return` on a void method
- `ThreadHelper`: use `{@code}` instead of `{@link}` for
`ExecutorServiceManager`, which is not visible from camel-util
Javadoc only, no code change. Checked with:
mvn -pl core/camel-util javadoc:javadoc -Ddoclint=all,-missing
Checked with JDK 21 and JDK 25; `mvn install` of the module passes (340
tests).
AI tool used: Claude Code (Claude Opus 5.5), reviewed and checked by me.
_Claude Code on behalf of lobtx_
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
