xjavadoc.ant
Class XJavadocTask

java.lang.Object
  org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.Task
          xjavadoc.ant.XJavadocTask

public abstract class XJavadocTask

extends org.apache.tools.ant.Task

This class should be subclassed to be used for XDocletImpl, revXDoclet etc.

Author:

Aslak Hellesøy, Ara Abrahamian

Field Summary

Fields inherited from class org.apache.tools.ant.Task

description, location, target, taskName, taskType, wrapper

Fields inherited from class org.apache.tools.ant.ProjectComponent

project

Constructor Summary

XJavadocTask()

Method Summary

void	addFileset(org.apache.tools.ant.types.FileSet set) Ant's <fileset> definition.
java.lang.Object	createIgnoredtag() Ignores one tag
void	execute() Implementation of Ant's Task.execute().
protected java.lang.String	getClasspath() Returns the classpath
protected XJavaDoc	getXJavaDoc()
void	setDocencoding(java.lang.String enc)
void	setEncoding(java.lang.String enc) set source file charset
void	setIgnoredtags(java.lang.String tags) Sets the tags to ignore if validation is true.
void	setSourcepath(org.apache.tools.ant.types.Path path) Deprecated. This method will disappear soon
void	setValidating(boolean flag) Sets whether or not tags will be validated.
protected abstract void	start() Implement this method and play with _xJavaDoc
protected void	validateOptions() Validate a Xdoclet task before running it.

Methods inherited from class org.apache.tools.ant.Task

getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorFlush, handleErrorOutput, handleFlush, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName

Methods inherited from class org.apache.tools.ant.ProjectComponent

getProject, setProject

Methods inherited from class java.lang.Object

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

Constructor Detail

XJavadocTask

public XJavadocTask()

Method Detail

setSourcepath

public void setSourcepath(org.apache.tools.ant.types.Path path)

Deprecated. This method will disappear soon

Parameters:

path -

getXJavaDoc

protected XJavaDoc getXJavaDoc()

setIgnoredtags

public void setIgnoredtags(java.lang.String tags)

Sets the tags to ignore if validation is true. The value should be a comma-separated list of tag names (without the tag name)

Parameters:

tags - tags that should be ignored when doing validation.

setValidating

public void setValidating(boolean flag)

Sets whether or not tags will be validated.

Parameters:

flag -

setEncoding

public void setEncoding(java.lang.String enc)

set source file charset

setDocencoding

public void setDocencoding(java.lang.String enc)

execute

public final void execute()
                   throws org.apache.tools.ant.BuildException

Implementation of Ant's Task.execute().

Throws:

org.apache.tools.ant.BuildException - Ant's way or reporting build exception

createIgnoredtag

public java.lang.Object createIgnoredtag()

Ignores one tag

Returns:

addFileset

public void addFileset(org.apache.tools.ant.types.FileSet set)

Ant's <fileset> definition. To define the files to parse.

Parameters:

set - a fileset to add

getClasspath

protected java.lang.String getClasspath()

Returns the classpath

Returns:

the classpath

start

protected abstract void start()
                       throws org.apache.tools.ant.BuildException

Implement this method and play with _xJavaDoc

Throws:

org.apache.tools.ant.BuildException - Ant's way of reporting exception

validateOptions

protected void validateOptions()
                        throws org.apache.tools.ant.BuildException

Validate a Xdoclet task before running it.

Throws:

org.apache.tools.ant.BuildException - in case the validation fails.