java.lang.Object
gw.gosudoc.com.sun.tools.doclets.internal.toolkit.util.TextTag
All Implemented Interfaces:
Tag

@Deprecated public class TextTag extends Object implements Tag
Deprecated.
A tag that holds nothing but plain text. This is useful for passing text to methods that only accept inline tags as a parameter.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Since:
1.5
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected final Doc
    Deprecated.
     
    protected final String
    Deprecated.
     
    protected final String
    Deprecated.
     
  • Constructor Summary

    Constructors
    Constructor
    Description
    TextTag(Doc holder, String text)
    Deprecated.
    Constructor
  • Method Summary

    Modifier and Type
    Method
    Description
    Tag[]
    Deprecated.
    Return the first sentence of the comment as an array of tags.
    Deprecated.
    Return the containing Doc of this Tag element.
    Tag[]
    Deprecated.
    For a documentation comment with embedded {@link} tags, return an array of Tag objects.
    Deprecated.
    Return the kind of this tag.
    Deprecated.
    Return the name of this tag.
    Deprecated.
    Return the source position of this tag.
    Deprecated.
    Return the text of this tag, that is, the portion beyond tag name.
    Deprecated.
    Convert this object to a string.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Field Details

  • Constructor Details

    • TextTag

      public TextTag(Doc holder, String text)
      Deprecated.
      Constructor
  • Method Details

    • name

      public String name()
      Deprecated.
      Return the name of this tag. The name is the string starting with "@" that is used in a doc comment, such as @return. For inline tags, such as {@link}, the curly brackets are not part of the name, so in this example the name would be simply @link.
      Specified by:
      name in interface Tag
      Returns:
      the name of this tag
    • holder

      public Doc holder()
      Deprecated.
      Return the containing Doc of this Tag element.
      Specified by:
      holder in interface Tag
      Returns:
      the containing Doc of this Tag element
    • kind

      public String kind()
      Deprecated.
      Return the kind of this tag. For most tags, kind() == name(); the following table lists those cases where there is more than one tag of a given kind:
      Related Tags
      kind() name()
      @throws @throws
      @throws @exception
      @see @see
      @see @link
      @see @linkplain
      @serial @serial
      @serial @serialData
      Specified by:
      kind in interface Tag
      Returns:
      the kind of this tag.
    • text

      public String text()
      Deprecated.
      Return the text of this tag, that is, the portion beyond tag name.
      Specified by:
      text in interface Tag
      Returns:
      the text of this tag
    • toString

      public String toString()
      Deprecated.
      Convert this object to a string.
      Specified by:
      toString in interface Tag
      Overrides:
      toString in class Object
    • inlineTags

      public Tag[] inlineTags()
      Deprecated.
      For a documentation comment with embedded {@link} tags, return an array of Tag objects. The entire doc comment is broken down into strings separated by {@link} tags, where each successive element of the array represents either a string or {@link} tag, in order, from start to end. Each string is represented by a Tag object of name "Text", where Tag.text() returns the string. Each {@link} tag is represented by a SeeTag of name "@link" and kind "@see". For example, given the following comment tag:

      This is a {@link Doc commentlabel} example.

      return an array of Tag objects:

      • tags[0] is a Tag with name "Text" and text consisting of "This is a "
      • tags[1] is a SeeTag with name "@link", referenced class Doc and label "commentlabel"
      • tags[2] is a Tag with name "Text" and text consisting of " example."
      Specified by:
      inlineTags in interface Tag
      Returns:
      Tag[] array of tags
      See Also:
    • firstSentenceTags

      public Tag[] firstSentenceTags()
      Deprecated.
      Return the first sentence of the comment as an array of tags. Includes inline tags (i.e. {@link reference} tags) but not block tags. Each section of plain text is represented as a Tag of kind "Text". Inline tags are represented as a SeeTag of kind "@link". If the locale is English language, the first sentence is determined by the rules described in the Java Language Specification (first version): "This sentence ends at the first period that is followed by a blank, tab, or line terminator or at the first tagline.", in addition a line will be terminated by paragraph and section terminating HTML tags: <p> </p> <h1> <h2> <h3> <h4> <h5> <h6> <hr> <pre> or </pre>. If the locale is not English, the sentence end will be determined by BreakIterator.getSentenceInstance(Locale).
      Specified by:
      firstSentenceTags in interface Tag
      Returns:
      an array of Tag objects representing the first sentence of the comment
    • position

      public SourcePosition position()
      Deprecated.
      Return the source position of this tag.
      Specified by:
      position in interface Tag
      Returns:
      the source position of this tag.