@Documented ignored for type-use annotations

Gunnar Morling gunnar at hibernate.org
Wed Feb 22 08:54:35 UTC 2017


Hi Jon,

filed a bug; that's the "internal review id": 9047801.

The steps to reproduce are this:

mkdir -p src/main/java/com/example

cat > src/main/java/com/example/MyAnno.java <<EOL
package com.example;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

@Documented
@Target({ TYPE, METHOD, FIELD, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
public @interface MyAnno {
}
EOL

cat > src/main/java/com/example/MyAnnoUser.java <<EOL
package com.example;

import java.util.List;

@MyAnno
public class MyAnnoUser {

    @MyAnno public String foo;
    public List<@MyAnno String> foos;

    @MyAnno public MyAnnoUser() {}

    @MyAnno public void doFoo(@MyAnno String foo) {}
    public void doBar(List<@MyAnno String> foos) {}
}
EOL

javadoc -sourcepath src/main/java -d target/javadoc $(find
src/main/java -name "*.java")

I'm using 1.8.0_121.

--Gunnar


2017-02-21 23:52 GMT+01:00 Jonathan Gibbons <jonathan.gibbons at oracle.com>:
> Hi Gunnar,
>
> Can you put together a tiny test case and file a bug?
>
> -- Jon
>
>
> On 02/20/2017 01:54 AM, Gunnar Morling wrote:
>>
>> Hi,
>>
>> Is there a way to show annotations on type arguments in JavaDoc?
>>
>> My annotation type is meta-annotated with @Target(TYPE_USE) and
>> @Documented, still it isn't shown in JavaDocs for elements using it,
>> e.g. a method like this:
>>
>>      foo(List<@MyAnno String> strings) { ... }
>>
>> Is this generally not supported or is there some sort of option I need
>> to enable to have type use annotations showing up in JavaDoc?
>>
>> Thanks,
>>
>> --Gunnar
>
>


More information about the javadoc-dev mailing list