org.codehaus.groovy.ant
Class Groovydoc

java.lang.Object
  org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.Task
          org.codehaus.groovy.ant.Groovydoc

All Implemented Interfaces:

Cloneable

public class Groovydoc
extends Task

Access to the GroovyDoc tool from Ant.

Version:

$Id$

Field Summary

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

target, taskName, taskType, wrapper

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

description, location, project

Constructor Summary

Groovydoc()

Method Summary

LinkArgument	createLink() Create link to Javadoc/GroovyDoc output at the given URL.
void	execute()
void	setAuthor(boolean author) If set to false, author will not be displayed.
void	setDestdir(File dir) Set the directory where the Groovydoc output will be generated.
void	setDoctitle(String htmlTitle) Set the title for the overview page.
void	setFooter(String footer) Set the footer to place at the bottom of each generated html page.
void	setHeader(String header) Specifies the header text to be placed at the top of each output file.
void	setOverview(File file) Specify the file containing the overview to be included in the generated documentation.
void	setPackage(boolean b) Indicate whether only package, protected and public classes and members are to be included in the scope processed.
void	setPackagenames(String packages) Set the package names to be processed.
void	setPrivate(boolean b) Indicate whether all classes and members are to be included in the scope processed.
void	setProtected(boolean b) Indicate whether only protected and public classes and members are to be included in the scope processed.
void	setPublic(boolean b) Indicate whether only public classes and members are to be included in the scope processed.
void	setSourcepath(Path src) Specify where to find source file
void	setUse(boolean b)
void	setWindowtitle(String title) Set the title to be placed in the HTML <title> tag of the generated documentation.

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

bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

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

clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject

Methods inherited from class java.lang.Object

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

Constructor Detail

Groovydoc

public Groovydoc()

Method Detail

setSourcepath

public void setSourcepath(Path src)

Specify where to find source file

Parameters:

src - a Path instance containing the various source directories.

setDestdir

public void setDestdir(File dir)

Set the directory where the Groovydoc output will be generated.

Parameters:

dir - the destination directory.

setAuthor

public void setAuthor(boolean author)

If set to false, author will not be displayed. Currently not used.

Parameters:

author - new value

setPackagenames

public void setPackagenames(String packages)

Set the package names to be processed.

Parameters:

packages - a comma separated list of packages specs (may be wildcarded).

setUse

public void setUse(boolean b)

setWindowtitle

public void setWindowtitle(String title)

Set the title to be placed in the HTML <title> tag of the generated documentation.

Parameters:

title - the window title to use.

setDoctitle

public void setDoctitle(String htmlTitle)

Set the title for the overview page.

Parameters:

htmlTitle - the html to use for the title.

setOverview

public void setOverview(File file)

Specify the file containing the overview to be included in the generated documentation.

Parameters:

file - the overview file

setPrivate

public void setPrivate(boolean b)

Indicate whether all classes and members are to be included in the scope processed.

Parameters:

b - true if scope is to be private level.

setPublic

public void setPublic(boolean b)

Indicate whether only public classes and members are to be included in the scope processed. Currently not used.

Parameters:

b - true if scope only includes public level classes and members

setProtected

public void setProtected(boolean b)

Indicate whether only protected and public classes and members are to be included in the scope processed. Currently not used.

Parameters:

b - true if scope includes protected level classes and members

setPackage

public void setPackage(boolean b)

Indicate whether only package, protected and public classes and members are to be included in the scope processed. Currently not used.

Parameters:

b - true if scope includes package level classes and members

setFooter

public void setFooter(String footer)

Set the footer to place at the bottom of each generated html page.

Parameters:

footer - the footer value

setHeader

public void setHeader(String header)

Specifies the header text to be placed at the top of each output file. The header will be placed to the right of the upper navigation bar. It may contain HTML tags and white space, though if it does, it must be enclosed in quotes. Any internal quotation marks within the header may have to be escaped.

Parameters:

header - the header value

execute

public void execute()
             throws BuildException

Overrides:

execute in class Task

Throws:

BuildException

createLink

public LinkArgument createLink()

Create link to Javadoc/GroovyDoc output at the given URL.

Returns:

link argument to configure