Skip to content

Deprecate the debug flag #953

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Deprecate the debug flag #953

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cabf2cc
Deprecate the `debug` flag.
desruisseaux Jul 16, 2025
7a4afbc
Update the documentation of `debugLevel`.
desruisseaux Jul 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 15 additions & 8 deletions src/main/java/org/apache/maven/plugin/compiler/AbstractCompilerMojo.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -432,21 +432,28 @@ final Charset charset() {
*
* @see #debuglevel
* @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-g">javac -g</a>
*
* @deprecated Setting this flag to {@code false} is replaced by {@code <debuglevel>none</debuglevel>}.
*/
@Deprecated(since = "4.0.0")
@Parameter(property = "maven.compiler.debug", defaultValue = "true")
protected boolean debug = true;

/**
* Keyword list to be appended to the {@code -g} command-line switch.
* Legal values are a comma-separated list of the following keywords:
* {@code lines}, {@code vars}, {@code source} and {@code all}.
* If debug level is not specified, then the {@code -g} option will <em>not</em> by added,
* Kinds of debugging information to include in the compiled class files.
* Legal values are {@code lines}, {@code vars}, {@code source}, {@code all} and {@code none}.
* Values other than {@code all} and {@code none} can be combined in a comma-separated list.
*
* <p>If debug level is not specified, then the {@code -g} option will <em>not</em> be added,
* which means that the default debugging information will be generated
* (typically {@code lines} and {@code source} but not {@code vars}).
* If {@link #debug} is turned off, this attribute will be ignored.
* (typically {@code lines} and {@code source} but not {@code vars}).</p>
*
* <p>If debug level is {@code all}, then only the {@code -g} option is added,
* which means that all debugging information will be generated.
* If debug level is anything else, then the comma-separated list of keywords
* is appended to the {@code -g} command-line switch.</p>
*
* @see #debug
* @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-g-custom">javac -G:[lines,vars,source]</a>
* @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-g-custom">javac -g:[lines,vars,source]</a>
* @since 2.1
*/
@Parameter(property = "maven.compiler.debuglevel")
Expand Down
Loading