diff options
| author |  Janak Ramakrishnan <janakr@google.com> | 2015-11-13 23:34:14 +0000 |
|---|---|---|
| committer |  Damien Martin-Guillerez <dmarting@google.com> | 2015-11-16 09:02:33 +0000 |
| commit | 533657e0b13320312268d3d4d23ae6507304a317 (patch) | |
| tree | 8a3fbe3e60cc8655f816695e8ecae04413734537 /site | |
| parent | b503be7b2e2e6a1601bff3790e6e292ff9076359 (diff) | |
Optionally allow Bazel to pass JVM options containing spaces directly through to the JVM instead of (almost certainly incorrectly) splitting the options along spaces.
This allows us to pass non-quote-delimited strings to the JVM, which is necessary for things like -XX:OnOutOfMemoryError="kill -3 %p" (normally bash strips those quotes, but they're not stripped when passed via --host_jvm_args).
--
MOS_MIGRATED_REVID=107820087
Diffstat (limited to 'site')
| -rw-r--r-- | site/docs/bazel-user-manual.html | 9 |
1 files changed, 5 insertions, 4 deletions
diff --git a/site/docs/bazel-user-manual.html b/site/docs/bazel-user-manual.html index 1460d8a952..9eb7d0097f 100644 --- a/site/docs/bazel-user-manual.html +++ b/site/docs/bazel-user-manual.html @@ -3282,16 +3282,17 @@ adb -s deadbeef install ... <h4 id='flag--host_jvm_args'><code class='flag'>--host_jvm_args=<var>string</var></code></h4> <p> - Specifies a space-separated list of startup options to be passed to - the Java virtual machine in which <i>Bazel itself</i> runs. This - can be used to set the stack size, for example: + Specifies a startup option to be passed to the Java virtual machine in which <i>Bazel itself</i> + runs. This can be used to set the stack size, for example: </p> <pre> % bazel --host_jvm_args="-Xss256K" build //foo </pre> <p> This option can be used multiple times with individual arguments. Note that - setting this flag should rarely be needed. + setting this flag should rarely be needed. You can also pass a space-separated list of strings, + each of which will be interpreted as a separate JVM argument, but this feature will soon be + deprecated. </p> <p> |