Overview  Package   Class  Deprecated  Index  Help 
Groovy Documentation
FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

org.gradle.api.tasks.javadoc
[Java] Class Groovydoc

java.lang.Object
  org.gradle.api.internal.AbstractTask
      org.gradle.api.DefaultTask
          org.gradle.api.internal.ConventionTask
              org.gradle.api.tasks.SourceTask
                  org.gradle.api.tasks.javadoc.Groovydoc

public class Groovydoc
extends SourceTask

Generates HTML API documentation for Groovy source, and optionally, Java source.

This task uses Groovy's Groovydoc tool to generate the API documentation. Please note that the Groovydoc tool has some severe limitations at the moment (for example no doc for properties comments). The version of the Groovydoc that is used, is the one from the Groovy defined in the build script. Please note also, that the Groovydoc tool prints to System.out for many of its statements and does circumvents our logging currently.

Authors:
Hans Dockter

Nested Class Summary
static class Groovydoc.Link

A Link class represent a link between groovydoc/javadoc output and url.
 
Field Summary
 
Fields inherited from class org.gradle.api.internal.ConventionTask
TASK_NAME, TASK_DESCRIPTION, TASK_GROUP, TASK_TYPE, TASK_DEPENDS_ON, TASK_OVERWRITE, TASK_ACTION
 
Constructor Summary
Groovydoc()

 
Method Summary
protected void generate()

AntGroovydoc getAntGroovydoc()

FileCollection getClasspath()

Returns the classpath used to locate classes referenced by the documented sources.
java.io.File getDestinationDir()

Returns the directory to generate the documentation into.
java.lang.String getDocTitle()

Returns the title for the package index(first) page.

java.lang.String getFooter()

Returns the html footer for each page.

FileCollection getGroovyClasspath()

Returns the classpath containing the Groovy library to be used.
java.lang.String getHeader()

Returns the html header for each page.

java.util.Set getLinks()

Returns the links to groovydoc/javadoc output at the given URL.
java.lang.String getOverview()

Returns a html file to be used for overview documentation.

java.lang.String getWindowTitle()

Returns the browser window title for the documentation.

boolean isIncludePrivate()

Returns whether to include all classes and members (i.e. including private ones).
boolean isUse()

Returns whether to create class and package usage pages.
void link(java.lang.String url, java.lang.String... packages)

Add links to groovydoc/javadoc output at the given URL.
void setAntGroovydoc(AntGroovydoc antGroovydoc)

void setClasspath(FileCollection classpath)

Sets the classpath used to locate classes referenced by the documented sources.
void setDestinationDir(java.io.File destinationDir)

Sets the directory to generate the documentation into.
void setDocTitle(java.lang.String docTitle)

Sets title for the package index(first) page (optional).
void setFooter(java.lang.String footer)

Sets footer text for each page (optional).
void setGroovyClasspath(FileCollection groovyClasspath)

Sets the classpath containing the Groovy library to be used.
void setHeader(java.lang.String header)

Sets header text for each page (optional).
void setIncludePrivate(boolean includePrivate)

Sets whether to include all classes and members (i.e. including private ones) if set to true.
void setLinks(java.util.Set links)

Sets links to groovydoc/javadoc output at the given URL.
void setOverview(java.lang.String overview)

Sets a html file to be used for overview documentation (optional).
void setUse(boolean use)

Sets whether to create class and package usage pages.
void setWindowTitle(java.lang.String windowTitle)

Sets the browser window title for the documentation.
 
Methods inherited from class SourceTask
exclude, exclude, exclude, exclude, getDefaultSource, getExcludes, getIncludes, getSource, include, include, include, include, setExcludes, setIncludes, setSource, source
 
