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

Improper @sees cause broken links

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Open
    • Priority: P4
    • Resolution: Unresolved
    • Affects Version/s: 6
    • Fix Version/s: None
    • Component/s: client-libs
    • Labels:
    • Subcomponent:
    • CPU:
      generic
    • OS:
      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

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

              Dates

              Created:
              Updated:
              Imported:
              Indexed: