Interface SeeTag

All Superinterfaces:
Tag
All Known Implementing Classes:
SeeTagImpl

@Deprecated public interface SeeTag extends Tag
Deprecated.
The declarations in this package have been superseded by those in the package jdk.javadoc.doclet. For more information, see the Migration Guide in the documentation for that package.
Represents a user-defined cross-reference to related documentation. The tag can reference a package, class or member, or can hold plain text. (The plain text might be a reference to something not online, such as a printed book, or be a hard-coded HTML link.) The reference can either be inline with the comment, using {@link}, or a separate block comment, using @see. Method name() returns "@link" (no curly braces) or "@see", depending on the tag. Method kind() returns "@see" for both tags.
  • Method Details

    • label

      String label()
      Deprecated.
      Get the label of the @see tag. Return null if no label is present. For example, for:

        @see String#trim() the trim method

      return "the trim method".
      Returns:
      "the trim method".
    • referencedPackage

      PackageDoc referencedPackage()
      Deprecated.
      Get the package doc when @see references only a package. Return null if the package cannot be found, or if @see references any other element (class, interface, field, constructor, method) or non-element. For example, for:

        @see java.lang

      return the PackageDoc for java.lang.
      Returns:
      the PackageDoc for java.lang.
    • referencedClassName

      String referencedClassName()
      Deprecated.
      Get the class or interface name of the @see reference. The name is fully qualified if the name specified in the original @see tag was fully qualified, or if the class or interface can be found; otherwise it is unqualified. If @see references only a package name, then return the package name instead. For example, for:

        @see String#valueOf(java.lang.Object)

      return "java.lang.String". For "@see java.lang", return "java.lang". Return null if @see references a non-element, such as @see <a href="java.sun.com">.
      Returns:
      null if @see references a non-element, such as @see <a href="java.sun.com">.
    • referencedClass

      ClassDoc referencedClass()
      Deprecated.
      Get the class doc referenced by the class name part of @see. Return null if the class cannot be found. For example, for:

        @see String#valueOf(java.lang.Object)

      return the ClassDoc for java.lang.String.
      Returns:
      the ClassDoc for java.lang.String.
    • referencedMemberName

      String referencedMemberName()
      Deprecated.
      Get the field, constructor or method substring of the @see reference. Return null if the reference is to any other element or to any non-element. References to member classes (nested classes) return null. For example, for:

        @see String#startsWith(String)

      return "startsWith(String)".
      Returns:
      "startsWith(String)".
    • referencedMember

      MemberDoc referencedMember()
      Deprecated.
      Get the member doc for the field, constructor or method referenced by @see. Return null if the member cannot be found or if the reference is to any other element or to any non-element. References to member classes (nested classes) return null. For example, for:

        @see String#startsWith(java.lang.String)

      return the MethodDoc for startsWith.
      Returns:
      the MethodDoc for startsWith.