RFR: 8200432: javadoc fails with ClassCastException on {@link byte[]}
Jonathan Gibbons
jonathan.gibbons at oracle.com
Fri Nov 16 01:42:37 UTC 2018
I'm not wildly enthusiastic about this, because while it prevents the
CCE, it seems to be generally going in the wrong direction. We need to
be looking at supporting more signatures in {@link}, not restricting the
set of supported signatures. While it may seem silly to write {@link
String[]} it does make sense to want to write {@link List<String>}. In
other words, we should accept type signatures that contain possible
multiple names and other punctuation, just as we can write {@link
Object#equals(Other} and have it do the right thing.
I also note the use of a regular expression that is complicated enough
for Sundar to suggest that you use a comment. I would refer you to
http://regex.info/blog/2006-09-15/247
-- Jon
On 11/14/2018 06:43 PM, Sundararajan Athijegannathan wrote:
> Updated webrev looks good!
>
> -Sundar
>
> On 14/11/18, 8:25 PM, Hannes Wallnöfer wrote:
>> Thanks, Sundar.
>>
>> I uploaded a new webrev with a comment:
>>
>> http://cr.openjdk.java.net/~hannesw/8200432/webrev.01/
>>
>> Hannes
>>
>>> Am 13.11.2018 um 16:32 schrieb Sundararajan
>>> Athijegannathan<sundararajan.athijegannathan at oracle.com>:
>>>
>>> Looks good.
>>>
>>> Minor nit: There could be a source comment for this pattern in
>>> Checker.java
>>> + private final static Pattern arrayPattern =
>>> Pattern.compile("^[^\\(]+\\[]");
>>>
>>> -Sundar
>>>
>>> On 13/11/18, 6:52 PM, Hannes Wallnöfer wrote:
>>>> Please review:
>>>>
>>>> Issue:
>>>> https://bugs.openjdk.java.net/browse/JDK-8200432
>>>>
>>>> Webrev:
>>>> http://cr.openjdk.java.net/~hannesw/8200432/webrev.00/
>>>>
>>>>
>>>> Thanks,
>>>> Hannes
>>>>
More information about the javadoc-dev
mailing list