Deprecated.
Replaced by ordinary dependencies with <type> element set to proc, classpath-proc or modular-proc.

Classpath elements to supply as annotation processor path. If specified, the compiler will detect annotation processors only in those classpath elements. If omitted, the default classpath is used to detect annotation processors. The detection itself depends on the configuration of annotationProcessors.

Each classpath element is specified using their Maven coordinates (groupId, artifactId, version, classifier, type). Transitive dependencies are added automatically. Exclusions are supported as well. Example:

<configuration>
  <annotationProcessorPaths>
    <path>
      <groupId>org.sample</groupId>
      <artifactId>sample-annotation-processor</artifactId>
      <version>1.2.3</version> <!-- Optional - taken from dependency management if not specified -->
      <!-- Optionally exclude transitive dependencies -->
      <exclusions>
        <exclusion>
          <groupId>org.sample</groupId>
          <artifactId>sample-dependency</artifactId>
        </exclusion>
      </exclusions>
    </path>
    <!-- ... more ... -->
  </annotationProcessorPaths>
</configuration>

Note: Exclusions are supported from version 3.11.0.
See also: javac -processorpath, javac Annotation Processing

Whether to use the Maven dependency management section when resolving transitive dependencies of annotation processor paths.

This flag does not enable / disable the ability to resolve the version of annotation processor paths from dependency management section. It only influences the resolution of transitive dependencies of those top-level paths.

Class names of annotation processors to run. If not set, the default annotation processors discovery process applies. If set, the value will be appended to the -processor compiler option.
See also: proc

The source directories containing the sources to be compiled. If null or empty, the directory will be obtained from the project manager.

Additional arguments to be passed verbatim to the Java compiler. This parameter can be used when the Maven compiler plugin does not provide a parameter for a Java compiler option. It may happen, for example, for new or preview Java features which are not yet handled by this compiler plugin.

If an option has a value, the option and the value shall be specified in two separated <arg> elements. For example, the -Xmaxerrs 1000 option (for setting the maximal number of errors to 1000) can be specified as below (together with other options):

<compilerArgs>
  <arg>-Xlint</arg>
  <arg>-Xmaxerrs</arg>
  <arg>1000</arg>
  <arg>J-Duser.language=en_us</arg>
</compilerArgs>

Note that -J options should be specified only if fork is set to true. Other options can be specified regardless the fork value. The compiler plugin does not verify whether the arguments given through this parameter are valid. For this reason, the other parameters provided by the compiler plugin should be preferred when they exist, because the plugin checks whether the corresponding options are supported.
See also: javac -J

Deprecated.
Use compilerArgs instead.

The single argument string to be passed to the compiler. To pass multiple arguments such as -Xmaxerrs 1000 (which are actually two arguments), compilerArgs is preferred.

Note that -J options should be specified only if fork is set to true.

See also: javac -J

Identifier of the compiler to use. This identifier shall match the identifier of a compiler known to the JDK tool chain, or the JavaCompiler#name() name of a javax.tools.JavaCompiler instance registered as a service findable by java.util.ServiceLoader. See this guide for more information. If unspecified, then the system Java compiler is used. The identifier of the system Java compiler is usually javac.
See also: fork, executable, JavaCompiler#name()

Deprecated.
Not supported anymore. The reuse of javax.tools.JavaFileManager instance is plugin implementation details.

Strategy to re use javacc class created. Legal values are:

• reuseCreated (default) – will reuse already created but in case of multi-threaded builds, each thread will have its own instance.
• reuseSame – the same Javacc class will be used for each compilation even for multi-threaded build.
• alwaysNew – a new Javacc class will be created for each compilation.

Note this parameter value depends on the OS/JDK you are using, but the default value should work on most of env.

Deprecated.
This parameter is no longer used by the underlying compilers.

Version of the compiler to use if fork is set to true. Examples! "1.3", "1.5".
See also: fork

Whether to generate package-info.class even when empty. By default, package info source files that only contain javadoc and no annotation on the package can lead to no class file being generated by the compiler. It may cause a file miss on build systems that check for file existence in order to decide what to recompile.

If true, the -Xpkginfo:always compiler option is added if the compiler supports that extra option. If the extra option is not supported, then a warning is logged and no option is added to the compiler arguments.

See also: incrementalCompilation

Whether to include debugging information in the compiled class files. The amount of debugging information to include is specified by the debuglevel parameter. If this debug flag is true, then the -g option may be added to compiler arguments with a value determined by the debuglevel argument. If this debug flag is false, then the -g:none option will be added to the compiler arguments.
See also: debuglevel, javac -g

The file where to dump the command-line when debug is activated or when the compilation failed. For example, if the value is "javac", then the Java compiler can be launched from the command-line by typing javac @target/javac.args. The debug file will contain the compiler options together with the list of source files to compile.

Keyword list to be appended to the -g command-line switch. Legal values are a comma-separated list of the following keywords: lines, vars, source and all. If debug level is not specified, then the -g option will not by added, which means that the default debugging information will be generated (typically lines and source but not vars). If debug is turned off, this attribute will be ignored.
See also: debug, javac -G:[lines,vars,source]

Whether to enable preview language features of the java compiler. If true, then the --enable-preview option will be added to compiler arguments.
See also: javac --enable-preview

The -encoding argument for the Java compiler.
See also: javac -encoding

A set of exclusion filters for the compiler.

Executable of the compiler to use when fork is true. If this parameter is specified, then the jdkToolchain is ignored.
See also: jdkToolchain, fork, compilerId

Whether the build will stop if there are compilation errors.
See also: failOnWarning

Whether the build will stop if there are compilation warnings. If true, then the -Werror option will be added to compiler arguments.
See also: showWarnings, showDeprecation

File extensions to check timestamp for incremental build. Default contains only class and jar. TODO: Rename with a name making clearer that this parameter is about incremental build.
See also: incrementalCompilation

Deprecated.
Ignored because java.lang.Compiler has been deprecated and removed from the JDK.

Whether to use legacy compiler API.

Deprecated.
Ignored because the compiler plugin now always use the javax.tools API.

Whether to use the legacy com.sun.tools.javac API instead of javax.tools API.
See also: New API, Legacy API

Allows running the compiler in a separate process. If false, the plugin uses the built-in compiler, while if true it will use an executable.
See also: executable, compilerId, meminitial, maxmem

Specify where to place generated source files created by annotation processing.

Whether to generate class files for implicitly referenced files. If set, the value will be appended to the -implicit: compiler option. Standard values are:

• class – automatically generates class files.
• none – suppresses class file generation.

See also: javac -implicit

A set of inclusion filters for the compiler.

The algorithm to use for selecting which files to compile. Values can be dependencies, sources, classes, additions, modules or none.

options: recompile all source files if the compiler options changed. Changes are detected on a best-effort basis only.

dependencies: recompile all source files if at least one dependency (JAR file) changed since the last build. This check is based on the last modification times of JAR files.

sources: recompile source files modified since the last build. In addition, if a source file has been deleted, then all source files are recompiled. This check is based on the modification times of source files rather than the modification times of the *.class files.

classes: recompile source files (*.java) associated to no output file (*.class) or associated to an output file older than the source. This algorithm does not check if a source file has been removed, potentially leaving non-recompiled classes with references to classes that no longer exist.

The sources and classes values are partially redundant, doing the same work in different ways. It is usually not necessary to specify those two values.

additions: recompile all source files when the addition of a new file is detected. This aspect should be used together with sources or classes. When used with classes, it provides a way to detect class renaming (this is not needed with sources).

modules: recompile modules and let the compiler decides which individual files to recompile. The compiler plugin does not enumerate the source files to recompile (actually, it does not scan at all the source directories). Instead, it only specifies the module to recompile using the --module option. The Java compiler will scan the source directories itself and compile only those source files that are newer than the corresponding files in the output directory.

none: the compiler plugin unconditionally specifies all sources to the Java compiler. This option is mutually exclusive with all other incremental compilation options.

Limitations

In all cases, the current compiler-plugin does not detect structural changes other than file addition or removal. For example, the plugin does not detect whether a method has been removed in a class.
See also: staleMillis, fileExtensions, showCompilationChanges, createMissingPackageInfoClass

A set of exclusion filters for the incremental calculation. Updated source files, if excluded by this filter, will not cause the project to be rebuilt.

Limitation

In the current implementation, those exclusion filters are applied for added or removed files, but not yet for removed files.

Requirements for this JDK toolchain for using a different javac than the one of the JDK used by Maven. This overrules the toolchain selected by the maven-toolchain-plugin. See Guide to Toolchains for more info.

<configuration>
  <jdkToolchain>
    <version>11</version>
  </jdkToolchain>
  ...
</configuration>

<configuration>
  <jdkToolchain>
    <version>1.8</version>
    <vendor>zulu</vendor>
  </jdkToolchain>
  ...
</configuration>

See also: fork, executable

Maximum size, in megabytes, of the memory allocation pool if fork is set to true. Examples: "128", "128M". Suffixes "k" (for kilobytes) and "G" (for gigabytes) are also accepted. If no suffix is provided, "M" is assumed.
See also: fork

Initial size, in megabytes, of the memory allocation pool if fork is set to true. Examples: "64", "64M". Suffixes "k" (for kilobytes) and "G" (for gigabytes) are also accepted. If no suffix is provided, "M" is assumed.
See also: fork

The --module-version argument for the Java compiler. This is ignored if not applicable, e.g., in non-modular projects.
See also: javac --module-version

Deprecated.
Replaced by specifying the release version together with the source directory.

When set to true, the classes will be placed in META-INF/versions/${release}.

Note: A jar is only a multi-release jar if META-INF/MANIFEST.MF contains Multi-Release: true. You need to set this by configuring the maven-jar-plugin. This implies that you cannot test a multi-release jar using the outputDirectory.

Deprecated.
This property is ignored.

Whether to optimize the compiled code using the compiler's optimization methods.

Deprecated.
Bundling many class files into a single file should be done by other plugins.

Sets the name of the output file when compiling a set of sources to a single file.

expression="${project.build.finalName}"

Deprecated.
Not used by the compiler plugin since it does not generate archive.

Timestamp for reproducible output archive entries. It can be either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH).

Whether to generate metadata for reflection on method parameters. If true, the -parameters option will be added to compiler arguments.
See also: javac -parameters

Whether annotation processing is performed or not. If not set, both compilation and annotation processing are performed at the same time. If set, the value will be appended to the -proc: compiler option. Standard values are:

• none – no annotation processing is performed.
• only – only annotation processing is done, no compilation.
• full – annotation processing and compilation are done.

Prior Java 21, full was the default. Starting with JDK 21, this option must be set explicitly.
See also: annotationProcessors, javac -proc, javac Annotation Processing

The --release argument for the Java compiler. If omitted, then the compiler will generate bytecodes for the Java version running the compiler.
See also: javac --release

Whether to provide more details about why a module is rebuilt. This is used only if incrementalCompilation is "inputTreeChanges".
See also: incrementalCompilation

Whether to show source locations where deprecated APIs are used. If true, then the -deprecation option will be added to compiler arguments. That option is itself a shorthand for -Xlint:deprecation.
See also: showWarnings, failOnWarning

Whether to show compilation warnings. If false, then the -nowarn option will be added to compiler arguments. That option is itself a shorthand for -Xlint:none.
See also: showDeprecation, failOnWarning

Set this to true to bypass compilation of main sources. Its use is not recommended, but quite convenient on occasion.

Deprecated.
Deprecated as a consequence of compilerReuseStrategy deprecation.

No description.

The --source argument for the Java compiler.

Notes:

• Since 3.8.0 the default value has changed from 1.5 to 1.6.
• Since 3.9.0 the default value has changed from 1.6 to 1.7.
• Since 3.11.0 the default value has changed from 1.7 to 1.8.
• Since 4.0.0-beta-2 the default value has been removed. As of Java 9, the release parameter is preferred.

See also: javac --source

The granularity in milliseconds of the last modification date for testing whether a source needs recompilation.
See also: incrementalCompilation

The --target argument for the Java compiler.

Notes:

• Since 3.8.0 the default value has changed from 1.5 to 1.6.
• Since 3.9.0 the default value has changed from 1.6 to 1.7.
• Since 3.11.0 the default value has changed from 1.7 to 1.8.
• Since 4.0.0-beta-2 the default value has been removed. As of Java 9, the release parameter is preferred.

See also: javac --target

Deprecated.
Replaced by incrementalCompilation. A value of true in this old property is equivalent to "dependencies,sources,additions" in the new property, and a value of false is equivalent to "classes".

Whether to enable/disable incremental compilation feature.

Whether to show messages about what the compiler is doing. If true, then the -verbose option will be added to compiler arguments.
See also: javac -verbose