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

Improper @sees cause broken links

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • P4
    • None
    • 6
    • client-libs
    • generic
    • generic

    Description

      java/awt/BorderLayout.java contains non public fields that contain @see,
      eg:
          /**
           * Constant to specify components location to be the
           * south portion of the border layout.
           * @serial
           * @see #getChild(String, boolean)
           * @see #addLayoutComponent
           * @see #getLayoutAlignmentX
           * @see #getLayoutAlignmentY
           * @see #removeLayoutComponent
           */
          Component south;

      Links to the targets of these @sees appear in the 'serialized form' generated .html pages, eg:
        http://java.sun.com/j2se/1.5.0/docs/api/serialized-form.html#java.awt.BorderLayout

      These links are broken, (I think because the targets aren't public, but
      I'm not sure of that). Clicking on one takes you to the top of the BorderLayout.html
      page. These links clutter up the result of link check programs.

      See the first Comment for a list of awt files that have this problem and the missing targets.

      Attachments

        Activity

          People

            denis Denis Fokin (Inactive)
            jjh James Holmlund (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Imported:
              Indexed: