-
Bug
-
Resolution: Won't Fix
-
P4
-
19
Clarify and possibly improve syntax of the @param tag in the case of type parameters.
The examples below use three whitespace characters for clarity and defence against proportional fonts used by some browsers:
1. Is the whitespace before `<` mandatory? (@param<T> vs @param <T>)
2. Is the whitespace before `>` mandatory? (@param <T> vs @param <T >?
Perhaps this should mimic the Java Language. That is, all such whitespace characters should be optional; for example: List <T>, List<T>, List<T >, List< T>
Separately, the current wording only mentions "classes" in the context where it should be "classes and interfaces".
The examples below use three whitespace characters for clarity and defence against proportional fonts used by some browsers:
1. Is the whitespace before `<` mandatory? (@param<T> vs @param <T>)
2. Is the whitespace before `>` mandatory? (@param <T> vs @param <T >?
Perhaps this should mimic the Java Language. That is, all such whitespace characters should be optional; for example: List <T>, List<T>, List<T >, List< T>
Separately, the current wording only mentions "classes" in the context where it should be "classes and interfaces".
- duplicates
-
JDK-8289945 Allow whitespace for a type parameter in @param
-
- Closed
-