Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8285897

Clarify syntax of the @param tag

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Won't Fix
    • Icon: P4 P4
    • tbd
    • 19
    • tools

      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".

            prappo Pavel Rappo (Inactive)
            prappo Pavel Rappo (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: