commit 8a92a758d836b0c3f9332c446bbb4a9445cb19be
author Googler <noreply@google.com> Mon Oct 01 02:36:15 2018 -0700
committer Copybara-Service <copybara-piper@google.com> Mon Oct 01 02:37:50 2018 -0700
tree 48852d79ee55e1f30d948c9f646f880d0882de64
parent d0609e83bb54f685d2f243e52513bbcf0c8a45ae

Mention how to create a test alias that actually runs the test.

RELNOTES: None.
PiperOrigin-RevId: 215183319

src/main/java/com/google/devtools/build/lib/rules/Alias.java

diff --git a/src/main/java/com/google/devtools/build/lib/rules/Alias.java b/src/main/java/com/google/devtools/build/lib/rules/Alias.java
index 85e651a..ed8d164 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/Alias.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/Alias.java
@@ -104,7 +104,10 @@
 
   <ul>
     <li>
-      Tests are not run if their alias is mentioned on the command line
+      Tests are not run if their alias is mentioned on the command line. To define an alias
+      that runs the referenced test, use a <a href="#test_suite"><code>test_suite</code></a>
+      rule with a single target in its <a href="#test_suite.tests"><code>tests</code></a>
+      attribute.
     </li>
     <li>
       When defining environment groups, the aliases to <code>environment</code> rules are not