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

Reconcile specification and implementation of link parsing

XMLWordPrintable

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

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

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

                Created:
                Updated:
                Resolved: