javafxdoc:jar

Full name:

net.sf.jfxdplugin:maven-javafxdoc-plugin:1.0:jar

Description:

Bundles the Javafxdoc documentation for the JavaFX code in a NON aggregator project into a jar using the standard Javafxdoc tool.

Based on the Maven Javadoc Plugin version 2.6.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • Since version: 1.0.
  • Binds by default to the lifecycle phase: package.

Optional Parameters

Name Type Since Description
additionalJOptions String[] 1.0 Passes the specified flag directly to the runtime system. Example: 
<additionalJOptions>
<additionalJOption>-Xss128m</additionalJOption>
</additionalJOptions>

additionalXslOptions String[] 1.0 Passes the specified xsl parameter to the xsl transformer. Example: 
<additionalXslOptions>
<additionalXslOption>extra-js=xtra.js</additionalXslOption>
</additionalXslOptions>

archive MavenArchiveConfiguration 1.0 The archive configuration to use.
bootclasspath String 1.0 Specifies the paths where the boot classes reside. The paths are separated with a colon (:) on Solaris and a semi-colon (;) on Windows.
breakiterator boolean 1.0 Uses the sentence break iterator to determine the end of the first sentence.
Default value is: false.
debug boolean 1.0 Set this to 'true' to debug the Javafxdoc plugin. With this, the execution script and 'files' files are provided.

Default value is: false.
doclet String 1.0 Specifies the class file that starts the doclet used in generating the documentation.
docletPath String 1.0 Specifies the path to the doclet starting class file (specified with the -doclet option) and any jar files it depends on.
encoding String 1.0 Specifies the encoding name of the source files. If not specificed, the encoding value will be the value of the project.build.sourceEncoding property.
Default value is: ${project.build.sourceEncoding}.
excludePackageNames String 1.0 Unconditionally excludes the specified packages and their subpackages. Multiple packages can be separated by colons (:).
extdirs String 1.0 Specifies the directories where extension classes reside. Separate directories in dirlist with a colon (:) on Solaris and a semi-colon (;) on Windows.
extracss String 1.0 Specifies an additional CSS file for the HTML output.
extrajs String 1.0 Specifies an additional JavaScript file for the HTML output.
failOnError boolean 1.0 Specifies whether the build will continue even if there are errors.
Default value is: false.
finalName String 1.0 Specifies the filename that will be used for the generated jar file. Please note that -javafxdoc or -test-javafxdoc will be appended to the file name.
inputFiles File[] 1.0 Specifies additional XML input files that contain package/class information to be transformed into the HTML output.
jarOutputDirectory String 1.0 Specifies the output directory for the generated jar file.
javafxdocExecutable String 1.0 Sets the absolute path of the Javafxdoc Tool executable to use. A mere directory specification is sufficient to have the plugin use "javafxdoc" or "javafxdoc.exe" respectively from this directory.
locale String 1.0 Specifies the locale that javafxdoc uses when generating documentation.
mastercss String 1.0 Specifies the master CSS file for the HTML output.
nohtml boolean 1.0 Prevents generating the HTML files for the documentation.
Default value is: false.
outputDirectory File 1.0 Specifies the destination directory where javafxdoc saves the generated HTML files.
Default value is: ${project.build.directory}/apidocs.
outputFile File 1.0 Specifies the XML output file.
profile String 1.0 Specifies the JavaFX platform. Valid values are "desktop" (default), "mobile", or "tv" (as of JavaFX 1.3).
Default value is: desktop.
quiet boolean 1.0 Shuts off status messages. Maybe.
Default value is: false.
show String 1.0 Specifies the access level for classes and members to show in the JavaFXDocs. Possible values are
  • public (Show only public classes and members)
  • protected (Show protected/public classes and members (default))
  • package (Show package/protected/public classes and members)
  • private (Show all classes and members)


Default value is: protected.
source String 1.0 Provides source compatability with the specified release.
sourcePath String 1.0 Specifies the source paths where the subpackages are located. The paths are separated with a colon (:) on Solaris and a semi-colon (;) on Windows.
subpackages String 1.0 Generates documentation from source files in the specified packages and recursively in their subpackages.
useDefaultManifestFile boolean 1.0 Set this to true to enable the use of the defaultManifestFile.
Default value is: false.
verbose boolean 1.0 Provides more detailed messages while Javafxdoc is running.
Default value is: false.
xsltfile File 1.0 Specifies the XSL file to use for transforming the documentation.

Parameter Details

additionalJOptions:

