Class TagletWriter
java.lang.Object
gw.gosudoc.com.sun.tools.doclets.internal.toolkit.taglets.TagletWriter
- Direct Known Subclasses:
TagletWriterImpl
Deprecated.
The interface for the taglet writer.
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
FieldsModifier and TypeFieldDescriptionprotected final boolean
Deprecated.True if we only want to write the first sentence. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected abstract Content
codeTagOutput
(Tag tag) Deprecated.Return the output for a{@code ...}
tag.abstract Content
commentTagsToOutput
(Doc holderDoc, Tag[] tags) Deprecated.Converts inline tags and text to TagOutput, expanding the inline tags along the way.abstract Content
commentTagsToOutput
(Tag holderTag, Doc holderDoc, Tag[] tags, boolean isFirstSentence) Deprecated.Converts inline tags and text to TagOutput, expanding the inline tags along the way.abstract Content
commentTagsToOutput
(Tag holderTag, Tag[] tags) Deprecated.Converts inline tags and text to TagOutput, expanding the inline tags along the way.abstract Configuration
Deprecated.protected abstract Content
deprecatedTagOutput
(Doc doc) Deprecated.Return the deprecated tag output.static void
genTagOuput
(TagletManager tagletManager, Doc doc, Taglet[] taglets, TagletWriter writer, Content output) Deprecated.Given an output object, append to it the tag documentation for the given member.protected abstract Content
Deprecated.Returns the output for the DocRoot inline tag.static Content
getInlineTagOuput
(TagletManager tagletManager, Tag holderTag, Tag inlineTag, TagletWriter tagletWriter) Deprecated.Given an inline tag, return its output.protected abstract MessageRetriever
Deprecated.ReturnsMessageRetriever
for output purposes.abstract Content
Deprecated.protected abstract Content
getParamHeader
(String header) Deprecated.Return the header for the param tags.protected abstract Content
Deprecated.Return the header for the throws tag.protected abstract Content
indexTagOutput
(Tag tag) Deprecated.Return the output for a tag.protected abstract Content
literalTagOutput
(Tag tag) Deprecated.Return the output for a{@literal ...}
tag.protected abstract Content
paramTagOutput
(ParamTag paramTag, String paramName) Deprecated.Return the output for param tags.protected abstract Content
propertyTagOutput
(Tag propertyTag, String prefix) Deprecated.Return the output for property tags.protected abstract Content
returnTagOutput
(Tag returnTag) Deprecated.Return the return tag output.protected abstract Content
seeTagOutput
(Doc holder, SeeTag[] seeTags) Deprecated.Return the see tag output.protected abstract Content
simpleTagOutput
(Tag[] simpleTags, String header) Deprecated.Return the output for a simple tag.protected abstract Content
simpleTagOutput
(Tag simpleTag, String header) Deprecated.Return the output for a simple tag.protected abstract Content
throwsTagOutput
(ThrowsTag throwsTag) Deprecated.Return the header for the throws tag.protected abstract Content
throwsTagOutput
(Type throwsType) Deprecated.Return the output for the throws tag.protected abstract Content
valueTagOutput
(FieldDoc field, String constantVal, boolean includeLink) Deprecated.Return the output for the value tag.
-
Field Details
-
isFirstSentence
protected final boolean isFirstSentenceDeprecated.True if we only want to write the first sentence.
-
-
Constructor Details
-
TagletWriter
protected TagletWriter(boolean isFirstSentence) Deprecated.
-
-
Method Details
-
getOutputInstance
Deprecated.- Returns:
- an instance of an output object.
-
codeTagOutput
Deprecated.Return the output for a{@code ...}
tag.- Parameters:
tag
- the tag.- Returns:
- the output of the taglet.
-
indexTagOutput
Deprecated.Return the output for a tag.- Parameters:
tag
- the tag.- Returns:
- the output of the taglet.
-
getDocRootOutput
Deprecated.Returns the output for the DocRoot inline tag.- Returns:
- the output for the DocRoot inline tag.
-
deprecatedTagOutput
Deprecated.Return the deprecated tag output.- Parameters:
doc
- the doc to write deprecated documentation for.- Returns:
- the output of the deprecated tag.
-
literalTagOutput
Deprecated.Return the output for a{@literal ...}
tag.- Parameters:
tag
- the tag.- Returns:
- the output of the taglet.
-
getMsgRetriever
Deprecated.ReturnsMessageRetriever
for output purposes.- Returns:
MessageRetriever
for output purposes.
-
getParamHeader
Deprecated.Return the header for the param tags.- Parameters:
header
- the header to display.- Returns:
- the header for the param tags.
-
paramTagOutput
Deprecated.Return the output for param tags.- Parameters:
paramTag
- the parameter to document.paramName
- the name of the parameter.- Returns:
- the output of the param tag.
-
propertyTagOutput
Deprecated.Return the output for property tags.- Parameters:
propertyTag
- the parameter to document.prefix
- the text with which to prefix the property name.- Returns:
- the output of the param tag.
-
returnTagOutput
Deprecated.Return the return tag output.- Parameters:
returnTag
- the return tag to output.- Returns:
- the output of the return tag.
-
seeTagOutput
Deprecated.Return the see tag output.- Parameters:
seeTags
- the array of See tags.- Returns:
- the output of the see tags.
-
simpleTagOutput
Deprecated.Return the output for a simple tag.- Parameters:
simpleTags
- the array of simple tags.- Returns:
- the output of the simple tags.
-
simpleTagOutput
Deprecated.Return the output for a simple tag.- Parameters:
simpleTag
- the simple tag.- Returns:
- the output of the simple tag.
-
getThrowsHeader
Deprecated.Return the header for the throws tag.- Returns:
- the header for the throws tag.
-
throwsTagOutput
Deprecated.Return the header for the throws tag.- Parameters:
throwsTag
- the throws tag.- Returns:
- the output of the throws tag.
-
throwsTagOutput
Deprecated.Return the output for the throws tag.- Parameters:
throwsType
- the throws type.- Returns:
- the output of the throws type.
-
valueTagOutput
Deprecated.Return the output for the value tag.- Parameters:
field
- the constant field that holds the value tag.constantVal
- the constant value to document.includeLink
- true if we should link the constant text to the constant field itself.- Returns:
- the output of the value tag.
-
genTagOuput
public static void genTagOuput(TagletManager tagletManager, Doc doc, Taglet[] taglets, TagletWriter writer, Content output) Deprecated.Given an output object, append to it the tag documentation for the given member.- Parameters:
tagletManager
- the manager that manages the taglets.doc
- the Doc that we are print tags for.taglets
- the taglets to print.writer
- the writer that will generate the output strings.output
- the output buffer to store the output in.
-
getInlineTagOuput
public static Content getInlineTagOuput(TagletManager tagletManager, Tag holderTag, Tag inlineTag, TagletWriter tagletWriter) Deprecated.Given an inline tag, return its output.- Parameters:
tagletManager
- The taglet manager for the current doclet.holderTag
- The tag this holds this inline tag. Null if there is no tag that holds it.inlineTag
- The inline tag to be documented.tagletWriter
- The taglet writer to write the output.- Returns:
- The output of the inline tag.
-
commentTagsToOutput
Deprecated.Converts inline tags and text to TagOutput, expanding the inline tags along the way. Called wherever text can contain an inline tag, such as in comments or in free-form text arguments to non-inline tags.- Parameters:
holderTag
- the tag that holds the documentation.tags
- array of text tags and inline tags (often alternating) present in the text of interest for this doc.- Returns:
- the
Content
representing the comments.
-
commentTagsToOutput
Deprecated.Converts inline tags and text to TagOutput, expanding the inline tags along the way. Called wherever text can contain an inline tag, such as in comments or in free-form text arguments to non-inline tags.- Parameters:
holderDoc
- specific doc where comment resides.tags
- array of text tags and inline tags (often alternating) present in the text of interest for this doc.- Returns:
- the
Content
representing the comments.
-
commentTagsToOutput
public abstract Content commentTagsToOutput(Tag holderTag, Doc holderDoc, Tag[] tags, boolean isFirstSentence) Deprecated.Converts inline tags and text to TagOutput, expanding the inline tags along the way. Called wherever text can contain an inline tag, such as in comments or in free-form text arguments to non-inline tags.- Parameters:
holderTag
- the tag that holds the documentation.holderDoc
- specific doc where comment resides.tags
- array of text tags and inline tags (often alternating) present in the text of interest for this doc.isFirstSentence
- true if this is the first sentence.- Returns:
- the
Content
representing the comments.
-
configuration
Deprecated.- Returns:
- an instance of the configuration used for this doclet.
-