aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/user-manual.html
diff options
context:
space:
mode:
authorGravatar Benjamin Peterson <bp@benjamin.pe>2017-12-04 10:46:48 -0800
committerGravatar Copybara-Service <copybara-piper@google.com>2017-12-04 10:48:54 -0800
commit0b3185469688986a83006633396403de0d97af2d (patch)
tree5fc486b43d1ad2b19f3e88666d9e90f8e158643d /site/docs/user-manual.html
parent44e40bc84d05eea7a3527fed12028ef58e90d607 (diff)
Move extra action flag docs into the Semantics section.
Previously, they were in the Error checking options section, which doesn't seem correct. Change-Id: I1306da91cff01157963d56db267188bda7d57d4f PiperOrigin-RevId: 177835450
Diffstat (limited to 'site/docs/user-manual.html')
-rw-r--r--site/docs/user-manual.html98
1 files changed, 49 insertions, 49 deletions
diff --git a/site/docs/user-manual.html b/site/docs/user-manual.html
index f1aedd9d41..0c03780f83 100644
--- a/site/docs/user-manual.html
+++ b/site/docs/user-manual.html
@@ -1134,55 +1134,6 @@ $ bazel fetch //...
checking is done.
</p>
-
-<h4 id='flag--experimental_action_listener'>
- <code class='flag'>--experimental_action_listener=<var>label</var></code>
-</h4>
-<p>
- The <code>experimental_action_listener</code> option instructs Bazel to use
- details from the <a href="be/extra-actions.html#action_listener"
- ><code>action_listener</code></a> rule specified by <var>label</var> to
- insert <a href="be/extra-actions.html#extra_action"
- ><code>extra_actions</code></a> into the build graph.
-</p>
-
-<h4 id='flag--experimental_extra_action_top_level_only'>
- <code class='flag'>--[no]experimental_extra_action_top_level_only</code>
-</h4>
-<p>
- If this option is set to true, extra actions specified by the
- <a href='#flag--experimental_action_listener'> <code>
- --experimental_action_listener</code></a> command line option will only be
- scheduled for top level targets.
-</p>
-
-<h4 id='flag--experimental_extra_action_filter'>
- <code class='flag'>--experimental_extra_action_filter=<var>regex</var></code>
-</h4>
-<p>
- The <code>experimental_extra_action_filter</code> option instructs Bazel to
- filter the set of targets to schedule <code>extra_actions</code> for.
-</p>
-<p>
- This flag is only applicable in combination with the
- <a href='#flag--experimental_action_listener'
- ><code>--experimental_action_listener</code></a> flag.
-</p>
-<p>
- By default all <code>extra_actions</code> in the transitive closure of the
- requested targets-to-build get scheduled for execution.
- <code>--experimental_extra_action_filter</code> will restrict scheduling to
- <code>extra_actions</code> of which the owner's label matches the specified
- regular expression.
-</p>
-<p>
- The following example will limit scheduling of <code>extra_actions</code>
- to only apply to actions of which the owner's label contains '/bar/':
-</p>
-<pre>% bazel build --experimental_action_listener=//test:al //foo/... \
- --experimental_extra_action_filter=.*/bar/.*
-</pre>
-
<h4 id='flag--output_filter'><code class='flag'>--output_filter <var>regex</var></code></h4>
<p>
The <code class='flag'>--output_filter</code> option will only show build and compilation
@@ -1582,6 +1533,55 @@ the compilation of binaries during the build.
</p>
+<h4 id='flag--experimental_action_listener'>
+ <code class='flag'>--experimental_action_listener=<var>label</var></code>
+</h4>
+<p>
+ The <code>experimental_action_listener</code> option instructs Bazel to use
+ details from the <a href="be/extra-actions.html#action_listener"
+ ><code>action_listener</code></a> rule specified by <var>label</var> to
+ insert <a href="be/extra-actions.html#extra_action"
+ ><code>extra_actions</code></a> into the build graph.
+</p>
+
+<h4 id='flag--experimental_extra_action_top_level_only'>
+ <code class='flag'>--[no]experimental_extra_action_top_level_only</code>
+</h4>
+<p>
+ If this option is set to true, extra actions specified by the
+ <a href='#flag--experimental_action_listener'> <code>
+ --experimental_action_listener</code></a> command line option will only be
+ scheduled for top level targets.
+</p>
+
+<h4 id='flag--experimental_extra_action_filter'>
+ <code class='flag'>--experimental_extra_action_filter=<var>regex</var></code>
+</h4>
+<p>
+ The <code>experimental_extra_action_filter</code> option instructs Bazel to
+ filter the set of targets to schedule <code>extra_actions</code> for.
+</p>
+<p>
+ This flag is only applicable in combination with the
+ <a href='#flag--experimental_action_listener'
+ ><code>--experimental_action_listener</code></a> flag.
+</p>
+<p>
+ By default all <code>extra_actions</code> in the transitive closure of the
+ requested targets-to-build get scheduled for execution.
+ <code>--experimental_extra_action_filter</code> will restrict scheduling to
+ <code>extra_actions</code> of which the owner's label matches the specified
+ regular expression.
+</p>
+<p>
+ The following example will limit scheduling of <code>extra_actions</code>
+ to only apply to actions of which the owner's label contains '/bar/':
+</p>
+<pre>% bazel build --experimental_action_listener=//test:al //foo/... \
+ --experimental_extra_action_filter=.*/bar/.*
+</pre>
+
+<h3 id='strategy-options'>Build strategy options</h3>
<p>
Note that a particular combination of crosstool version, compiler version,
libc version, and target CPU is allowed only if it has been specified