Add a --server_javabase startup option as an alias for the LHS --host_javabase
to avoid confusion between the LHS and RHS host_javabases.
The LHS --host_javabase option should be considered deprecated and will
eventually be removed.
RELNOTES: Rename the startup flag --host_javabase to --server_javabase to avoid confusion with the build flag --host_javabase
PiperOrigin-RevId: 206015757
diff --git a/site/docs/user-manual.html b/site/docs/user-manual.html
index 8badefd..de4363c 100644
--- a/site/docs/user-manual.html
+++ b/site/docs/user-manual.html
@@ -1777,8 +1777,7 @@
<h4 id='flag--host_javabase'><code class='flag'>--host_javabase <var>label</var></code></h4>
<p>
- 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,
+ This option 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>
@@ -1787,11 +1786,6 @@
<a href="#flag--java_toolchain"><code class='flag'>--java_toolchain</code></a>
option.
</p>
-<p>
- This option should not be confused with the startup option
- <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>
<p>
@@ -3577,21 +3571,28 @@
base) if there is a better location in your filesystem layout.
</p>
-<h4 id='startup_flag--host_javabase'><code class='flag'>--host_javabase=<var>dir</var></code></h4>
+<a name="startup_flag--host_javabase"></a>
+<h4 id='startup_flag--server_javabase'><code class='flag'>--server_javabase=<var>dir</var></code></h4>
<p>
Specifies the Java virtual machine in which <i>Bazel itself</i> runs. The value must be a path to
the directory containing a JDK or JRE. It should not be a label.
This option should appear before any bazel command, and not be confused with the build option
- <a href='#flag--host_javabase'>--host_javabase</a>, for example:
+ <a href='#flag--server_javabase'>--server_javabase</a>, for example:
</p>
<pre>
- % bazel --host_javabase=/usr/local/buildtools/java/jdk9 build //foo
+ % bazel --server_javabase=/usr/local/buildtools/java/jdk9 build //foo
</pre>
<p>
This flag does <i>not</i> affect the JVMs used by Bazel subprocesses such as applications, tests,
tools, and so on. Use build options <a href='#flag--javabase'>--javabase</a> or
<a href='#flag--host_javabase'>--host_javabase</a> instead.
</p>
+<p>
+ This flag was previously named <code>--host_javabase</code> (sometimes referred to as the
+ 'left-hand side' <code>--host_javabase</code>), but was renamed to avoid confusion with the
+ build flag <a href='#flag--host_javabase'>--host_javabase</a> (sometimes referred to as the
+ 'right-hand side' <code>--host_javabase</code>).
+</p>
<h4 id='flag--host_jvm_args'><code class='flag'>--host_jvm_args=<var>string</var></code></h4>
<p>
