On Tue, 29 Oct 2024 11:14:54 GMT, Nizar Benalla <nbena...@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 think there are potentially two common styles in play. * Declarations of parameterized types, for which single letters are commonly used for the type _parameters_: `Map<K,V>` * Uses of parameterized types, in which the type _arguments_ are longer type expressions: `Map<String, List<Integer>>` In the first, it is common to not use whitespace; in the second, whitespace seems appropriate. ------------- PR Comment: https://git.openjdk.org/jdk/pull/21759#issuecomment-2450120306
