Undocument license API, which Bazel no longer uses
https://github.com/bazelbuild/bazel/issues/7444
The detailed description of license types was written for
https://github.com/bazelbuild/bazel/issues/642, which was
created only because users were forced to set these values.
This is no longer true.
PiperOrigin-RevId: 243998042
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
index 6cf91eb..ffc420a 100644
--- 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
@@ -2,32 +2,8 @@
<p>
The licenses of the output files that this binary generates.
+
+This is part of a deprecated licensing API that Bazel no longer uses. Don't
+use this.
</p>
-<p>
-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>
-
-<p>
-(For more about the distinction between host and target
-configurations,
-see <a href="../user-manual.html#configurations">Build
-configurations</a> in the Bazel manual.)</p>
-
-<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>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/distribs.html b/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/distribs.html
index 70b19eb..d624d39 100644
--- a/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/distribs.html
+++ b/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/distribs.html
@@ -1,7 +1,8 @@
<p><code>List of strings; optional</code></p>
<p>
-A list of distribution-method strings to be used for this particular build rule.
-Overrides the <code>BUILD</code>-file scope defaults defined by the
-<a href="${link distribs}"><code>distribs()</code></a> directive.
+ A list of distribution-method strings to be used for this particular build rule.
+
+This is part of a deprecated licensing API that Bazel no longer uses. Don't
+use this.
</p>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/licenses.html b/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/licenses.html
index 9f58556..932d945 100644
--- a/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/licenses.html
+++ b/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/licenses.html
@@ -1,7 +1,8 @@
<p><code>List of strings; optional</code></p>
<p>
-A list of license-type strings to be used for this particular build rule.
-Overrides the <code>BUILD</code>-file scope defaults defined by the
-<a href="${link licenses}"><code>licenses()</code></a> directive.
+ A list of license-type strings to be used for this particular build rule.
+
+This is part of a deprecated licensing API that Bazel no longer uses. Don't
+use this.
</p>
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm
index fc2bb74..21a608c 100644
--- a/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm
+++ b/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm
@@ -245,52 +245,6 @@
</pre>
<!-- =================================================================
- licenses()
- =================================================================
--->
-
-<h2 id="licenses">licenses</h2>
-
-<pre>licenses(license_types)</pre>
-
-<p><code>licenses()</code> specifies the default license type (or types)
- of the build rules in a <code>BUILD</code> file.
-
- The <code>licenses()</code> directive should appear close to the
- beginning of the <code>BUILD</code> file, before any build rules, as it
- sets the <code>BUILD</code>-file scope default for build rule license
- types.</p>
-
-<h3 id="licenses_args">Arguments</h3>
-
-<p>The argument, <code id="licenses.licence_types">license_types</code>,
- is a list of license-type strings.
- <!-- TODO(bazel-team): specify some examples -->
-
-</p>
-
-<p>Valid license types include:</p>
-<dl>
- <dt><code>restricted</code></dt><dd>Requires mandatory source
- distribution.</dd>
- <dt><code>reciprocal</code></dt><dd>Allows usage of software freely in
- <b>unmodified</b> form. Any modifications must be made freely
- available.</dd>
- <dt><code>notice</code></dt><dd>Original or modified third-party software may
- be shipped without danger nor encumbering other sources. All of the
- licenses in this category do, however, have an "original Copyright notice"
- or "advertising clause", wherein any external distributions must include
- the notice or clause specified in the license.</dd>
- <dt><code>permissive</code></dt><dd>Code that is under a license but does not
- require a notice.</dd>
- <dt><code>unencumbered</code></dt><dd>Public domain, free for any use.</dd>
-</dl>
-licenses(["notice"]) # MIT license
-
-exports_files(["jquery-2.1.1.js"])
-</pre>
-
-<!-- =================================================================
exports_files([label, ...])
=================================================================
-->
