aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com/google
diff options
context:
space:
mode:
authorGravatar Greg Estren <gregce@google.com>2016-11-15 16:49:10 +0000
committerGravatar Kristina Chodorow <kchodorow@google.com>2016-11-16 15:56:18 +0000
commit132f9e0fe8993f6a898653e7778b08ac328acf39 (patch)
tree1a71e74631bfed6acdf4188b9a03f8a31022bfd1 /src/main/java/com/google
parentf69585524b589d9af4830ec5acb7d202342b72f9 (diff)
Updates outdated options documentation for
--distinct_host_configuration. -- MOS_MIGRATED_REVID=139205874
Diffstat (limited to 'src/main/java/com/google')
-rw-r--r--src/main/java/com/google/devtools/build/lib/analysis/config/BuildConfiguration.java12
1 files changed, 6 insertions, 6 deletions
diff --git a/src/main/java/com/google/devtools/build/lib/analysis/config/BuildConfiguration.java b/src/main/java/com/google/devtools/build/lib/analysis/config/BuildConfiguration.java
index 2ca328033e..9964c7f08f 100644
--- a/src/main/java/com/google/devtools/build/lib/analysis/config/BuildConfiguration.java
+++ b/src/main/java/com/google/devtools/build/lib/analysis/config/BuildConfiguration.java
@@ -768,14 +768,14 @@ public final class BuildConfiguration {
defaultValue = "true",
category = "strategy",
help = "Build all the tools used during the build for a distinct configuration from "
- + "that used for the target program. By default, the same configuration is used "
- + "for host and target programs, but this may cause undesirable rebuilds of tool "
+ + "that used for the target program. When this is disabled, the same configuration "
+ + "is used for host and target programs. This may cause undesirable rebuilds of tools "
+ "such as the protocol compiler (and then everything downstream) whenever a minor "
- + "change is made to the target configuration, such as setting the linker options. "
- + "When this flag is specified, a distinct configuration will be used to build the "
- + "tools, preventing undesired rebuilds. However, certain libraries will then "
+ + "change is made to the target configuration, such as setting the linker options. "
+ + "When this enabled (the default), a distinct configuration will be used to build the "
+ + "tools, preventing undesired rebuilds. However, certain libraries will then "
+ "need to be compiled twice, once for each configuration, which may cause some "
- + "builds to be slower. As a rule of thumb, this option is likely to benefit "
+ + "builds to be slower. As a rule of thumb, this option is likely to benefit "
+ "users that make frequent changes in configuration (e.g. opt/dbg). "
+ "Please read the user manual for the full explanation.")
public boolean useDistinctHostConfiguration;