aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html
diff options
context:
space:
mode:
authorGravatar Damien Martin-Guillerez <dmarting@google.com>2015-03-04 14:12:20 +0000
committerGravatar Han-Wen Nienhuys <hanwen@google.com>2015-03-05 18:23:54 +0000
commit9ec9d543177dcf4cbda22ae6cedac597f30d0d06 (patch)
tree4b910b8193cf9cc41fe114095177f1f5b9000f3f /src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html
parent2d96dc72025e22153f0ea423b97e41a512406980 (diff)
Build encyclopedia: moved the HTML out of the java class into templates
-- MOS_MIGRATED_REVID=87704425
Diffstat (limited to 'src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html')
-rw-r--r--src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html22
1 files changed, 22 insertions, 0 deletions
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html b/src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html
new file mode 100644
index 0000000000..8716afabd0
--- /dev/null
+++ b/src/main/java/com/google/devtools/build/docgen/templates/attributes/binary/output_licenses.html
@@ -0,0 +1,22 @@
+The licenses of the output files that this binary generates.
+<i>(List of strings; optional)</i><br/>
+Describes the licenses of the output of the binary generated by
+the rule. When a binary is referenced in a host attribute (for
+example, the <code>tools</code> attribute of
+a <code>genrule</code>), this license declaration is used rather
+than the union of the licenses of its transitive closure. This
+argument is useful when a binary is used as a tool during the
+build of a rule, and it is not desirable for its license to leak
+into the license of that rule. If this attribute is missing, the
+license computation proceeds as if the host dependency was a
+regular dependency.
+<p>(For more about the distinction between host and target
+configurations,
+see <a href="bazel-user-manual.html#configurations">Build
+configurations</a> in the Bazel manual.)
+<p><em class="harmful">WARNING: in some cases (specifically, in
+genrules) the build tool cannot guarantee that the binary
+referenced by this attribute is actually used as a tool, and is
+not, for example, copied to the output. In these cases, it is the
+responsibility of the user to make sure that this is
+true.</em></p>