The "exclude" option for subpackages is not recursive, as indicated in the documentation

[Jonathan Gibbons]

Dawid,

Thanks for the report; this should be investigated further.

Do you want to file an issue against javadoc, or would you like us to do so?

-- Jon


On 4/30/20 1:59 AM, Dawid Weiss wrote:
> Hello,
>
> Javadoc for "exclude" states that [1]:
>
> "Unconditionally, excludes the specified packages and their
> subpackages from the list formed by -subpackages."
>
> I find this statement untrue. Given a package structure "a.b.c" and
> javadoc options:
>
> -sourcepath src
> -subpackages a
> -exclude a.b
>
> the resulting javadoc is created for classes in 'a' and 'a.b.c':
>
> https://github.com/dweiss/javadoc-exclude/blob/master/javadoc/element-list
>
> Full repro is on github [2].
>
> Am I missing something? Is the spec wrong or is this a bug?
>
> Dawid
>
> [1] https://docs.oracle.com/en/java/javase/12/tools/javadoc.html
> [2] https://github.com/dweiss/javadoc-exclude