gradle/org.gradle.api.tasks.javadoc/Groovydoc

Groovydoc

abstract class Groovydoc : SourceTask(source)

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 limitations at the moment. The version of the Groovydoc that is used, is the one from the Groovy dependency defined in the build script.

Constructors

constructor()

Types

open class Link : Serializable

A Link class represent a link between groovydoc/javadoc output and url.

Properties

@get:Input

val access: Property<GroovydocAccess>

open var antGroovydoc: AntGroovydoc

open var classpath: FileCollection

conventionMapping

open val conventionMapping: ConventionMapping

open var description: String

@get:OutputDirectory

open var destinationDir: File

@get:Nullable

@get:Input

open var docTitle: String

open var enabled: Boolean

val ExtensionAware.extra: ExtraPropertiesExtension

The extra properties extension in this object's extension container.

@get:Nullable

@get:Input

open var footer: String

groovyClasspath

open var groovyClasspath: FileCollection

open var group: String

@get:Nullable

@get:Input

open var header: String

impliesSubProjects

open var impliesSubProjects: Boolean

@get:Input

val includeAuthor: Property<Boolean>

includeMainForScripts

@get:Input

val includeMainForScripts: Property<Boolean>

@get:Input

open var links: Set<Groovydoc.Link>

@get:Input

val processScripts: Property<Boolean>

val state: TaskStateInternal

val TASK_ACTION: String = "action"

TASK_CONSTRUCTOR_ARGS

val TASK_CONSTRUCTOR_ARGS: String = "constructorArgs"

TASK_DEPENDS_ON

val TASK_DEPENDS_ON: String = "dependsOn"

TASK_DESCRIPTION

val TASK_DESCRIPTION: String = "description"

val TASK_GROUP: String = "group"

val TASK_NAME: String = "name"

val TASK_OVERWRITE: String = "overwrite"

val TASK_TYPE: String = "type"

val timeout: Property<Duration>

@get:Nullable

@get:Input

open var windowTitle: String

Functions

acceptServiceReferences

open fun acceptServiceReferences(serviceReferences: Set<ServiceReferenceSpec>)

appendParallelSafeAction

open fun appendParallelSafeAction(action: Action<in Task>)

open fun compareTo(otherTask: Task): Int

open fun configure(closure: Closure): Task

abstract fun configure(cl: Closure): T

inline fun <T : Any> ExtensionAware.configure(noinline configuration: T.() -> Unit)

Executes the given configuration block against the extension of the specified type.

conventionMapping

open fun conventionMapping(property: String, mapping: Callable<out Any>): Task

open fun dependsOn(paths: Array<Any>): Task

open fun doFirst(action: Action<in Task>): Task

open fun doLast(action: Action<in Task>): Task

doNotTrackState

open fun doNotTrackState(reasonNotToTrackState: String)

open fun exclude(excludes: Array<String>): SourceTask

abstract fun exclude(excludes: Array<String>): PatternFilterable

open fun finalizedBy(paths: Array<Any>): Task

open fun getActions(): List<Action<in Task>>

open fun getAnt(): AntBuilder

getAsDynamicObject

open fun getAsDynamicObject(): DynamicObject

open fun getConvention(): Convention

open fun getDependsOn(): Set<Any>

getDestroyables

open fun getDestroyables(): TaskDestroyables

open fun getDidWork(): Boolean

open fun getExcludes(): Set<String>

open fun getExtensions(): ExtensionContainer

open fun getFinalizedBy(): TaskDependency

getIdentityPath

open fun getIdentityPath(): Path

open fun getIncludes(): Set<String>

open fun getInputs(): TaskInputsInternal

abstract fun getInputs(): TaskInputs

getLifecycleDependencies

open fun getLifecycleDependencies(): TaskDependencyInternal

abstract fun getLifecycleDependencies(): TaskDependency

open fun getLocalState(): TaskLocalState

open fun getLogger(): Logger

open fun getLogging(): LoggingManager

getMustRunAfter

open fun getMustRunAfter(): TaskDependency

open fun getName(): String

open fun getOnlyIf(): Spec<in TaskInternal>

open fun getOutputs(): TaskOutputsInternal

abstract fun getOutputs(): TaskOutputs

getOverviewText

@Nullable

open fun getOverviewText(): TextResource

Returns a HTML text to be used for overview documentation.

open fun getPath(): String

open fun getProject(): Project

getReasonNotToTrackState

