diff options
Diffstat (limited to 'src/main/java/com/google/devtools/build/docgen/templates/attributes/common/deps.html')
-rw-r--r-- | src/main/java/com/google/devtools/build/docgen/templates/attributes/common/deps.html | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/deps.html b/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/deps.html new file mode 100644 index 0000000000..9b42a2b9ca --- /dev/null +++ b/src/main/java/com/google/devtools/build/docgen/templates/attributes/common/deps.html @@ -0,0 +1,20 @@ +A list of dependencies of this rule. +<i>(List of <a href="build-ref.html#labels">labels</a>; optional)</i><br/> +The precise semantics of what it means for this rule to depend on +another using <code>deps</code> are specific to the kind of this rule, +and the rule-specific documentation below goes into more detail. +At a minimum, though, the targets named via <code>deps</code> will +appear in the <code>*.runfiles</code> area of this rule, if it has +one. +<p>Most often, a <code>deps</code> dependency is used to allow one +module to use symbols defined in another module written in the +same programming language and separately compiled. Cross-language +dependencies are also permitted in many cases: for example, +a <code>java_library</code> rule may depend on C++ code in +a <code>cc_library</code> rule, by declaring the latter in +the <code>deps</code> attribute. See the definition +of <a href="build-ref.html#deps">dependencies</a> for more +information.</p> +<p>Almost all rules permit a <code>deps</code> attribute, but where +this attribute is not allowed, this fact is documented under the +specific rule.</p> |