Glob documentation is updated.

--
MOS_MIGRATED_REVID=88325408

2 files changed, 7 insertions, 2 deletions

diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be-footer.html b/src/main/java/com/google/devtools/build/docgen/templates/be-footer.html
index 75c764e77f..f2dda2608b 100644
--- a/src/main/java/com/google/devtools/build/docgen/templates/be-footer.html
+++ b/src/main/java/com/google/devtools/build/docgen/templates/be-footer.html
@@ -316,6 +316,10 @@ There are several important limitations and caveats:
     A hidden file with filename starting with <code>.</code> is matched by
     both the <code>**</code> and the <code>*</code> wildcards.
   </li>
+  <li>
+    If a rule and a source file with the same name both exist in the package, the glob will
+    return the outputs of the rule instead of the source file.
+  </li>
 </ol>
 
 <p>
diff --git a/src/main/java/com/google/devtools/build/lib/bazel/rules/common/BazelFilegroupRule.java b/src/main/java/com/google/devtools/build/lib/bazel/rules/common/BazelFilegroupRule.java
index 9103cf8817..23d7c9c437 100644
--- a/src/main/java/com/google/devtools/build/lib/bazel/rules/common/BazelFilegroupRule.java
+++ b/src/main/java/com/google/devtools/build/lib/bazel/rules/common/BazelFilegroupRule.java
@@ -44,8 +44,9 @@ public final class BazelFilegroupRule implements RuleDefinition {
         ${SYNOPSIS}
         <p>
           It is common to use the result of a <a href="#glob">glob</a> expression for the value
-          of the <code>srcs</code> attribute. If the glob matches a source file with the same
-          name as a build rule, the rule will override the file.
+          of the <code>srcs</code> attribute. If a rule and a source file with the same name both
+          exist in the package, the glob will return the outputs of the rule instead of the source
+          file.
         </p>
         <!-- #END_BLAZE_RULE.ATTRIBUTE -->*/
         .add(attr("srcs", LABEL_LIST).allowedFileTypes(FileTypeSet.ANY_FILE))