Methods inherited from class org.gradle.api.internal.ConventionTask
org.gradle.api.internal.ConventionTask#conventionMapping(java.lang.String, org.gradle.api.tasks.ConventionValue), org.gradle.api.internal.ConventionTask#getConventionMapping(), org.gradle.api.internal.ConventionTask#setConventionMapping(org.gradle.api.internal.ConventionMapping), org.gradle.api.internal.ConventionTask#setProperty(java.lang.String, java.lang.Object), org.gradle.api.internal.ConventionTask#toString(), org.gradle.api.internal.ConventionTask#compareTo(org.gradle.api.Task), org.gradle.api.internal.ConventionTask#compareTo(java.lang.Object), org.gradle.api.internal.ConventionTask#getName(), org.gradle.api.internal.ConventionTask#getActions(), org.gradle.api.internal.ConventionTask#setName(java.lang.String), org.gradle.api.internal.ConventionTask#getState(), org.gradle.api.internal.ConventionTask#getPath(), org.gradle.api.internal.ConventionTask#getLogger(), org.gradle.api.internal.ConventionTask#leftShift(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#execute(), org.gradle.api.internal.ConventionTask#configure(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#configure(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#isEnabled(), org.gradle.api.internal.ConventionTask#getDescription(), org.gradle.api.internal.ConventionTask#captureStandardOutput(org.gradle.api.logging.LogLevel), org.gradle.api.internal.ConventionTask#disableStandardOutputCapture(), org.gradle.api.internal.ConventionTask#property(java.lang.String), org.gradle.api.internal.ConventionTask#setEnabled(boolean), org.gradle.api.internal.ConventionTask#getOutputs(), org.gradle.api.internal.ConventionTask#getOutputs(), org.gradle.api.internal.ConventionTask#getProject(), org.gradle.api.internal.ConventionTask#setActions(java.util.List), org.gradle.api.internal.ConventionTask#getTaskDependencies(), org.gradle.api.internal.ConventionTask#getTaskDependencies(), org.gradle.api.internal.ConventionTask#getDependsOn(), org.gradle.api.internal.ConventionTask#setDependsOn(java.lang.Iterable), org.gradle.api.internal.ConventionTask#dependsOn([Ljava.lang.Object;), org.gradle.api.internal.ConventionTask#onlyIf(org.gradle.api.specs.Spec), org.gradle.api.internal.ConventionTask#onlyIf(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#setOnlyIf(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#setOnlyIf(org.gradle.api.specs.Spec), org.gradle.api.internal.ConventionTask#setDidWork(boolean), org.gradle.api.internal.ConventionTask#getDidWork(), org.gradle.api.internal.ConventionTask#doFirst(org.gradle.api.Action), org.gradle.api.internal.ConventionTask#doFirst(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#doLast(org.gradle.api.Action), org.gradle.api.internal.ConventionTask#doLast(groovy.lang.Closure), org.gradle.api.internal.ConventionTask#deleteAllActions(), org.gradle.api.internal.ConventionTask#getEnabled(), org.gradle.api.internal.ConventionTask#getAnt(), org.gradle.api.internal.ConventionTask#getLogging(), org.gradle.api.internal.ConventionTask#hasProperty(java.lang.String), org.gradle.api.internal.ConventionTask#getConvention(), org.gradle.api.internal.ConventionTask#setDescription(java.lang.String), org.gradle.api.internal.ConventionTask#getGroup(), org.gradle.api.internal.ConventionTask#setGroup(java.lang.String), org.gradle.api.internal.ConventionTask#dependsOnTaskDidWork(), org.gradle.api.internal.ConventionTask#getInputs(), org.gradle.api.internal.ConventionTask#getTemporaryDir(), org.gradle.api.internal.ConventionTask#getExtensions(), org.gradle.api.internal.ConventionTask#getAsDynamicObject(), org.gradle.api.internal.ConventionTask#getAdditionalProperties(), org.gradle.api.internal.ConventionTask#getStandardOutputCapture(), org.gradle.api.internal.ConventionTask#executeWithoutThrowingTaskFailure(), org.gradle.api.internal.ConventionTask#setProject(org.gradle.api.Project), org.gradle.api.internal.ConventionTask#getDynamicObjectHelper(), org.gradle.api.internal.ConventionTask#addValidator(org.gradle.api.internal.tasks.execution.TaskValidator), org.gradle.api.internal.ConventionTask#getValidators(), org.gradle.api.internal.ConventionTask#getExecuter(), org.gradle.api.internal.ConventionTask#setExecuter(org.gradle.api.internal.tasks.TaskExecuter), org.gradle.api.internal.ConventionTask#getOnlyIf(), org.gradle.api.internal.ConventionTask#getTemporaryDirFactory(), org.gradle.api.internal.ConventionTask#injectIntoNewInstance(org.gradle.api.internal.project.ProjectInternal, java.lang.String, java.util.concurrent.Callable), org.gradle.api.internal.ConventionTask#wait(), org.gradle.api.internal.ConventionTask#wait(long), org.gradle.api.internal.ConventionTask#wait(long, int), org.gradle.api.internal.ConventionTask#equals(java.lang.Object), org.gradle.api.internal.ConventionTask#hashCode(), org.gradle.api.internal.ConventionTask#getClass(), org.gradle.api.internal.ConventionTask#notify(), org.gradle.api.internal.ConventionTask#notifyAll()
 

