maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Michael Boyles (Jira)" <>
Subject [jira] [Commented] (MCOMPILER-428) Documentation regarding useIncrementalCompilation not very useful
Date Tue, 15 Sep 2020 13:05:00 GMT


Michael Boyles commented on MCOMPILER-428:

I suspect your description may be inaccurate. As per the comments on that ticket by Robert:
"if 1 file has been changed or removed, all files are deleted and recompiled"

As per your description: "any source file was **added**, removed or changed".

I don't know whether this optimization actually exists, but it seems plausible: If the only
change is purely adding a class or classes, and no other existing classes changed, we can
infer that the whole module does not need recompiling.

Suppose we add a new Spring @Component. It would be sufficient to just compile this new class,
and Spring's DI will pick it up at runtime. Recompiling everything else when we know they
haven't changed would be a waste of time.

> Documentation regarding useIncrementalCompilation not very useful
> -----------------------------------------------------------------
>                 Key: MCOMPILER-428
>                 URL:
>             Project: Maven Compiler Plugin
>          Issue Type: Improvement
>            Reporter: Thomas Bracher
>            Priority: Minor
>              Labels: documentation
> As of today, maven-compiler-plugin documentation for useIncrementalCompilation says:
"to enable/disable incrementation compilation feature". Since there is no documentation of
said feature, users will have to either:
> 1) take a guess at how the feature behaves
> 2) painfully read the plugin code to understand what it does
> This is less than optimal and lead to misunderstanding, like this comment

> So far the most explicit documentation I have found is in answer of a stackoverflow issue:
> I think it would benefit a lot of users to understand the implication of both options
of this flag. I am trying to submit a PR providing an example of text.

This message was sent by Atlassian Jira

View raw message