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 DocletOutput
DocletOutput.DocVariable -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidendClass()End output of documentation for the most recently started class.voidEnd output of the most recently started member.voidCalled at the end of operation.voidoutExamples(String heading, String[] examples) Writes one or more example entries.voidoutMemberItem(String name, String val) Writes a name-value pair presenting an attribute of a class member (field or method).voidoutParameters(DocletOutput.DocVariable[] params) Writes a description of the parameters of a method.voidWrites information about the return value of a method.voidWrites one or more See Also entries.voidstartClass(String className, String firstSentence, String fullDescription) Begin output of documentation for a given class.voidstartMember(String memberName, String memberType, String uniqueId, String description) Begin output of documentation for a given class member (field or method).voidCalled 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:DocletOutputCalled at the start of operation.- Specified by:
startOutputin interfaceDocletOutput- Throws:
IOException
-
endOutput
Description copied from interface:DocletOutputCalled at the end of operation.- Specified by:
endOutputin interfaceDocletOutput- Throws:
IOException
-
startClass
public void startClass(String className, String firstSentence, String fullDescription) throws IOException Description copied from interface:DocletOutputBegin output of documentation for a given class.- Specified by:
startClassin 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:DocletOutputEnd output of documentation for the most recently started class.- Specified by:
endClassin interfaceDocletOutput
-
startMember
public void startMember(String memberName, String memberType, String uniqueId, String description) throws IOException Description copied from interface:DocletOutputBegin output of documentation for a given class member (field or method).- Specified by:
startMemberin 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:DocletOutputEnd output of the most recently started member.- Specified by:
endMemberin interfaceDocletOutput- Throws:
IOException
-
outMemberItem
Description copied from interface:DocletOutputWrites a name-value pair presenting an attribute of a class member (field or method).- Specified by:
outMemberItemin interfaceDocletOutput- Parameters:
name- item nameval- item value, may be HTML- Throws:
IOException
-
outParameters
Description copied from interface:DocletOutputWrites a description of the parameters of a method.- Specified by:
outParametersin interfaceDocletOutput- Parameters:
params- parameter list- Throws:
IOException
-
outReturn
Description copied from interface:DocletOutputWrites information about the return value of a method.- Specified by:
outReturnin 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:DocletOutputWrites one or more example entries.- Specified by:
outExamplesin interfaceDocletOutput- Parameters:
heading- heading for examples sectionexamples- list of example lines, may be HTML- Throws:
IOException
-
outSees
Description copied from interface:DocletOutputWrites one or more See Also entries.- Specified by:
outSeesin interfaceDocletOutput- Parameters:
heading- heading for See Also sectionsees- list of entries, may be HTML- Throws:
IOException
-