Fork me on GitHub

gplus:groovydocTests

Full name:

org.codehaus.gmavenplus:gmavenplus-plugin:3.0.2:groovydocTests

Description:

Generates GroovyDoc for the test sources.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • The goal is thread-safe and supports parallel builds.
  • Since version: 1.0-beta-1.

Optional Parameters

Name Type Since Description
<attachGroovyDocAnnotation> boolean 1.11.0 Enable attaching GroovyDoc annotation. Requires Groovy 3.0.0 alpha-4 or newer.
Default: false
<classpathResourceManagerClass> String 1.10.1 Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ClasspathResourceManager, for use when creating custom GroovyDoc implementations.
<defaultClassTemplates> String[] 1.10.1 Override the default Groovydoc class-level templates. Uses Groovy's standard templates by default.
<defaultDocTemplates> String[] 1.10.1 Override the default Groovydoc default top-level templates. Uses Groovy's standard templates by default.
<defaultPackageTemplates> String[] 1.10.1 Override the default Groovydoc package-level templates. Uses Groovy's standard templates by default.
<displayAuthor> boolean - Whether to display the author in the generated GroovyDoc.
Default: true
<docTitle> String - The page title.
Default: Groovy Documentation
<fileOutputToolClass> String 1.10.1 Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.FileOutputTool, for use when creating custom GroovyDoc implementations.
<footer> String - The page footer.
Default: Groovy Documentation
<groovyDocToolClass> String 1.10.1 Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.GroovyDocTool, for use when creating custom GroovyDoc implementations.
<header> String - The page header.
Default: Groovy Documentation
<includeClasspath> IncludeClasspath 1.8.0 What classpath to include. One of
  • PROJECT_ONLY
  • PROJECT_AND_PLUGIN
  • PLUGIN_ONLY
Uses the same scope as the required dependency resolution of this mojo. Use only if you know what you're doing.
Default: PROJECT_ONLY
<linkArgumentClass> String 1.10.1 Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.LinkArgument (or org.codehaus.groovy.ant.Groovydoc$LinkArgument for Groovy older than 1.6-RC-2), for use when creating custom GroovyDoc implementations.
<links> List<Link> 1.0-beta-2 Links to include in the generated GroovyDoc (key is link href, value is comma-separated packages to use that link).
<outputToolClass> String 1.10.1 Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.OutputTool, for use when creating custom GroovyDoc implementations.
<overviewFile> File - The HTML file to be used for overview documentation.
<resourceManagerClass> String 1.10.1 Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ResourceManager, for use when creating custom GroovyDoc implementations.
<scope> String - The scope to generate GroovyDoc for. Should be one of:
  • "public"
  • "protected"
  • "package"
  • "private"

Default: private
<skipGroovyDoc> boolean 1.6 Flag to allow GroovyDoc generation to be skipped.
Default: false
User Property: skipGroovydoc
<stylesheetEncoding> String - The encoding of stylesheetFile.
Default: ${project.build.sourceEncoding}
<stylesheetFile> File - The stylesheet file (absolute path) to copy to output directory (will overwrite default stylesheet.css).
<testGroovyDocJavaSources> boolean 1.7 Whether to include test Java sources in GroovyDoc generation.
Default: true
<testGroovyDocOutputDirectory> File - The location for the generated test API docs.
Default: ${project.build.directory}/testgapidocs
<testSources> FileSet[] - The Groovy test source files (relative paths). Default: "${project.basedir}/src/test/groovy/**/*.groovy"
<windowTitle> String - The window title.
Default: Groovy Documentation

Parameter Details

<attachGroovyDocAnnotation>

Enable attaching GroovyDoc annotation. Requires Groovy 3.0.0 alpha-4 or newer.
  • Type: boolean
  • Since: 1.11.0
  • Required: report.plugin.goal.no
  • Default: false

<classpathResourceManagerClass>

Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ClasspathResourceManager, for use when creating custom GroovyDoc implementations.
  • Type: java.lang.String
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<defaultClassTemplates>

