aboutsummaryrefslogtreecommitdiffhomepage
path: root/site
diff options
context:
space:
mode:
Diffstat (limited to 'site')
-rw-r--r--site/docs/query.html15
1 files changed, 15 insertions, 0 deletions
diff --git a/site/docs/query.html b/site/docs/query.html
index 002cd2e2cd..55dc38854d 100644
--- a/site/docs/query.html
+++ b/site/docs/query.html
@@ -1309,6 +1309,21 @@ genrule(
multiple times will always produce the same output.
</p>
+<h3 id="output-build">Print the source form of targets as they would appear in BUILD</h3>
+<pre>--output build</pre>
+<p>
+ With this option, the representation of each target is as if it were
+ hand-written in the BUILD language. All variables and function calls
+ (e.g. glob, macros) are expanded, which is useful for seeing the effect
+ of Skylark macros. Additionally, each effective rule is annotated with
+ the name of the macro (if any, see <code>generator_name</code> and
+ <code>generator_function</code>) that produced it.
+</p>
+<p>
+ Although the output uses the same syntax as BUILD files, it is not
+ guaranteed to produce a valid BUILD file.
+</p>
+
<h3 id="output-label">Print the label of each target</h3>
<pre>--output label</pre>
<p>