Document the non-recursive nature of getSymbolsByUDA

dlang · Jun 19, 2015 · bbdf899 · bbdf899
1 parent b3c2d04
commit bbdf899
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/std/traits.d b/std/traits.d
@@ -6556,6 +6556,8 @@ unittest
 
 /**
  * Gets all symbols within `symbol` that have the given user-defined attribute.
+ * This is not recursive; it will not search for symbols within symbols such as
+ * nested structs or unions.
  */
 template getSymbolsByUDA(alias symbol, alias attribute)
 {
@@ -6579,6 +6581,11 @@ unittest
         int b;
         @Attr void doStuff() {}
         void doOtherStuff() {}
+        static struct Inner
+        {
+            // Not found by getSymbolsByUDA
+            @Attr int c;
+        }
     }
 
     // Finds both variables and functions with the attribute, but