Override the default Groovydoc class-level templates. Uses Groovy's standard templates by default.
  • Type: java.lang.String[]
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<defaultDocTemplates>

Override the default Groovydoc default top-level templates. Uses Groovy's standard templates by default.
  • Type: java.lang.String[]
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<defaultPackageTemplates>

Override the default Groovydoc package-level templates. Uses Groovy's standard templates by default.
  • Type: java.lang.String[]
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<displayAuthor>

Whether to display the author in the generated GroovyDoc.
  • Type: boolean
  • Required: report.plugin.goal.no
  • Default: true

<docTitle>

The page title.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: Groovy Documentation

<fileOutputToolClass>

Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.FileOutputTool, for use when creating custom GroovyDoc implementations.
  • Type: java.lang.String
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<footer>

The page footer.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: Groovy Documentation

<groovyDocToolClass>

Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.GroovyDocTool, for use when creating custom GroovyDoc implementations.
  • Type: java.lang.String
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<header>

The page header.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: Groovy Documentation

<includeClasspath>

What classpath to include. One of
  • PROJECT_ONLY
  • PROJECT_AND_PLUGIN
  • PLUGIN_ONLY
Uses the same scope as the required dependency resolution of this mojo. Use only if you know what you're doing.
  • Type: org.codehaus.gmavenplus.model.IncludeClasspath
  • Since: 1.8.0
  • Required: report.plugin.goal.no
  • Default: PROJECT_ONLY

<linkArgumentClass>

Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.LinkArgument (or org.codehaus.groovy.ant.Groovydoc$LinkArgument for Groovy older than 1.6-RC-2), for use when creating custom GroovyDoc implementations.
  • Type: java.lang.String
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<links>

Links to include in the generated GroovyDoc (key is link href, value is comma-separated packages to use that link).
  • Type: java.util.List<org.codehaus.gmavenplus.model.Link>
  • Since: 1.0-beta-2
  • Required: report.plugin.goal.no

<outputToolClass>

Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.OutputTool, for use when creating custom GroovyDoc implementations.
  • Type: java.lang.String
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<overviewFile>

The HTML file to be used for overview documentation.
  • Type: java.io.File
  • Required: report.plugin.goal.no

<resourceManagerClass>

Allows you to override the class that is normally org.codehaus.groovy.tools.groovydoc.ResourceManager, for use when creating custom GroovyDoc implementations.
  • Type: java.lang.String
  • Since: 1.10.1
  • Required: report.plugin.goal.no

<scope>

The scope to generate GroovyDoc for. Should be one of:
  • "public"
  • "protected"
  • "package"
  • "private"
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: private

<skipGroovyDoc>

Flag to allow GroovyDoc generation to be skipped.
  • Type: boolean
  • Since: 1.6
  • Required: report.plugin.goal.no
  • User Property: skipGroovydoc
  • Default: false

<stylesheetEncoding>

The encoding of stylesheetFile.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: ${project.build.sourceEncoding}

<stylesheetFile>

The stylesheet file (absolute path) to copy to output directory (will overwrite default stylesheet.css).
  • Type: java.io.File
  • Required: report.plugin.goal.no

<testGroovyDocJavaSources>

Whether to include test Java sources in GroovyDoc generation.
  • Type: boolean
  • Since: 1.7
  • Required: report.plugin.goal.no
  • Default: true

<testGroovyDocOutputDirectory>

The location for the generated test API docs.
  • Type: java.io.File
  • Required: report.plugin.goal.no
  • Default: ${project.build.directory}/testgapidocs

<testSources>

The Groovy test source files (relative paths). Default: "${project.basedir}/src/test/groovy/**/*.groovy"
  • Type: org.apache.maven.shared.model.fileset.FileSet[]
  • Required: report.plugin.goal.no

<windowTitle>

The window title.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: Groovy Documentation