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

[doclint] doclint doesn't recognize links for nested class constructors

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Not an Issue
    • Icon: P3 P3
    • None
    • 8
    • tools

      Let's compile JDK with doclint turned on.
      We see 2 errors on Path2D class (2D subcomponent):

      /export/doclint/jdk/src/share/classes/java/awt/geom/Path2D.java:1931: error: unexpected text
      /export/doclint/jdk/src/share/classes/java/awt/geom/Path2D.java:1933: error: unexpected text

      Let's look at these two lines:
      1931: * {@link Path2D.Float#Path2D.Float(Shape, AffineTransform) Path2D.Float}
      1933: * {@link Path2D.Double#Path2D.Double(Shape, AffineTransform) Path2D.Double}

      We see that these two lines creates two valid links into overloaded constructor of 2 Path2D subclasses: Path2D.Float and Path2D.Double.

      I believe it is wrong behavior and should be fixed.

            jjg Jonathan Gibbons
            dginzbur Dmitry Ginzburg (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: