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

Spurious warnings when using @link if class has not been imported

XMLWordPrintable

    • 1.2.2
    • sparc
    • solaris_2.6

      Name: dk30142 Date: 10/21/98

      When using a package-qualified class name for an
      @link tag, javadoc issues a spurious warning if
      the class has not been imported. For example:

      /**
       * Documentation of class etc, etc
       * and one can use {@link foo.bar.MyClass} in
       * order to etc
       */

      generates multiple warning messages of the type:

        javadoc: warning - End Delimiter } missing for
        possible See Tag in comment string: "Documentation
        of class etc, etc and one can use {@link foo.bar."

      although the HTML link is generated correctly.

      If the class is imported and not package-qualified
      as follows:

      import foo.bar.MyClass; // or import foo.bar.*;

      /**
       * ...
       * {@link MyClass} ...
       */

      then no warning message is issued.

      In addition, the "possible See Tag" message is
      slightly misleading.
      (Review ID: 40517)
      ======================================================================

            adambalksunw Atul Dambalkar (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: