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

@see doesn't create a link to external references

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P3 P3
    • None
    • 1.4.1
    • tools



      Name: nt126004 Date: 01/28/2003


      FULL PRODUCT VERSION :
      java version "1.4.1_01"
      Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_01-b01)
      Java HotSpot(TM) Client VM (build 1.4.1_01-b01, mixed mode)


      FULL OPERATING SYSTEM VERSION :
      > rpm --query glibc
      glibc-2.2.5-164
      > uname -a
      Linux jupiter 2.4.19-4GB #1 Fri Sep 13 13:19:15 UTC 2002
      i686 unknown


      ADDITIONAL OPERATING SYSTEMS :
      This bug is probably independant of the operating system

      A DESCRIPTION OF THE PROBLEM :
      @see does not create links to external references.

      Try using @see and -link. @see does not get a href anchor
      ("link") in the html output.

      Don't be confused by the warnings in the output. These are
      another bug I already reported. Even if javadoc warns about
      javax-references, the java.awt-references still should work.

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      1. Type in the source code below
      2. javadoc it using javadoc -link URI-TO-API-DOC sourcefilename
      3. Look at the generated documentation.

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      Excpected Results:
      The documentation should not just contain See also sections,
      but the entries in the See also sections should be href
      anchors ("links") to the corresponding items in the
      referenced documentation.

      Actual Results:
      The documentation contains See also sections but the entries
      aren't hyperlinks to the referenced documentation.

      ERROR MESSAGES/STACK TRACES THAT OCCUR :
      No error messages available

      REPRODUCIBILITY :
      This bug can be reproduced always.

      ---------- BEGIN SOURCE ----------
      import java.awt.event.ActionListener;
      import java.awt.event.KeyListener;

      /** A simple interface TextComponents should implement.
       * It is used by History to capture commons between {@link java.awt.TextField}
      and {@link javax.swing.JTextField}.
       * @author $Author$
       * @version $Revision$
       * @see java.awt.TextField
       * @see javax.swing.JTextField
       */
      public interface TextComponent {

          /** Version information */
          static String revision = "$Revision$";

          /** Returns the text contained in this TextComponent.
           * If this TextComponent works with documents and the underlying document is
      null, will give a NullPointerException.
           * @see java.awt.TextComponent#getText()
           * @see javax.swing.text.JTextComponent#getText()
           * @return the text
           * @throws NullPointerException if the document is <code>null</code>
           */
          String getText() throws NullPointerException;

          /** Sets the text contained in this TextComponent.
           * @see java.awt.TextComponent#setText(String)
           * @see javax.swing.text.JTextComponent#setText(String)
           * @param t the new text
           */
          void setText(String t);

          // ...
      }
      ---------- END SOURCE ----------
      (Review ID: 180354)
      ======================================================================

            jhosunw Jamie Ho (Inactive)
            nthompsosunw Nathanael Thompson (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: