On Fri, 15 Apr 2022 16:58:55 GMT, Pavel Rappo <pra...@openjdk.org> wrote:
> Before:
>
> Standard Doclet version 18+36-2087
> Building tree for all the packages and classes...
> Generating /tmp/whatever/ExampleDiagnostics.html...
> ExampleDiagnostics.java:5: error: unexpected content
> * {@docRoot a}
> ^
> ExampleDiagnostics.java:11: error: unexpected content
> * {@inheritDoc a}
> ^
> ExampleDiagnostics.java:17: error: '>' expected
> * @param <T param
> ^
>
> After:
>
> Standard Doclet version 19-internal-2022-04-07-1105474.pavelrappo...
> Building tree for all the packages and classes...
> Generating /tmp/whatever/ExampleDiagnostics.html...
> ExampleDiagnostics.java:5: error: unexpected content
> * {@docRoot a}
> ^
> ExampleDiagnostics.java:11: error: unexpected content
> * {@inheritDoc a}
> ^
> ExampleDiagnostics.java:17: error: '>' expected
> * @param <T param
> ^
A drive-by observation: shouldn't we allow whitespace in between the type
variable and the closing `>`?
Currently, this is valid:
@param < T> param
while this is not:
@param <T > param
If we decide to allow whitespace in between the type variable and the closing
`>`, it should be done in a separate PR.
-------------
PR: https://git.openjdk.java.net/jdk/pull/8264