Passes the specified flag directly to the runtime system. Example: 
<additionalJOptions>
<additionalJOption>-Xss128m</additionalJOption>
</additionalJOptions>
  • Type: java.lang.String[]
  • Since: 1.0
  • Required: No

additionalXslOptions:

Passes the specified xsl parameter to the xsl transformer. Example: 
<additionalXslOptions>
<additionalXslOption>extra-js=xtra.js</additionalXslOption>
</additionalXslOptions>
  • Type: java.lang.String[]
  • Since: 1.0
  • Required: No

archive:

The archive configuration to use.
  • Type: org.apache.maven.archiver.MavenArchiveConfiguration
  • Since: 1.0
  • Required: No

bootclasspath:

Specifies the paths where the boot classes reside. The paths are separated with a colon (:) on Solaris and a semi-colon (;) on Windows.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${bootclasspath}

breakiterator:

Uses the sentence break iterator to determine the end of the first sentence.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${breakiterator}
  • Default: false

debug:

Set this to 'true' to debug the Javafxdoc plugin. With this, the execution script and 'files' files are provided.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${debug}
  • Default: false

doclet:

Specifies the class file that starts the doclet used in generating the documentation.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${doclet}

docletPath:

Specifies the path to the doclet starting class file (specified with the -doclet option) and any jar files it depends on.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${docletPath}

encoding:

Specifies the encoding name of the source files. If not specificed, the encoding value will be the value of the project.build.sourceEncoding property.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${encoding}
  • Default: ${project.build.sourceEncoding}

excludePackageNames:

Unconditionally excludes the specified packages and their subpackages. Multiple packages can be separated by colons (:).
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${excludePackageNames}

extdirs:

Specifies the directories where extension classes reside. Separate directories in dirlist with a colon (:) on Solaris and a semi-colon (;) on Windows.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${extdirs}

extracss:

Specifies an additional CSS file for the HTML output.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${extracss}

extrajs:

Specifies an additional JavaScript file for the HTML output.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${extrajs}

failOnError:

Specifies whether the build will continue even if there are errors.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${failOnError}
  • Default: false

finalName:

Specifies the filename that will be used for the generated jar file. Please note that -javafxdoc or -test-javafxdoc will be appended to the file name.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${project.build.finalName}

inputFiles:

Specifies additional XML input files that contain package/class information to be transformed into the HTML output.
  • Type: java.io.File[]
  • Since: 1.0
  • Required: No

jarOutputDirectory:

Specifies the output directory for the generated jar file.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${project.build.directory}

javafxdocExecutable:

Sets the absolute path of the Javafxdoc Tool executable to use. A mere directory specification is sufficient to have the plugin use "javafxdoc" or "javafxdoc.exe" respectively from this directory.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${javafxdocExecutable}

locale:

Specifies the locale that javafxdoc uses when generating documentation.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${locale}

mastercss:

Specifies the master CSS file for the HTML output.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${mastercss}

nohtml:

Prevents generating the HTML files for the documentation.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${nohtml}
  • Default: false

outputDirectory:

Specifies the destination directory where javafxdoc saves the generated HTML files.
  • Type: java.io.File
  • Since: 1.0
  • Required: No
  • Expression: ${outputDirectory}
  • Default: ${project.build.directory}/apidocs

outputFile:

Specifies the XML output file.
  • Type: java.io.File
  • Since: 1.0
  • Required: No
  • Expression: ${outputFile}

profile:

Specifies the JavaFX platform. Valid values are "desktop" (default), "mobile", or "tv" (as of JavaFX 1.3).
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${profile}
  • Default: desktop

quiet:

Shuts off status messages. Maybe.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${quiet}
  • Default: false

show:

Specifies the access level for classes and members to show in the JavaFXDocs. Possible values are
  • public (Show only public classes and members)
  • protected (Show protected/public classes and members (default))
  • package (Show package/protected/public classes and members)
  • private (Show all classes and members)

  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${show}
  • Default: protected

source:

Provides source compatability with the specified release.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${source}

sourcePath:

Specifies the source paths where the subpackages are located. The paths are separated with a colon (:) on Solaris and a semi-colon (;) on Windows.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${sourcePath}

subpackages:

Generates documentation from source files in the specified packages and recursively in their subpackages.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${subpackages}

useDefaultManifestFile:

Set this to true to enable the use of the defaultManifestFile.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Default: false

verbose:

Provides more detailed messages while Javafxdoc is running.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${verbose}
  • Default: false

xsltfile:

Specifies the XSL file to use for transforming the documentation.
  • Type: java.io.File
  • Since: 1.0
  • Required: No
  • Expression: ${xsltfile}