Constructor Detail

Groovydoc

public Groovydoc()

 
Method Detail

generate

@TaskAction
protected void generate()

getAntGroovydoc

public AntGroovydoc getAntGroovydoc()

getClasspath

@InputFiles
public FileCollection getClasspath()
Returns the classpath used to locate classes referenced by the documented sources.
Returns:
The classpath used to locate classes referenced by the documented sources

getDestinationDir

@OutputDirectory
public java.io.File getDestinationDir()
Returns the directory to generate the documentation into.
Returns:
The directory to generate the documentation into

getDocTitle

@Input
@Optional
public java.lang.String getDocTitle()
Returns the title for the package index(first) page. Set to null when there is no document title.

getFooter

@Input
@Optional
public java.lang.String getFooter()
Returns the html footer for each page. Set to null when there is no footer.

getGroovyClasspath

@InputFiles
public FileCollection getGroovyClasspath()
Returns the classpath containing the Groovy library to be used.
Returns:
The classpath containing the Groovy library to be used

getHeader

@Input
@Optional
public java.lang.String getHeader()
Returns the html header for each page. Set to null when there is no header.

getLinks

@Input
public java.util.Set getLinks()
Returns the links to groovydoc/javadoc output at the given URL.

getOverview

public java.lang.String getOverview()
Returns a html file to be used for overview documentation. Set to null when there is no overview file.

getWindowTitle

@Input
@Optional
public java.lang.String getWindowTitle()
Returns the browser window title for the documentation. Set to null when there is no window title.

isIncludePrivate

@Input
public boolean isIncludePrivate()
Returns whether to include all classes and members (i.e. including private ones).

isUse

@Input
public boolean isUse()
Returns whether to create class and package usage pages.

link

public void link(java.lang.String url, java.lang.String... packages)
Add links to groovydoc/javadoc output at the given URL.
Parameters:
url - Base URL of external site
packages - list of package prefixes

setAntGroovydoc

public void setAntGroovydoc(AntGroovydoc antGroovydoc)

setClasspath

public void setClasspath(FileCollection classpath)
Sets the classpath used to locate classes referenced by the documented sources.

setDestinationDir

public void setDestinationDir(java.io.File destinationDir)
Sets the directory to generate the documentation into.

setDocTitle

public void setDocTitle(java.lang.String docTitle)
Sets title for the package index(first) page (optional).
Parameters:
docTitle - the docTitle as html-code

setFooter

public void setFooter(java.lang.String footer)
Sets footer text for each page (optional).
Parameters:
footer - the footer as html-code

setGroovyClasspath

public void setGroovyClasspath(FileCollection groovyClasspath)
Sets the classpath containing the Groovy library to be used.

setHeader

public void setHeader(java.lang.String header)
Sets header text for each page (optional).
Parameters:
header - the header as html-code

setIncludePrivate

public void setIncludePrivate(boolean includePrivate)
Sets whether to include all classes and members (i.e. including private ones) if set to true.

setLinks

public void setLinks(java.util.Set links)
Sets links to groovydoc/javadoc output at the given URL.
Parameters:
links - The links to set
See Also:
link(String, String...)

setOverview

public void setOverview(java.lang.String overview)
Sets a html file to be used for overview documentation (optional).

setUse

public void setUse(boolean use)
Sets whether to create class and package usage pages.

setWindowTitle

public void setWindowTitle(java.lang.String windowTitle)
Sets the browser window title for the documentation.
Parameters:
windowTitle - A text for the windows title

 

Groovy Documentation