Remove gyb files

Author: kimdv

CodeGeneration/Package.swift

@@ -26,25 +26,7 @@ let package = Package(
       ]
     ),
     .target(
-      name: "SyntaxSupport",
-      exclude: [
-        "gyb_helpers",
-        "AttributeNodes.swift.gyb",
-        "AvailabilityNodes.swift.gyb",
-        "BuilderInitializableTypes.swift.gyb",
-        "Classification.swift.gyb",
-        "CommonNodes.swift.gyb",
-        "DeclNodes.swift.gyb",
-        "ExprNodes.swift.gyb",
-        "GenericNodes.swift.gyb",
-        "PatternNodes.swift.gyb",
-        "StmtNodes.swift.gyb",
-        "SyntaxBaseKinds.swift.gyb",
-        "TokenSpec.swift.gyb",
-        "Traits.swift.gyb",
-        "Trivia.swift.gyb",
-        "TypeNodes.swift.gyb",
-      ]
+      name: "SyntaxSupport"
     ),
     .target(
       name: "Utils",

…pport/gyb_generated/AttributeNodes.swift …urces/SyntaxSupport/AttributeNodes.swiftCodeGeneration/Sources/SyntaxSupport/gyb_generated/AttributeNodes.swift renamed to CodeGeneration/Sources/SyntaxSupport/AttributeNodes.swift CodeGeneration/Sources/SyntaxSupport/gyb_generated/AttributeNodes.swift renamed to CodeGeneration/Sources/SyntaxSupport/AttributeNodes.swift

@@ -13,6 +13,7 @@
 //===----------------------------------------------------------------------===//
 
 public let ATTRIBUTE_NODES: [Node] = [
+  // attribute-list -> attribute attribute-list?
   Node(name: "AttributeList",
        nameForDiagnostics: "attributes",
        kind: "SyntaxCollection",
@@ -21,6 +22,16 @@ public let ATTRIBUTE_NODES: [Node] = [
        elementChoices: ["Attribute", "IfConfigDecl"],
        omitWhenEmpty: true),
 
+  // attribute -> '@' identifier '('?
+  //              ( identifier
+  //                | string-literal
+  //                | integer-literal
+  //                | availability-spec-list
+  //                | specialize-attr-spec-list
+  //                | implements-attr-arguments
+  //                | named-attribute-string-argument
+  //                | back-deploy-attr-spec-list
+  //              )? ')'?
   Node(name: "Attribute",
        nameForDiagnostics: "attribute",
        description: "An `@` attribute.",
@@ -108,6 +119,7 @@ public let ATTRIBUTE_NODES: [Node] = [
                kind: .token(choices: [.token(tokenKind: "SemicolonToken")]))
        ]),
 
+  // back-deploy-version-entry -> availability-version-restriction ','?
   Node(name: "AvailabilityVersionRestrictionListEntry",
        nameForDiagnostics: "version",
        description: "A single platform/version pair in an attribute, e.g. `iOS 10.1`.",
@@ -122,11 +134,15 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // back-deploy-version-list ->
+  //   back-deploy-version-entry back-deploy-version-list?
   Node(name: "AvailabilityVersionRestrictionList",
        nameForDiagnostics: "version list",
        kind: "SyntaxCollection",
        element: "AvailabilityVersionRestrictionListEntry"),
 
+  // The arguments of '@backDeployed(...)'
+  // back-deployed-attr-spec-list -> 'before' ':' back-deployed-version-list
   Node(name: "BackDeployedAttributeSpecList",
        nameForDiagnostics: "'@backDeployed' arguments",
        description: "A collection of arguments for the `@backDeployed` attribute",
@@ -143,6 +159,7 @@ public let ATTRIBUTE_NODES: [Node] = [
                description: "The list of OS versions in which the declaration became ABI stable.")
        ]),
 
+  // convention-attribute-arguments -> token ',' 'cType'? ':' string-literal
   Node(name: "ConventionAttributeArguments",
        nameForDiagnostics: "@convention(...) arguments",
        description: "The arguments for the '@convention(...)'.",
@@ -165,6 +182,7 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // convention-attribute-arguments -> 'witness_method' ':' identifier
   Node(name: "ConventionWitnessMethodAttributeArguments",
        nameForDiagnostics: "@convention(...) arguments for witness methods",
        description: "The arguments for the '@convention(witness_method: ...)'.",
@@ -193,6 +211,12 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // The argument of the derivative registration attribute
+  // '@derivative(of: ...)' and the transpose registration attribute
+  // '@transpose(of: ...)'.
+  //
+  // derivative-registration-attr-arguments ->
+  //     'of' ':' func-decl-name ','? differentiability-params-clause?
   Node(name: "DerivativeRegistrationAttributeArguments",
        nameForDiagnostics: "attribute arguments",
        description: "The arguments for the '@derivative(of:)' and '@transpose(of:)' attributes: the 'of:' label, the original declaration name, and an optional differentiability parameter list.",
@@ -223,11 +247,14 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // differentiability-param-list ->
+  //     differentiability-param differentiability-param-list?
   Node(name: "DifferentiabilityParamList",
        nameForDiagnostics: "differentiability parameters",
        kind: "SyntaxCollection",
        element: "DifferentiabilityParam"),
 
+  // differentiability-param -> ('self' | identifier | integer-literal) ','?
   Node(name: "DifferentiabilityParam",
        nameForDiagnostics: "differentiability parameter",
        description: "A differentiability parameter: either the \"self\" identifier, a function parameter name, or a function parameter index.",
@@ -243,6 +270,8 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // differentiability-params-clause ->
+  //     'wrt' ':' (differentiability-param | differentiability-params)
   Node(name: "DifferentiabilityParamsClause",
        nameForDiagnostics: "'@differentiable' argument",
        description: "A clause containing differentiability parameters.",
@@ -264,6 +293,7 @@ public let ATTRIBUTE_NODES: [Node] = [
                nameForDiagnostics: "parameters")
        ]),
 
+  // differentiability-params -> '(' differentiability-param-list ')'
   Node(name: "DifferentiabilityParams",
        nameForDiagnostics: "differentiability parameters",
        description: "The differentiability parameters.",
@@ -278,6 +308,10 @@ public let ATTRIBUTE_NODES: [Node] = [
                kind: .token(choices: [.token(tokenKind: "RightParenToken")]))
        ]),
 
+  // The argument of '@differentiable(...)'.
+  // differentiable-attr-arguments ->
+  //     differentiability-kind? '.'? differentiability-params-clause? ','?
+  //     generic-where-clause?
   Node(name: "DifferentiableAttributeArguments",
        nameForDiagnostics: "'@differentiable' arguments",
        description: "The arguments for the `@differentiable` attribute: an optional differentiability kind, an optional differentiability parameter clause, and an optional 'where' clause.",
@@ -317,7 +351,7 @@ public let ATTRIBUTE_NODES: [Node] = [
          Child(name: "Value",
                kind: .nodeChoices(choices: [
                  Child(name: "Token",
-                       kind: .token(choices: [.token(tokenKind: "IdentifierToken"), .token(tokenKind: "KeywordToken")])),
+                       kind: .token(choices: [.token(tokenKind: "IdentifierToken"), .token(tokenKind: "KeywordToken")])), // Keywords can be: public, internal, private, fileprivate, open
                  Child(name: "String",
                        kind: .node(kind: "StringLiteralExpr"))
                ])),
@@ -367,6 +401,9 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // The argument of '@_implements(...)'
+  // implements-attr-arguments -> simple-type-identifier ','
+  //                              (identifier | operator) decl-name-arguments
   Node(name: "ImplementsAttributeArguments",
        nameForDiagnostics: "@_implements arguemnts",
        description: "The arguments for the `@_implements` attribute of the form `Type, methodName(arg1Label:arg2Label:)`",
@@ -390,6 +427,8 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // Representation of e.g. 'exported: true,'
+  // labeled-specialize-entry -> identifier ':' token ','?
   Node(name: "LabeledSpecializeEntry",
        nameForDiagnostics: "attribute argument",
        description: "A labeled argument for the `@_specialize` attribute like `exported: true`",
@@ -415,6 +454,7 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // objc-selector-piece -> identifier? ':'?
   Node(name: "ObjCSelectorPiece",
        nameForDiagnostics: "Objective-C selector piece",
        description: "A piece of an Objective-C selector. Either consisting of just an identifier for a nullary selector, an identifier and a colon for a labeled argument or just a colon for an unlabeled argument",
@@ -429,11 +469,13 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // objc-selector -> objc-selector-piece objc-selector?
   Node(name: "ObjCSelector",
        nameForDiagnostics: "Objective-C selector",
        kind: "SyntaxCollection",
        element: "ObjCSelectorPiece"),
 
+  // opaque-return-type-of-arguments -> string-literal ',' integer-literal
   Node(name: "OpaqueReturnTypeOfAttributeArguments",
        nameForDiagnostics: "opaque return type arguments",
        description: "The arguments for the '@_opaqueReturnTypeOf()'.",
@@ -466,6 +508,15 @@ public let ATTRIBUTE_NODES: [Node] = [
                kind: .collection(kind: "AvailabilityVersionRestrictionList", collectionElementName: "Platform"))
        ]),
 
+  // An optionally qualified declaration name.
+  // Currently used only for `@derivative` and `@transpose` attribute.
+  // TODO(TF-1066): Use module qualified name syntax/parsing instead of custom
+  // qualified name syntax/parsing.
+  //
+  // qualified-decl-name ->
+  //     base-type? '.'? (identifier | operator) decl-name-arguments?
+  // base-type ->
+  //     member-type-identifier | base-type-identifier
   Node(name: "QualifiedDeclName",
        nameForDiagnostics: "declaration name",
        description: "An optionally qualified function declaration name (e.g. `+(_:_:)`, `A.B.C.foo(_:_:)`).",
@@ -490,6 +541,11 @@ public let ATTRIBUTE_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // The argument of '@_specialize(...)'
+  // specialize-attr-spec-list -> labeled-specialize-entry
+  //                                  specialize-spec-attr-list?
+  //                            | generic-where-clause
+  //                                  specialize-spec-attr-list?
   Node(name: "SpecializeAttributeSpecList",
        nameForDiagnostics: "argument to '@_specialize",
        description: "A collection of arguments for the `@_specialize` attribute",
@@ -498,6 +554,8 @@ public let ATTRIBUTE_NODES: [Node] = [
        elementName: "SpecializeAttribute",
        elementChoices: ["LabeledSpecializeEntry", "AvailabilityEntry", "TargetFunctionEntry", "GenericWhereClause"]),
 
+  // Representation of e.g. 'exported: true,'
+  // labeled-specialize-entry -> identifier ':' token ','?
   Node(name: "TargetFunctionEntry",
        nameForDiagnostics: "attribute argument",
        description: "A labeled argument for the `@_specialize` attribute with a function decl value like `target: myFunc(_:)`",

CodeGeneration/Sources/SyntaxSupport/AttributeNodes.swift.gyb

@@ -13,6 +13,11 @@
 //===----------------------------------------------------------------------===//
 
 public let AVAILABILITY_NODES: [Node] = [
+  // Wrapper for all the different entries that may occur inside @available
+  // availability-entry -> '*' ','?
+  //                     | identifier ','?
+  //                     | availability-version-restriction ','?
+  //                     | availability-versioned-argument ','?
   Node(name: "AvailabilityArgument",
        nameForDiagnostics: "availability argument",
        description: "A single argument to an `@available` argument like `*`, `iOS 10.1`, or `message: \"This has been deprecated\"`.",
@@ -34,6 +39,8 @@ public let AVAILABILITY_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // Representation of 'deprecated: 2.3', 'message: "Hello world"' etc.
+  // availability-versioned-argument -> identifier ':' version-tuple
   Node(name: "AvailabilityLabeledArgument",
        nameForDiagnostics: "availability argument",
        description: "A argument to an `@available` attribute that consists of a label and a value, e.g. `message: \"This has been deprecated\"`.",
@@ -57,11 +64,14 @@ public let AVAILABILITY_NODES: [Node] = [
                description: "The value of this labeled argument")
        ]),
 
+  // availability-spec-list -> availability-entry availability-spec-list?
   Node(name: "AvailabilitySpecList",
        nameForDiagnostics: "'@availability' arguments",
        kind: "SyntaxCollection",
        element: "AvailabilityArgument"),
 
+  // Representation for 'iOS 10', 'swift 3.4' etc.
+  // availability-version-restriction -> identifier version-tuple
   Node(name: "AvailabilityVersionRestriction",
        nameForDiagnostics: "version restriction",
        description: "An argument to `@available` that restricts the availability on a certain platform to a version, e.g. `iOS 10` or `swift 3.4`.",
@@ -78,6 +88,9 @@ public let AVAILABILITY_NODES: [Node] = [
                isOptional: true)
        ]),
 
+  // version-tuple -> integer-literal
+  //                | float-literal
+  //                | float-literal '.' integer-literal
   Node(name: "VersionTuple",
        nameForDiagnostics: "version tuple",
        description: "A version number of the form major.minor.patch in which the minor and patch part may be omitted.",