Clarify syntax of the @param tag

XMLWordPrintable

    • Type: Bug
    • Resolution: Won't Fix
    • Priority: P4
    • tbd
    • Affects Version/s: 19
    • Component/s: 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".

            Assignee:
            Pavel Rappo
            Reporter:
            Pavel Rappo
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: