He-Pin opened a new pull request, #3284:
URL: https://github.com/apache/pekko/pull/3284
## Motivation
Running `sbt doc` produces javadoc warnings in Java source files of the
actor module:
- Multi-line `{@link}` tags cause "Could not find any member to link"
warnings
- `{@link}` references to Scala classes fail since they are not visible to
javadoc
- Unqualified `@throws` references cannot be resolved
## Modification
- `ReceiveBuilder.java`: Move multi-line `{@link}` to single line to avoid
empty link target
- `UnitMatch.java`: Replace `{@link scala.PartialFunction}` and `{@link
scala.runtime.BoxedUnit}` with `{@code}` since Scala classes are not resolvable
by javadoc
- `UnsynchronizedByteArrayInputStream.java`: Use fully qualified
`java.lang.IllegalArgumentException` in `@throws` tag
## Result
Javadoc warnings in these files are eliminated, improving documentation
quality.
## Tests
Manually verified via `sbt doc`
## References
Follow-up to #3254
--
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
