You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "hxperl (via GitHub)" <gi...@apache.org> on 2026/09/15 01:56:20 UTC

[PR] Fix @param name in the private POP3MessageInfo constructor [commons-net]

hxperl opened a new pull request, #408:
URL: https://github.com/apache/commons-net/pull/408

   The three-arg `POP3MessageInfo` constructor documents `@param octets`, but the parameter is `size`. The name came from the public two-arg constructor above it, which really does take `octets`.
   
   ```
   $ javadoc -Xdoclint:reference -private -d /tmp/out \
       src/main/java/org/apache/commons/net/pop3/POP3MessageInfo.java
   POP3MessageInfo.java:81: error: @param name not found
        * @param octets The size.
                 ^
   ```
   
   Renames the tag to `size`; three trailing spaces keep the description column aligned. Clean after the change.
   
   Limits: the constructor is private, so this does not affect the published API docs — it only shows under `-private`. `mvn javadoc:javadoc` and `mvn test` both pass on macOS arm64, JDK 17 (632 tests, 0 failures).
   
   - [x] I used AI to create any part of, or all of, this pull request. Written with Claude Code (Claude Opus 5); it found the mismatch, made the one-line edit, and ran the build.
   


-- 
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: issues-unsubscribe@commons.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org