Swift: update docs

Author: AlexDenisov

swift/ql/.generated.list

@@ -4,7 +4,13 @@
 
 private import codeql.swift.generated.MacroRole
 
+/**
+ * The role of a macro, for example #freestanding(declaration) or @attached(member).
+ */
 class MacroRole extends Generated::MacroRole {
+  /**
+   * String representation of the role kind.
+   */
   string getKindName() {
     this.getKind() = 1 and result = "expression"
     or
@@ -25,6 +31,9 @@ class MacroRole extends Generated::MacroRole {
     this.getKind() = 256 and result = "extension"
   }
 
+  /**
+   * String representation of the syntax kind.
+   */
   string getMacroSyntaxName() {
     this.getMacroSyntax() = 0 and result = "#freestanding"
     or

swift/ql/lib/codeql/swift/elements/MacroRole.qll

@@ -1365,7 +1365,7 @@ class BorrowExpr(IdentityExpr):
 @qltest.test_with('MacroDecl')
 class MacroRole(AstNode):
     """
-    The role of a macro.
+    The role of a macro, for example #freestanding(declaration) or @attached(member).
     """
     kind: int | doc("kind of this macro role (declaration, expression, member, etc.)")
     macro_syntax: int | doc("#freestanding or @attached")