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

Reconcile specification and implementation of link parsing

    XMLWordPrintable

Details

    Backports

      Description

        The specification does not seem to allow omission of # (hash sign) when referring to a method or a field of this class, interface, enum or record. Javadoc seems to be more forgiving and allows to do that.

        On the one hand, this might be a sensible thing for javadoc to do. On the other hand, it results in situation when something that works in javadoc is invalid in third party tools, such as IDEs.

        (The robustness principle is a design guideline for software that states: "be conservative in what you do, be liberal in what you accept from others". This principle has been criticized.)

        Attachments

          1. after.png
            191 kB
            Pavel Rappo
          2. before.png
            199 kB
            Pavel Rappo

          Issue Links

            Activity

              People

                jjg Jonathan Gibbons
                prappo Pavel Rappo
                Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: