diff options
| -rw-r--r-- | site/docs/user-manual.html | 21 |
1 files changed, 9 insertions, 12 deletions
diff --git a/site/docs/user-manual.html b/site/docs/user-manual.html index 49370b07f2..94cd3456ce 100644 --- a/site/docs/user-manual.html +++ b/site/docs/user-manual.html @@ -1774,22 +1774,18 @@ The default is <code>armeabi-v7a</code>. <h4 id='flag--javabase'><code class='flag'>--javabase (<var>label</var>)</code></h4> <p> - This option sets the <i>label</i> of the base Java installation to - use for running JavaBuilder, SingleJar, for <i>bazel run</i> and <i>bazel - test</i>, and for Java binaries built by <code>java_binary</code> and <code>java_test</code> - rules. - The various <a href='be/make-variables.html'>"Make" variables</a> for - Java (<code>JAVABASE</code>, <code>JAVA</code>, <code>JAVAC</code> and - <code>JAR</code>) are derived from this option. + This option sets the <i>label</i> of the base Java installation to use for <i>bazel run</i>, + <i>bazel test</i>, and for Java binaries built by <code>java_binary</code> and + <code>java_test</code> rules. The <code>JAVABASE</code> and <code>JAVA</code> + <a href='be/make-variables.html'>"Make" variables</a> are derived from this option. </p> <h4 id='flag--host_javabase'><code class='flag'>--host_javabase <var>label</var></code></h4> <p> - If not specified, bazel uses the value of <code class='flag'>--javabase</code> - in the host configuration, i.e., for Java-based tools that run during the build. - The main purpose of this flag is to enable cross-compilation. + This option (sometimes referred to as the 'right-hand side' <code>host_javabase</code>) + sets the <i>label</i> of the base Java installation to use in the host configuration, + for example for host build tools including JavaBuilder and Singlejar. </p> - <p> This does not select the Java compiler that is used to compile Java source files. The compiler can be selected by settings the @@ -1798,7 +1794,8 @@ The default is <code>armeabi-v7a</code>. </p> <p> This option should not be confused with the startup option - <a href='#startup_flag--host_javabase'>--host_javabase</a>. + <a href='#startup_flag--host_javabase'>--host_javabase</a> + (sometimes known as the 'left-hand side' <code>host_javabase</code>). </p> <h3 id='strategy-options'>Build strategy options</h3> |