RFR: 8342808: Javadoc should add whitespace between type parameters
Hannes Wallnöfer
hannesw at openjdk.org
Fri Nov 1 09:32:31 UTC 2024
On Tue, 29 Oct 2024 11:14:54 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:
> Please review this patch to render javadocs as `<K, V, T>` rather than `<K,V,T>` to match naming conventions and make the rendered output slighly nicer to read.
>
> Passes langtool tests.
>
> The[ generated docs](https://cr.openjdk.org/~nbenalla/GeneratedDocs/TypeParams/docs/api/index.html) only includes `java.base/lang`, `java.base/util` and `java.compiler/javax`
I have to correct my previous comment, the newline characters in type parameters of generic methods are actually displayed as preformatted text when type parameters are very long, such as [in this method][1].
[1]: https://docs.oracle.com/en/java/javase/23/docs/api/java.net.http/java/net/http/HttpResponse.BodySubscribers.html#fromSubscriber(java.util.concurrent.Flow.Subscriber,java.util.function.Function)
-------------
PR Comment: https://git.openjdk.org/jdk/pull/21759#issuecomment-2451584554
More information about the javadoc-dev
mailing list