Inaccuracy in the documentation of the -group option?

Jonathan Gibbons jonathan.gibbons at oracle.com
Sat Mar 23 15:17:26 UTC 2024


Martin,

Thank you for the report. I have filed JDK-8328848 to fix the documentation.

There is currently no way to also group packages in a multi-modules project.

-- Jon

https://bugs.openjdk.org/browse/JDK-8328848


On 3/23/24 3:59 AM, Martin Desruisseaux wrote:
>
> Hello
>
> The documentation for the Javadoc tools [1] documents the -group 
> option as below:
>
>     -group name p1,p2...
>          Group the specified packages together in the Overview page.
>
> However, when documenting a project using Module Source Hierarchy, 
> this option appears to group modules instead of packages. Should the 
> documentation be updated? Also, grouping modules is great, but is 
> there a way to also group packages in a multi-modules project?
>
>     Thanks,
>
>         Martin
>
> [1]https://docs.oracle.com/en/java/javase/22/docs/specs/man/javadoc.html#standard-options-for-the-standard-doclet
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20240323/c903654a/attachment-0001.htm>


More information about the javadoc-dev mailing list