Package uk.ac.starlink.ttools.build
Class HtmlDocletOutput
java.lang.Object
uk.ac.starlink.ttools.build.HtmlDocletOutput
- All Implemented Interfaces:
DocletOutput
DocletOutput implementation for writing basic HTML,
with one file per class, method and field.
The output is suitable for display in a
MethodBrowser
.- Since:
- 24 Jan 2023
- Author:
- Mark Taylor
-
Nested Class Summary
Nested classes/interfaces inherited from interface uk.ac.starlink.ttools.build.DocletOutput
DocletOutput.DocVariable
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
endClass()
End output of documentation for the most recently started class.void
End output of the most recently started member.void
Called at the end of operation.void
outExamples
(String heading, String[] examples) Writes one or more example entries.void
outMemberItem
(String name, String val) Writes a name-value pair presenting an attribute of a class member (field or method).void
outParameters
(DocletOutput.DocVariable[] params) Writes a description of the parameters of a method.void
Writes information about the return value of a method.void
Writes one or more See Also entries.void
startClass
(String className, String firstSentence, String fullDescription) Begin output of documentation for a given class.void
startMember
(String memberName, String memberType, String uniqueId, String description) Begin output of documentation for a given class member (field or method).void
Called at the start of operation.
-
Constructor Details
-
HtmlDocletOutput
Constructor.- Parameters:
baseDir
- base directoryisHeadings
- if true, writes a couple of extra files
-
-
Method Details
-
startOutput
Description copied from interface:DocletOutput
Called at the start of operation.- Specified by:
startOutput
in interfaceDocletOutput
- Throws:
IOException
-
endOutput
Description copied from interface:DocletOutput
Called at the end of operation.- Specified by:
endOutput
in interfaceDocletOutput
- Throws:
IOException
-
startClass
public void startClass(String className, String firstSentence, String fullDescription) throws IOException Description copied from interface:DocletOutput
Begin output of documentation for a given class.- Specified by:
startClass
in interfaceDocletOutput
- Parameters:
className
- fully qualified class namefirstSentence
- first sentence of class description, in HTMLfullDescription
- full text of class description, in HTML- Throws:
IOException
-
endClass
public void endClass()Description copied from interface:DocletOutput
End output of documentation for the most recently started class.- Specified by:
endClass
in interfaceDocletOutput
-
startMember
public void startMember(String memberName, String memberType, String uniqueId, String description) throws IOException Description copied from interface:DocletOutput
Begin output of documentation for a given class member (field or method).- Specified by:
startMember
in interfaceDocletOutput
- Parameters:
memberName
- user-readable name of the membermemberType
- some user-readable (maybe avoiding technical terms) description of what kind of member it isuniqueId
- string uniquely identifying this member within its parent classdescription
- full text of member description, in HTML- Throws:
IOException
-
endMember
Description copied from interface:DocletOutput
End output of the most recently started member.- Specified by:
endMember
in interfaceDocletOutput
- Throws:
IOException
-
outMemberItem
Description copied from interface:DocletOutput
Writes a name-value pair presenting an attribute of a class member (field or method).- Specified by:
outMemberItem
in interfaceDocletOutput
- Parameters:
name
- item nameval
- item value, may be HTML- Throws:
IOException
-
outParameters
Description copied from interface:DocletOutput
Writes a description of the parameters of a method.- Specified by:
outParameters
in interfaceDocletOutput
- Parameters:
params
- parameter list- Throws:
IOException
-
outReturn
Description copied from interface:DocletOutput
Writes information about the return value of a method.- Specified by:
outReturn
in interfaceDocletOutput
- Parameters:
type
- return type specification for presentation to the usercomment
- description of returned value, may be HTML- Throws:
IOException
-
outExamples
Description copied from interface:DocletOutput
Writes one or more example entries.- Specified by:
outExamples
in interfaceDocletOutput
- Parameters:
heading
- heading for examples sectionexamples
- list of example lines, may be HTML- Throws:
IOException
-
outSees
Description copied from interface:DocletOutput
Writes one or more See Also entries.- Specified by:
outSees
in interfaceDocletOutput
- Parameters:
heading
- heading for See Also sectionsees
- list of entries, may be HTML- Throws:
IOException
-