More accurately document buildInfo's effect on up-to-date checking

Closes gh-13152
This commit is contained in:
Andy Wilkinson 2018-06-04 16:39:06 +01:00
parent 9e871816d6
commit d54072e0a8

View File

@ -51,11 +51,11 @@ include::../gradle/integrating-with-actuator/build-info-custom-values.gradle[tag
----
The default value for `build.time` is the instant at which the project is being built. A
side-effect of this is that the task will never be up-to-date and, therefore, builds will
take slightly longer as more tasks will have to be executed. Another side-effect is that
the task's output will always change and, therefore, the build will not be truly
repeatable. If you value build performance or repeatability more highly than the accuracy
of the `build.time` property, set `time` to `null` or a fixed value.
side-effect of this is that the task will never be up-to-date. As a result, builds will
take longer as more tasks, including the project's tests, will have to be executed.
Another side-effect is that the task's output will always change and, therefore, the build
will not be truly repeatable. If you value build performance or repeatability more highly
than the accuracy of the `build.time` property, set `time` to `null` or a fixed value.
Additional properties can also be added to the build information: