Package adams.doc.javadoc

Class TechnicalInformationHandlerJavadoc

java.lang.Object

adams.core.logging.LoggingObject

adams.doc.javadoc.Javadoc

adams.doc.javadoc.TechnicalInformationHandlerJavadoc

All Implemented Interfaces:

Destroyable, LoggingSupporter, OptionHandler, UserModeSupporter, SizeOfHandler, Serializable

public class TechnicalInformationHandlerJavadoc
extends Javadoc

Generates Javadoc comments from the TechnicalInformationHandler's data. Update the BibTex references and the plaintext techincal information.

Valid options are:

-env <java.lang.String> (property: environment)
         The class to use for determining the environment.
         default: adams.core.Environment
 

-W <java.lang.String> (property: classname)
         The class to load.
         default: adams.doc.AllJavadoc
 

-nostars (property: useStars)
         Controls the use of '*' in the Javadoc.
 

-dir <java.lang.String> (property: dir)
         The directory above the package hierarchy of the class.
         default: .
 

-silent (property: silent)
         Suppresses printing in the console.
 

-noprolog (property: Prolog)
         Controls the 'BibTex:' prolog in the Javadoc.
 

Version:

$Revision$

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

PLAINTEXT_STARTTAG, PLAINTEXT_ENDTAG, BIBTEX_STARTTAG, BIBTEX_ENDTAG, TechnicalInformationHandlerJavadoc, Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static String	BIBTEX_ENDTAG	the end comment tag for inserting the generated BibTex.
static String	BIBTEX_STARTTAG	the start comment tag for inserting the generated BibTex.
protected boolean	m_Prolog	whether to include the "Valid options..." prolog in the Javadoc.
static String	PLAINTEXT_ENDTAG	the end comment tag for inserting the generated BibTex.
static String	PLAINTEXT_STARTTAG	the start comment tag for inserting the generated BibTex.

Fields inherited from class adams.doc.javadoc.Javadoc

m_Classname, m_Dir, m_EndTag, m_Environment, m_IsBlock, m_OptionManager, m_Silent, m_StartTag, m_UserMode, m_UseStars

Fields inherited from class adams.core.logging.LoggingObject

m_Logger, m_LoggingIsEnabled, m_LoggingLevel

Constructor Summary

Constructors

Constructor	Description
TechnicalInformationHandlerJavadoc()

Method Summary

Modifier and Type	Method	Description
void	defineOptions()	Adds options to the internal list of options.
protected String	generateJavadoc(int index)	generates and returns the Javadoc for the specified start/end tag pair.
boolean	getProlog()	whether "Valid options are..." prolog is included in the Javadoc.
protected void	initialize()	Initializes the members.
static void	main(String[] args)	Parses the given commandline parameters and generates the Javadoc.
String	PrologTipText()	Returns the tip text for this property.
void	setProlog(boolean value)	sets whether to add the "Valid options are..." prolog.

Methods inherited from class adams.doc.javadoc.Javadoc

canInstantiateClass, classnameTipText, cleanUpOptions, destroy, dirTipText, environmentTipText, forCommandLine, forName, generate, generateJavadoc, getClassname, getDir, getEnvironment, getIndentionLength, getIndentionString, getInstance, getJavadocs, getOptionManager, getSilent, getUserMode, getUseStars, indent, newOptionManager, println, runJavadoc, setClassname, setDir, setEnvironment, setSilent, setUserMode, setUseStars, silentTipText, toCommandLine, toHTML, toString, updateJavadoc, updateJavadoc, updateJavadoc, userModeTipText, useStarsTipText

Methods inherited from class adams.core.logging.LoggingObject

configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

PLAINTEXT_STARTTAG

public static final String PLAINTEXT_STARTTAG

the start comment tag for inserting the generated BibTex.

See Also:

Constant Field Values

PLAINTEXT_ENDTAG

public static final String PLAINTEXT_ENDTAG

the end comment tag for inserting the generated BibTex.

See Also:

Constant Field Values

BIBTEX_STARTTAG

public static final String BIBTEX_STARTTAG

the start comment tag for inserting the generated BibTex.

See Also:

Constant Field Values

BIBTEX_ENDTAG

public static final String BIBTEX_ENDTAG

the end comment tag for inserting the generated BibTex.

See Also:

Constant Field Values

m_Prolog

protected boolean m_Prolog

whether to include the "Valid options..." prolog in the Javadoc.

Constructor Detail

TechnicalInformationHandlerJavadoc

public TechnicalInformationHandlerJavadoc()

Method Detail

initialize

protected void initialize()

Initializes the members.

Overrides:

initialize in class Javadoc

defineOptions

public void defineOptions()

Adds options to the internal list of options.

Specified by:

defineOptions in interface OptionHandler

Overrides:

defineOptions in class Javadoc

setProlog

public void setProlog(boolean value)

sets whether to add the "Valid options are..." prolog.

Parameters:

value - true if the prolog is to be used

getProlog

public boolean getProlog()

whether "Valid options are..." prolog is included in the Javadoc.

Returns:

whether the prolog is currently used

PrologTipText

public String PrologTipText()

Returns the tip text for this property.

Returns:

tip text for this property suitable for displaying in the GUI or for listing the options.

generateJavadoc

protected String generateJavadoc(int index)
                          throws Exception

generates and returns the Javadoc for the specified start/end tag pair.

Specified by:

generateJavadoc in class Javadoc

Parameters:

index - the index in the start/end tag array

Returns:

the generated Javadoc

Throws:

Exception - in case the generation fails

main

public static void main(String[] args)

Parses the given commandline parameters and generates the Javadoc.

Parameters:

args - the commandline parameters for the object