open fun getReasonNotToTrackState(): Optional<String>

getReasonTaskIsIncompatibleWithConfigurationCache

open fun getReasonTaskIsIncompatibleWithConfigurationCache(): Optional<String>

getRequiredServices

open fun getRequiredServices(): TaskRequiredServices

getSharedResources

open fun getSharedResources(): List<ResourceLock>

abstract fun getSharedResources(): List<out ResourceLock>

getShouldRunAfter

open fun getShouldRunAfter(): TaskDependency

@PathSensitive(value = PathSensitivity.RELATIVE)

open fun getSource(): FileTree

getStandardOutputCapture

open fun getStandardOutputCapture(): StandardOutputCapture

abstract fun getState(): TaskState

open fun getTaskActions(): List<InputChangesAwareTaskAction>

getTaskDependencies

open fun getTaskDependencies(): TaskDependencyInternal

abstract fun getTaskDependencies(): TaskDependency

getTaskIdentity

open fun getTaskIdentity(): TaskIdentity<out Any>

getTemporaryDir

open fun getTemporaryDir(): File

getTemporaryDirFactory

open fun getTemporaryDirFactory(): Factory<File>

open fun hasProperty(propertyName: String): Boolean

open fun hasTaskActions(): Boolean

open fun include(includes: Array<String>): SourceTask

abstract fun include(includes: Array<String>): PatternFilterable

injectIntoNewInstance

open fun <T : Task?> injectIntoNewInstance(project: ProjectInternal, identity: TaskIdentity<T>, factory: Callable<T>): T

isCompatibleWithConfigurationCache

open fun isCompatibleWithConfigurationCache(): Boolean

open fun isEnabled(): Boolean

isHasCustomActions

open fun isHasCustomActions(): Boolean

open fun isNoTimestamp(): Boolean

Returns whether to include timestamp within hidden comment in generated HTML (Groovy >= 2.4.6).

isNoVersionStamp

open fun isNoVersionStamp(): Boolean

Returns whether to include version stamp within hidden comment in generated HTML (Groovy >= 2.4.6).

open fun isUse(): Boolean

Returns whether to create class and package usage pages.

open fun link(url: String, packages: Array<String>)

Add links to groovydoc/javadoc output at the given URL.

open fun mustRunAfter(paths: Array<Any>): Task

notCompatibleWithConfigurationCache

open fun notCompatibleWithConfigurationCache(reason: String)

open fun onlyIf(spec: Spec<in Task>)

prependParallelSafeAction

open fun prependParallelSafeAction(action: Action<in Task>)

open fun property(propertyName: String): Any

open fun setActions(replacements: List<Action<in Task>>)

open fun setDependsOn(dependsOn: Iterable<out Any>)

open fun setDidWork(didWork: Boolean)

open fun setExcludes(excludes: Iterable<String>): SourceTask

abstract fun setExcludes(excludes: Iterable<String>): PatternFilterable

open fun setFinalizedBy(finalizedByTasks: Iterable<out Any>)

open fun setIncludes(includes: Iterable<String>): SourceTask

abstract fun setIncludes(includes: Iterable<String>): PatternFilterable

setMustRunAfter

open fun setMustRunAfter(mustRunAfterTasks: Iterable<out Any>)

open fun setNoTimestamp(noTimestamp: Boolean)

Sets whether to include timestamp within hidden comment in generated HTML (Groovy >= 2.4.6).

setNoVersionStamp

open fun setNoVersionStamp(noVersionStamp: Boolean)

Sets whether to include version stamp within hidden comment in generated HTML (Groovy >= 2.4.6).

open fun setOnlyIf(spec: Spec<in Task>)

setOverviewText

open fun setOverviewText(@Nullable overviewText: TextResource)

Sets a HTML text to be used for overview documentation (optional).

open fun setProperty(name: String, value: Any)

setShouldRunAfter

open fun setShouldRunAfter(shouldRunAfterTasks: Iterable<out Any>)

open fun setSource(source: FileTree)

open fun setUse(use: Boolean)

Sets whether to create class and package usage pages.

open fun shouldRunAfter(paths: Array<Any>): TaskDependency

open fun source(sources: Array<Any>): SourceTask

inline fun <T : Any> ExtensionAware.the(): T

Returns the extension of the specified type.

fun <T : Any> ExtensionAware.the(extensionType: KClass<T>): T

Returns the extension of the specified extensionType.

open fun usesService(service: Provider<out BuildService<out Any>>)