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
            after.png
            191 kB
          2. before.png
            before.png
            199 kB

          Issue Links

            backported by

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8289405 Reconcile specification and implementation of link parsing

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8291075 Reconcile specification and implementation of link parsing

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8291170 Reconcile specification and implementation of link parsing

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            relates to

            Bug - A problem which impairs or prevents the functions of the product. JDK-8266636 Specify how positional arguments are separated

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Bug - A problem which impairs or prevents the functions of the product. JDK-8273070 Specify how array and vararg parameters are parsed

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Activity

              People

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

                Dates

                  Created:
                  Updated:
                  Resolved: