Fork me on GitHub

gplus:groovydoc-jar

Full name:

org.codehaus.gmavenplus:gmavenplus-plugin:3.0.2:groovydoc-jar

Description:

Create a GroovyDoc jar for the main sources. Note by default this will also invoke the groovydoc goal (unless invokeGroovyDoc is false).

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • The goal is thread-safe and supports parallel builds.
  • Since version: 1.7.1.
  • Binds by default to the lifecycle phase: package.

Optional Parameters

Name Type Since Description
<archive> MavenArchiveConfiguration - The archive configuration to use. See Maven Archiver Reference.
<artifactType> String 1.10.0 The artifact type for the GroovyDoc jar.
Default: javadoc
<attach> boolean - Specifies whether to attach the generated artifact to the project helper.
Default: true
User Property: attach
<attachGroovyDocAnnotation> boolean 1.11.0 Enable attaching GroovyDoc annotation. Requires Groovy 3.0.0 alpha-4 or newer.
Default: false
<classifier> String - The classifier for the GroovyDoc jar.
Default: groovydoc
<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.
<finalName> String - Specifies the filename that will be used for the generated jar file. Please note that -groovydoc will be appended to the file name.
User Property: project.build.finalName
<footer> String - The page footer.
Default: Groovy Documentation
<groovyDocJavaSources> boolean 1.0-beta-2 Whether to include Java sources in GroovyDoc generation.
Default: true
<groovyDocOutputDirectory> File - The location for the generated API docs.
Default: ${project.build.directory}/gapidocs
<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
<invokeGroovyDoc> boolean - Whether to invoke the groovydoc goal before creating jar.
Default: true
<jarOutputDirectory> String - Specifies the directory where the generated jar file will be put.
User Property: project.build.directory
<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
<sources> FileSet[] - The Groovy source files (relative paths). Default: "${project.basedir}/src/main/groovy/**/*.groovy"
<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).
<useDefaultManifestFile> boolean - Set this to true to enable the use of the defaultManifestFile.
Default: false
<windowTitle> String - The window title.
Default: Groovy Documentation

Parameter Details

<archive>

The archive configuration to use. See Maven Archiver Reference.
  • Type: org.apache.maven.archiver.MavenArchiveConfiguration
  • Required: report.plugin.goal.no

<artifactType>

The artifact type for the GroovyDoc jar.
  • Type: java.lang.String
  • Since: 1.10.0
  • Required: report.plugin.goal.no
  • Default: javadoc

<attach>

Specifies whether to attach the generated artifact to the project helper.
  • Type: boolean
  • Required: report.plugin.goal.no
  • User Property: attach
  • Default: true

<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

<classifier>

The classifier for the GroovyDoc jar.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • Default: groovydoc

<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

<finalName>

Specifies the filename that will be used for the generated jar file. Please note that -groovydoc will be appended to the file name.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • User Property: project.build.finalName

<footer>

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

<groovyDocJavaSources>

Whether to include Java sources in GroovyDoc generation.
  • Type: boolean
  • Since: 1.0-beta-2
  • Required: report.plugin.goal.no
  • Default: true

<groovyDocOutputDirectory>

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

<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

<invokeGroovyDoc>

Whether to invoke the groovydoc goal before creating jar.
  • Type: boolean
  • Required: report.plugin.goal.no
  • Default: true

<jarOutputDirectory>

Specifies the directory where the generated jar file will be put.
  • Type: java.lang.String
  • Required: report.plugin.goal.no
  • User Property: project.build.directory

<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

<sources>

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

<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

<useDefaultManifestFile>

Set this to true to enable the use of the defaultManifestFile.
  • Type: boolean
  • Required: report.plugin.goal.no
  • Default: false

<windowTitle>

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