prism 0.29.0 → 1.1.0

data/include/prism/ast.h

@@ -1,10 +1,10 @@
-/******************************************************************************/
+/*----------------------------------------------------------------------------*/
 /* This file is generated by the templates/template.rb script and should not  */
 /* be modified manually. See                                                  */
 /* templates/include/prism/ast.h.erb                                          */
 /* if you are looking to modify the                                           */
 /* template                                                                   */
-/******************************************************************************/
+/*----------------------------------------------------------------------------*/
 
 /**
  * @file ast.h
@@ -831,194 +831,197 @@ enum pm_node_type {
     /** InterpolatedXStringNode */
     PM_INTERPOLATED_X_STRING_NODE = 87,
 
+    /** ItLocalVariableReadNode */
+    PM_IT_LOCAL_VARIABLE_READ_NODE = 88,
+
     /** ItParametersNode */
-    PM_IT_PARAMETERS_NODE = 88,
+    PM_IT_PARAMETERS_NODE = 89,
 
     /** KeywordHashNode */
-    PM_KEYWORD_HASH_NODE = 89,
+    PM_KEYWORD_HASH_NODE = 90,
 
     /** KeywordRestParameterNode */
-    PM_KEYWORD_REST_PARAMETER_NODE = 90,
+    PM_KEYWORD_REST_PARAMETER_NODE = 91,
 
     /** LambdaNode */
-    PM_LAMBDA_NODE = 91,
+    PM_LAMBDA_NODE = 92,
 
     /** LocalVariableAndWriteNode */
-    PM_LOCAL_VARIABLE_AND_WRITE_NODE = 92,
+    PM_LOCAL_VARIABLE_AND_WRITE_NODE = 93,
 
     /** LocalVariableOperatorWriteNode */
-    PM_LOCAL_VARIABLE_OPERATOR_WRITE_NODE = 93,
+    PM_LOCAL_VARIABLE_OPERATOR_WRITE_NODE = 94,
 
     /** LocalVariableOrWriteNode */
-    PM_LOCAL_VARIABLE_OR_WRITE_NODE = 94,
+    PM_LOCAL_VARIABLE_OR_WRITE_NODE = 95,
 
     /** LocalVariableReadNode */
-    PM_LOCAL_VARIABLE_READ_NODE = 95,
+    PM_LOCAL_VARIABLE_READ_NODE = 96,
 
     /** LocalVariableTargetNode */
-    PM_LOCAL_VARIABLE_TARGET_NODE = 96,
+    PM_LOCAL_VARIABLE_TARGET_NODE = 97,
 
     /** LocalVariableWriteNode */
-    PM_LOCAL_VARIABLE_WRITE_NODE = 97,
+    PM_LOCAL_VARIABLE_WRITE_NODE = 98,
 
     /** MatchLastLineNode */
-    PM_MATCH_LAST_LINE_NODE = 98,
+    PM_MATCH_LAST_LINE_NODE = 99,
 
     /** MatchPredicateNode */
-    PM_MATCH_PREDICATE_NODE = 99,
+    PM_MATCH_PREDICATE_NODE = 100,
 
     /** MatchRequiredNode */
-    PM_MATCH_REQUIRED_NODE = 100,
+    PM_MATCH_REQUIRED_NODE = 101,
 
     /** MatchWriteNode */
-    PM_MATCH_WRITE_NODE = 101,
+    PM_MATCH_WRITE_NODE = 102,
 
     /** MissingNode */
-    PM_MISSING_NODE = 102,
+    PM_MISSING_NODE = 103,
 
     /** ModuleNode */
-    PM_MODULE_NODE = 103,
+    PM_MODULE_NODE = 104,
 
     /** MultiTargetNode */
-    PM_MULTI_TARGET_NODE = 104,
+    PM_MULTI_TARGET_NODE = 105,
 
     /** MultiWriteNode */
-    PM_MULTI_WRITE_NODE = 105,
+    PM_MULTI_WRITE_NODE = 106,
 
     /** NextNode */
-    PM_NEXT_NODE = 106,
+    PM_NEXT_NODE = 107,
 
     /** NilNode */
-    PM_NIL_NODE = 107,
+    PM_NIL_NODE = 108,
 
     /** NoKeywordsParameterNode */
-    PM_NO_KEYWORDS_PARAMETER_NODE = 108,
+    PM_NO_KEYWORDS_PARAMETER_NODE = 109,
 
     /** NumberedParametersNode */
-    PM_NUMBERED_PARAMETERS_NODE = 109,
+    PM_NUMBERED_PARAMETERS_NODE = 110,
 
     /** NumberedReferenceReadNode */
-    PM_NUMBERED_REFERENCE_READ_NODE = 110,
+    PM_NUMBERED_REFERENCE_READ_NODE = 111,
 
     /** OptionalKeywordParameterNode */
-    PM_OPTIONAL_KEYWORD_PARAMETER_NODE = 111,
+    PM_OPTIONAL_KEYWORD_PARAMETER_NODE = 112,
 
     /** OptionalParameterNode */
-    PM_OPTIONAL_PARAMETER_NODE = 112,
+    PM_OPTIONAL_PARAMETER_NODE = 113,
 
     /** OrNode */
-    PM_OR_NODE = 113,
+    PM_OR_NODE = 114,
 
     /** ParametersNode */
-    PM_PARAMETERS_NODE = 114,
+    PM_PARAMETERS_NODE = 115,
 
     /** ParenthesesNode */
-    PM_PARENTHESES_NODE = 115,
+    PM_PARENTHESES_NODE = 116,
 
     /** PinnedExpressionNode */
-    PM_PINNED_EXPRESSION_NODE = 116,
+    PM_PINNED_EXPRESSION_NODE = 117,
 
     /** PinnedVariableNode */
-    PM_PINNED_VARIABLE_NODE = 117,
+    PM_PINNED_VARIABLE_NODE = 118,
 
     /** PostExecutionNode */
-    PM_POST_EXECUTION_NODE = 118,
+    PM_POST_EXECUTION_NODE = 119,
 
     /** PreExecutionNode */
-    PM_PRE_EXECUTION_NODE = 119,
+    PM_PRE_EXECUTION_NODE = 120,
 
     /** ProgramNode */
-    PM_PROGRAM_NODE = 120,
+    PM_PROGRAM_NODE = 121,
 
     /** RangeNode */
-    PM_RANGE_NODE = 121,
+    PM_RANGE_NODE = 122,
 
     /** RationalNode */
-    PM_RATIONAL_NODE = 122,
+    PM_RATIONAL_NODE = 123,
 
     /** RedoNode */
-    PM_REDO_NODE = 123,
+    PM_REDO_NODE = 124,
 
     /** RegularExpressionNode */
-    PM_REGULAR_EXPRESSION_NODE = 124,
+    PM_REGULAR_EXPRESSION_NODE = 125,
 
     /** RequiredKeywordParameterNode */
-    PM_REQUIRED_KEYWORD_PARAMETER_NODE = 125,
+    PM_REQUIRED_KEYWORD_PARAMETER_NODE = 126,
 
     /** RequiredParameterNode */
-    PM_REQUIRED_PARAMETER_NODE = 126,
+    PM_REQUIRED_PARAMETER_NODE = 127,
 
     /** RescueModifierNode */
-    PM_RESCUE_MODIFIER_NODE = 127,
+    PM_RESCUE_MODIFIER_NODE = 128,
 
     /** RescueNode */
-    PM_RESCUE_NODE = 128,
+    PM_RESCUE_NODE = 129,
 
     /** RestParameterNode */
-    PM_REST_PARAMETER_NODE = 129,
+    PM_REST_PARAMETER_NODE = 130,
 
     /** RetryNode */
-    PM_RETRY_NODE = 130,
+    PM_RETRY_NODE = 131,
 
     /** ReturnNode */
-    PM_RETURN_NODE = 131,
+    PM_RETURN_NODE = 132,
 
     /** SelfNode */
-    PM_SELF_NODE = 132,
+    PM_SELF_NODE = 133,
 
     /** ShareableConstantNode */
-    PM_SHAREABLE_CONSTANT_NODE = 133,
+    PM_SHAREABLE_CONSTANT_NODE = 134,
 
     /** SingletonClassNode */
-    PM_SINGLETON_CLASS_NODE = 134,
+    PM_SINGLETON_CLASS_NODE = 135,
 
     /** SourceEncodingNode */
-    PM_SOURCE_ENCODING_NODE = 135,
+    PM_SOURCE_ENCODING_NODE = 136,
 
     /** SourceFileNode */
-    PM_SOURCE_FILE_NODE = 136,
+    PM_SOURCE_FILE_NODE = 137,
 
     /** SourceLineNode */
-    PM_SOURCE_LINE_NODE = 137,
+    PM_SOURCE_LINE_NODE = 138,
 
     /** SplatNode */
-    PM_SPLAT_NODE = 138,
+    PM_SPLAT_NODE = 139,
 
     /** StatementsNode */
-    PM_STATEMENTS_NODE = 139,
+    PM_STATEMENTS_NODE = 140,
 
     /** StringNode */
-    PM_STRING_NODE = 140,
+    PM_STRING_NODE = 141,
 
     /** SuperNode */
-    PM_SUPER_NODE = 141,
+    PM_SUPER_NODE = 142,
 
     /** SymbolNode */
-    PM_SYMBOL_NODE = 142,
+    PM_SYMBOL_NODE = 143,
 
     /** TrueNode */
-    PM_TRUE_NODE = 143,
+    PM_TRUE_NODE = 144,
 
     /** UndefNode */
-    PM_UNDEF_NODE = 144,
+    PM_UNDEF_NODE = 145,
 
     /** UnlessNode */
-    PM_UNLESS_NODE = 145,
+    PM_UNLESS_NODE = 146,
 
     /** UntilNode */
-    PM_UNTIL_NODE = 146,
+    PM_UNTIL_NODE = 147,
 
     /** WhenNode */
-    PM_WHEN_NODE = 147,
+    PM_WHEN_NODE = 148,
 
     /** WhileNode */
-    PM_WHILE_NODE = 148,
+    PM_WHILE_NODE = 149,
 
     /** XStringNode */
-    PM_X_STRING_NODE = 149,
+    PM_X_STRING_NODE = 150,
 
     /** YieldNode */
-    PM_YIELD_NODE = 150,
+    PM_YIELD_NODE = 151,
 
     /** A special kind of node used for compilation. */
     PM_SCOPE_NODE
@@ -1040,11 +1043,8 @@ typedef uint16_t pm_node_flags_t;
  * We store the flags enum in every node in the tree. Some flags are common to
  * all nodes (the ones listed below). Others are specific to certain node types.
  */
-#define PM_NODE_FLAG_BITS (sizeof(pm_node_flags_t) * 8)
-
-static const pm_node_flags_t PM_NODE_FLAG_NEWLINE = (1 << (PM_NODE_FLAG_BITS - 1));
-static const pm_node_flags_t PM_NODE_FLAG_STATIC_LITERAL = (1 << (PM_NODE_FLAG_BITS - 2));
-static const pm_node_flags_t PM_NODE_FLAG_COMMON_MASK = (1 << (PM_NODE_FLAG_BITS - 1)) | (1 << (PM_NODE_FLAG_BITS - 2));
+static const pm_node_flags_t PM_NODE_FLAG_NEWLINE = 0x1;
+static const pm_node_flags_t PM_NODE_FLAG_STATIC_LITERAL = 0x2;
 
 /**
  * Cast the type to an enum to allow the compiler to provide exhaustiveness
@@ -1079,6 +1079,12 @@ typedef struct pm_node {
      */
     pm_node_flags_t flags;
 
+    /**
+     * The unique identifier for this node, which is deterministic based on the
+     * source. It is used to identify unique nodes across parses.
+     */
+    uint32_t node_id;
+
     /**
      * This is the location of the node in the source. It's a range of bytes
      * containing a start and an end.
@@ -1089,7 +1095,12 @@ typedef struct pm_node {
 /**
  * AliasGlobalVariableNode
  *
- * Type: PM_ALIAS_GLOBAL_VARIABLE_NODE
+ * Represents the use of the `alias` keyword to alias a global variable.
+ *
+ *     alias $foo $bar
+ *     ^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_ALIAS_GLOBAL_VARIABLE_NODE
  *
  * @extends pm_node_t
  */
@@ -1097,10 +1108,11 @@ typedef struct pm_alias_global_variable_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * AliasGlobalVariableNode#new_name
      *
-     * Represents the new name of the global variable that can be used after aliasing. This can be either a global variable, a back reference, or a numbered reference.
+     * Represents the new name of the global variable that can be used after aliasing.
      *
      *     alias $foo $bar
      *           ^^^^
@@ -1110,7 +1122,7 @@ typedef struct pm_alias_global_variable_node {
     /**
      * AliasGlobalVariableNode#old_name
      *
-     * Represents the old name of the global variable that could be used before aliasing. This can be either a global variable, a back reference, or a numbered reference.
+     * Represents the old name of the global variable that can be used before aliasing.
      *
      *     alias $foo $bar
      *                ^^^^
@@ -1131,7 +1143,12 @@ typedef struct pm_alias_global_variable_node {
 /**
  * AliasMethodNode
  *
- * Type: PM_ALIAS_METHOD_NODE
+ * Represents the use of the `alias` keyword to alias a method.
+ *
+ *     alias foo bar
+ *     ^^^^^^^^^^^^^
+ *
+ * Type: ::PM_ALIAS_METHOD_NODE
  *
  * @extends pm_node_t
  */
@@ -1139,13 +1156,36 @@ typedef struct pm_alias_method_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * AliasMethodNode#new_name
+     *
+     * Represents the new name of the method that will be aliased.
+     *
+     *     alias foo bar
+     *           ^^^
+     *
+     *     alias :foo :bar
+     *           ^^^^
+     *
+     *     alias :"#{foo}" :"#{bar}"
+     *           ^^^^^^^^^
      */
     struct pm_node *new_name;
 
     /**
      * AliasMethodNode#old_name
+     *
+     * Represents the old name of the method that will be aliased.
+     *
+     *     alias foo bar
+     *               ^^^
+     *
+     *     alias :foo :bar
+     *                ^^^^
+     *
+     *     alias :"#{foo}" :"#{bar}"
+     *                     ^^^^^^^^^
      */
     struct pm_node *old_name;
 
@@ -1158,7 +1198,12 @@ typedef struct pm_alias_method_node {
 /**
  * AlternationPatternNode
  *
- * Type: PM_ALTERNATION_PATTERN_NODE
+ * Represents an alternation pattern in pattern matching.
+ *
+ *     foo => bar | baz
+ *            ^^^^^^^^^
+ *
+ * Type: ::PM_ALTERNATION_PATTERN_NODE
  *
  * @extends pm_node_t
  */
@@ -1166,18 +1211,34 @@ typedef struct pm_alternation_pattern_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * AlternationPatternNode#left
+     *
+     * Represents the left side of the expression.
+     *
+     *     foo => bar | baz
+     *            ^^^
      */
     struct pm_node *left;
 
     /**
      * AlternationPatternNode#right
+     *
+     * Represents the right side of the expression.
+     *
+     *     foo => bar | baz
+     *                  ^^^
      */
     struct pm_node *right;
 
     /**
      * AlternationPatternNode#operator_loc
+     *
+     * Represents the alternation operator location.
+     *
+     *     foo => bar | baz
+     *                ^
      */
     pm_location_t operator_loc;
 } pm_alternation_pattern_node_t;
@@ -1185,7 +1246,12 @@ typedef struct pm_alternation_pattern_node {
 /**
  * AndNode
  *
- * Type: PM_AND_NODE
+ * Represents the use of the `&&` operator or the `and` keyword.
+ *
+ *     left and right
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_AND_NODE
  *
  * @extends pm_node_t
  */
@@ -1193,6 +1259,7 @@ typedef struct pm_and_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * AndNode#left
      *
@@ -1209,7 +1276,7 @@ typedef struct pm_and_node {
     /**
      * AndNode#right
      *
-     * Represents the right side of the expression. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
+     * Represents the right side of the expression.
      *
      *     left && right
      *             ^^^^^
@@ -1233,10 +1300,19 @@ typedef struct pm_and_node {
 /**
  * ArgumentsNode
  *
- * Type: PM_ARGUMENTS_NODE
- * Flags:
- *    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORDS
- *    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORD_SPLAT
+ * Represents a set of arguments to a method or a keyword.
+ *
+ *     return foo, bar, baz
+ *            ^^^^^^^^^^^^^
+ *
+ * Type: ::PM_ARGUMENTS_NODE
+
+ * Flags (#pm_arguments_node_flags):
+ * * ::PM_ARGUMENTS_NODE_FLAGS_CONTAINS_FORWARDING
+ * * ::PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORDS
+ * * ::PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORD_SPLAT
+ * * ::PM_ARGUMENTS_NODE_FLAGS_CONTAINS_SPLAT
+ * * ::PM_ARGUMENTS_NODE_FLAGS_CONTAINS_MULTIPLE_SPLATS
  *
  * @extends pm_node_t
  */
@@ -1244,6 +1320,7 @@ typedef struct pm_arguments_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ArgumentsNode#arguments
      */
@@ -1253,9 +1330,15 @@ typedef struct pm_arguments_node {
 /**
  * ArrayNode
  *
- * Type: PM_ARRAY_NODE
- * Flags:
- *    PM_ARRAY_NODE_FLAGS_CONTAINS_SPLAT
+ * Represents an array literal. This can be a regular array using brackets or a special array using % like %w or %i.
+ *
+ *     [1, 2, 3]
+ *     ^^^^^^^^^
+ *
+ * Type: ::PM_ARRAY_NODE
+
+ * Flags (#pm_array_node_flags):
+ * * ::PM_ARRAY_NODE_FLAGS_CONTAINS_SPLAT
  *
  * @extends pm_node_t
  */
@@ -1263,6 +1346,7 @@ typedef struct pm_array_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ArrayNode#elements
      *
@@ -1298,7 +1382,24 @@ typedef struct pm_array_node {
 /**
  * ArrayPatternNode
  *
- * Type: PM_ARRAY_PATTERN_NODE
+ * Represents an array pattern in pattern matching.
+ *
+ *     foo in 1, 2
+ *     ^^^^^^^^^^^
+ *
+ *     foo in [1, 2]
+ *     ^^^^^^^^^^^^^
+ *
+ *     foo in *1
+ *     ^^^^^^^^^
+ *
+ *     foo in Bar[]
+ *     ^^^^^^^^^^^^
+ *
+ *     foo in Bar[1, 2, 3]
+ *     ^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_ARRAY_PATTERN_NODE
  *
  * @extends pm_node_t
  */
@@ -1306,6 +1407,7 @@ typedef struct pm_array_pattern_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ArrayPatternNode#constant
      */
@@ -1340,7 +1442,12 @@ typedef struct pm_array_pattern_node {
 /**
  * AssocNode
  *
- * Type: PM_ASSOC_NODE
+ * Represents a hash key/value pair.
+ *
+ *     { a => b }
+ *       ^^^^^^
+ *
+ * Type: ::PM_ASSOC_NODE
  *
  * @extends pm_node_t
  */
@@ -1348,6 +1455,7 @@ typedef struct pm_assoc_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * AssocNode#key
      *
@@ -1391,7 +1499,12 @@ typedef struct pm_assoc_node {
 /**
  * AssocSplatNode
  *
- * Type: PM_ASSOC_SPLAT_NODE
+ * Represents a splat in a hash literal.
+ *
+ *     { **foo }
+ *       ^^^^^
+ *
+ * Type: ::PM_ASSOC_SPLAT_NODE
  *
  * @extends pm_node_t
  */
@@ -1399,6 +1512,7 @@ typedef struct pm_assoc_splat_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * AssocSplatNode#value
      *
@@ -1423,7 +1537,12 @@ typedef struct pm_assoc_splat_node {
 /**
  * BackReferenceReadNode
  *
- * Type: PM_BACK_REFERENCE_READ_NODE
+ * Represents reading a reference to a field in the previous match.
+ *
+ *     $'
+ *     ^^
+ *
+ * Type: ::PM_BACK_REFERENCE_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -1431,6 +1550,7 @@ typedef struct pm_back_reference_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BackReferenceReadNode#name
      *
@@ -1446,7 +1566,14 @@ typedef struct pm_back_reference_read_node {
 /**
  * BeginNode
  *
- * Type: PM_BEGIN_NODE
+ * Represents a begin statement.
+ *
+ *     begin
+ *       foo
+ *     end
+ *     ^^^^^
+ *
+ * Type: ::PM_BEGIN_NODE
  *
  * @extends pm_node_t
  */
@@ -1454,6 +1581,7 @@ typedef struct pm_begin_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BeginNode#begin_keyword_loc
      */
@@ -1488,7 +1616,12 @@ typedef struct pm_begin_node {
 /**
  * BlockArgumentNode
  *
- * Type: PM_BLOCK_ARGUMENT_NODE
+ * Represents a block argument using `&`.
+ *
+ *     bar(&args)
+ *     ^^^^^^^^^^
+ *
+ * Type: ::PM_BLOCK_ARGUMENT_NODE
  *
  * @extends pm_node_t
  */
@@ -1496,6 +1629,7 @@ typedef struct pm_block_argument_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BlockArgumentNode#expression
      */
@@ -1510,9 +1644,15 @@ typedef struct pm_block_argument_node {
 /**
  * BlockLocalVariableNode
  *
- * Type: PM_BLOCK_LOCAL_VARIABLE_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents a block local variable.
+ *
+ *     a { |; b| }
+ *            ^
+ *
+ * Type: ::PM_BLOCK_LOCAL_VARIABLE_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -1520,6 +1660,7 @@ typedef struct pm_block_local_variable_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BlockLocalVariableNode#name
      */
@@ -1529,7 +1670,12 @@ typedef struct pm_block_local_variable_node {
 /**
  * BlockNode
  *
- * Type: PM_BLOCK_NODE
+ * Represents a block of ruby code.
+ *
+ *     [1, 2, 3].each { |i| puts x }
+ *                    ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_BLOCK_NODE
  *
  * @extends pm_node_t
  */
@@ -1537,6 +1683,7 @@ typedef struct pm_block_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BlockNode#locals
      */
@@ -1566,9 +1713,16 @@ typedef struct pm_block_node {
 /**
  * BlockParameterNode
  *
- * Type: PM_BLOCK_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents a block parameter of a method, block, or lambda definition.
+ *
+ *     def a(&b)
+ *           ^^
+ *     end
+ *
+ * Type: ::PM_BLOCK_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -1576,6 +1730,7 @@ typedef struct pm_block_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BlockParameterNode#name
      */
@@ -1595,7 +1750,16 @@ typedef struct pm_block_parameter_node {
 /**
  * BlockParametersNode
  *
- * Type: PM_BLOCK_PARAMETERS_NODE
+ * Represents a block's parameters declaration.
+ *
+ *     -> (a, b = 1; local) { }
+ *        ^^^^^^^^^^^^^^^^^
+ *
+ *     foo do |a, b = 1; local|
+ *            ^^^^^^^^^^^^^^^^^
+ *     end
+ *
+ * Type: ::PM_BLOCK_PARAMETERS_NODE
  *
  * @extends pm_node_t
  */
@@ -1603,6 +1767,7 @@ typedef struct pm_block_parameters_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BlockParametersNode#parameters
      */
@@ -1627,7 +1792,12 @@ typedef struct pm_block_parameters_node {
 /**
  * BreakNode
  *
- * Type: PM_BREAK_NODE
+ * Represents the use of the `break` keyword.
+ *
+ *     break foo
+ *     ^^^^^^^^^
+ *
+ * Type: ::PM_BREAK_NODE
  *
  * @extends pm_node_t
  */
@@ -1635,6 +1805,7 @@ typedef struct pm_break_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * BreakNode#arguments
      *
@@ -1659,12 +1830,18 @@ typedef struct pm_break_node {
 /**
  * CallAndWriteNode
  *
- * Type: PM_CALL_AND_WRITE_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents the use of the `&&=` operator on a call.
+ *
+ *     foo.bar &&= value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CALL_AND_WRITE_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -1672,6 +1849,7 @@ typedef struct pm_call_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CallAndWriteNode#receiver
      */
@@ -1711,12 +1889,33 @@ typedef struct pm_call_and_write_node {
 /**
  * CallNode
  *
- * Type: PM_CALL_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents a method call, in all of the various forms that can take.
+ *
+ *     foo
+ *     ^^^
+ *
+ *     foo()
+ *     ^^^^^
+ *
+ *     +foo
+ *     ^^^^
+ *
+ *     foo + bar
+ *     ^^^^^^^^^
+ *
+ *     foo.bar
+ *     ^^^^^^^
+ *
+ *     foo&.bar
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_CALL_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -1724,6 +1923,7 @@ typedef struct pm_call_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CallNode#receiver
      *
@@ -1779,12 +1979,18 @@ typedef struct pm_call_node {
 /**
  * CallOperatorWriteNode
  *
- * Type: PM_CALL_OPERATOR_WRITE_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents the use of an assignment operator on a call.
+ *
+ *     foo.bar += baz
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CALL_OPERATOR_WRITE_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -1792,6 +1998,7 @@ typedef struct pm_call_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CallOperatorWriteNode#receiver
      */
@@ -1836,12 +2043,18 @@ typedef struct pm_call_operator_write_node {
 /**
  * CallOrWriteNode
  *
- * Type: PM_CALL_OR_WRITE_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents the use of the `||=` operator on a call.
+ *
+ *     foo.bar ||= value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CALL_OR_WRITE_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -1849,6 +2062,7 @@ typedef struct pm_call_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CallOrWriteNode#receiver
      */
@@ -1888,12 +2102,26 @@ typedef struct pm_call_or_write_node {
 /**
  * CallTargetNode
  *
- * Type: PM_CALL_TARGET_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents assigning to a method call.
+ *
+ *     foo.bar, = 1
+ *     ^^^^^^^
+ *
+ *     begin
+ *     rescue => foo.bar
+ *               ^^^^^^^
+ *     end
+ *
+ *     for foo.bar in baz do end
+ *         ^^^^^^^
+ *
+ * Type: ::PM_CALL_TARGET_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -1901,6 +2129,7 @@ typedef struct pm_call_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CallTargetNode#receiver
      */
@@ -1925,7 +2154,12 @@ typedef struct pm_call_target_node {
 /**
  * CapturePatternNode
  *
- * Type: PM_CAPTURE_PATTERN_NODE
+ * Represents assigning to a local variable in pattern matching.
+ *
+ *     foo => [bar => baz]
+ *            ^^^^^^^^^^^^
+ *
+ * Type: ::PM_CAPTURE_PATTERN_NODE
  *
  * @extends pm_node_t
  */
@@ -1933,6 +2167,7 @@ typedef struct pm_capture_pattern_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CapturePatternNode#value
      */
@@ -1941,7 +2176,7 @@ typedef struct pm_capture_pattern_node {
     /**
      * CapturePatternNode#target
      */
-    struct pm_node *target;
+    struct pm_local_variable_target_node *target;
 
     /**
      * CapturePatternNode#operator_loc
@@ -1952,7 +2187,14 @@ typedef struct pm_capture_pattern_node {
 /**
  * CaseMatchNode
  *
- * Type: PM_CASE_MATCH_NODE
+ * Represents the use of a case statement for pattern matching.
+ *
+ *     case true
+ *     in false
+ *     end
+ *     ^^^^^^^^^
+ *
+ * Type: ::PM_CASE_MATCH_NODE
  *
  * @extends pm_node_t
  */
@@ -1960,6 +2202,7 @@ typedef struct pm_case_match_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CaseMatchNode#predicate
      */
@@ -1971,9 +2214,9 @@ typedef struct pm_case_match_node {
     struct pm_node_list conditions;
 
     /**
-     * CaseMatchNode#consequent
+     * CaseMatchNode#else_clause
      */
-    struct pm_else_node *consequent;
+    struct pm_else_node *else_clause;
 
     /**
      * CaseMatchNode#case_keyword_loc
@@ -1989,7 +2232,14 @@ typedef struct pm_case_match_node {
 /**
  * CaseNode
  *
- * Type: PM_CASE_NODE
+ * Represents the use of a case statement.
+ *
+ *     case true
+ *     when false
+ *     end
+ *     ^^^^^^^^^^
+ *
+ * Type: ::PM_CASE_NODE
  *
  * @extends pm_node_t
  */
@@ -1997,6 +2247,7 @@ typedef struct pm_case_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * CaseNode#predicate
      */
@@ -2008,9 +2259,9 @@ typedef struct pm_case_node {
     struct pm_node_list conditions;
 
     /**
-     * CaseNode#consequent
+     * CaseNode#else_clause
      */
-    struct pm_else_node *consequent;
+    struct pm_else_node *else_clause;
 
     /**
      * CaseNode#case_keyword_loc
@@ -2026,7 +2277,12 @@ typedef struct pm_case_node {
 /**
  * ClassNode
  *
- * Type: PM_CLASS_NODE
+ * Represents a class declaration involving the `class` keyword.
+ *
+ *     class Foo end
+ *     ^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CLASS_NODE
  *
  * @extends pm_node_t
  */
@@ -2034,6 +2290,7 @@ typedef struct pm_class_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassNode#locals
      */
@@ -2078,7 +2335,12 @@ typedef struct pm_class_node {
 /**
  * ClassVariableAndWriteNode
  *
- * Type: PM_CLASS_VARIABLE_AND_WRITE_NODE
+ * Represents the use of the `&&=` operator for assignment to a class variable.
+ *
+ *     @@target &&= value
+ *     ^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CLASS_VARIABLE_AND_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2086,6 +2348,7 @@ typedef struct pm_class_variable_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassVariableAndWriteNode#name
      */
@@ -2110,7 +2373,12 @@ typedef struct pm_class_variable_and_write_node {
 /**
  * ClassVariableOperatorWriteNode
  *
- * Type: PM_CLASS_VARIABLE_OPERATOR_WRITE_NODE
+ * Represents assigning to a class variable using an operator that isn't `=`.
+ *
+ *     @@target += value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CLASS_VARIABLE_OPERATOR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2118,6 +2386,7 @@ typedef struct pm_class_variable_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassVariableOperatorWriteNode#name
      */
@@ -2147,7 +2416,12 @@ typedef struct pm_class_variable_operator_write_node {
 /**
  * ClassVariableOrWriteNode
  *
- * Type: PM_CLASS_VARIABLE_OR_WRITE_NODE
+ * Represents the use of the `||=` operator for assignment to a class variable.
+ *
+ *     @@target ||= value
+ *     ^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CLASS_VARIABLE_OR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2155,6 +2429,7 @@ typedef struct pm_class_variable_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassVariableOrWriteNode#name
      */
@@ -2179,7 +2454,12 @@ typedef struct pm_class_variable_or_write_node {
 /**
  * ClassVariableReadNode
  *
- * Type: PM_CLASS_VARIABLE_READ_NODE
+ * Represents referencing a class variable.
+ *
+ *     @@foo
+ *     ^^^^^
+ *
+ * Type: ::PM_CLASS_VARIABLE_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -2187,6 +2467,7 @@ typedef struct pm_class_variable_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassVariableReadNode#name
      *
@@ -2202,7 +2483,12 @@ typedef struct pm_class_variable_read_node {
 /**
  * ClassVariableTargetNode
  *
- * Type: PM_CLASS_VARIABLE_TARGET_NODE
+ * Represents writing to a class variable in a context that doesn't have an explicit value.
+ *
+ *     @@foo, @@bar = baz
+ *     ^^^^^  ^^^^^
+ *
+ * Type: ::PM_CLASS_VARIABLE_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -2210,6 +2496,7 @@ typedef struct pm_class_variable_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassVariableTargetNode#name
      */
@@ -2219,7 +2506,12 @@ typedef struct pm_class_variable_target_node {
 /**
  * ClassVariableWriteNode
  *
- * Type: PM_CLASS_VARIABLE_WRITE_NODE
+ * Represents writing to a class variable.
+ *
+ *     @@foo = 1
+ *     ^^^^^^^^^
+ *
+ * Type: ::PM_CLASS_VARIABLE_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2227,6 +2519,7 @@ typedef struct pm_class_variable_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ClassVariableWriteNode#name
      *
@@ -2275,7 +2568,12 @@ typedef struct pm_class_variable_write_node {
 /**
  * ConstantAndWriteNode
  *
- * Type: PM_CONSTANT_AND_WRITE_NODE
+ * Represents the use of the `&&=` operator for assignment to a constant.
+ *
+ *     Target &&= value
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_AND_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2283,6 +2581,7 @@ typedef struct pm_constant_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantAndWriteNode#name
      */
@@ -2307,7 +2606,12 @@ typedef struct pm_constant_and_write_node {
 /**
  * ConstantOperatorWriteNode
  *
- * Type: PM_CONSTANT_OPERATOR_WRITE_NODE
+ * Represents assigning to a constant using an operator that isn't `=`.
+ *
+ *     Target += value
+ *     ^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_OPERATOR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2315,6 +2619,7 @@ typedef struct pm_constant_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantOperatorWriteNode#name
      */
@@ -2344,7 +2649,12 @@ typedef struct pm_constant_operator_write_node {
 /**
  * ConstantOrWriteNode
  *
- * Type: PM_CONSTANT_OR_WRITE_NODE
+ * Represents the use of the `||=` operator for assignment to a constant.
+ *
+ *     Target ||= value
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_OR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2352,6 +2662,7 @@ typedef struct pm_constant_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantOrWriteNode#name
      */
@@ -2376,7 +2687,12 @@ typedef struct pm_constant_or_write_node {
 /**
  * ConstantPathAndWriteNode
  *
- * Type: PM_CONSTANT_PATH_AND_WRITE_NODE
+ * Represents the use of the `&&=` operator for assignment to a constant path.
+ *
+ *     Parent::Child &&= value
+ *     ^^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_PATH_AND_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2384,6 +2700,7 @@ typedef struct pm_constant_path_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantPathAndWriteNode#target
      */
@@ -2403,7 +2720,12 @@ typedef struct pm_constant_path_and_write_node {
 /**
  * ConstantPathNode
  *
- * Type: PM_CONSTANT_PATH_NODE
+ * Represents accessing a constant through a path of `::` operators.
+ *
+ *     Foo::Bar
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_PATH_NODE
  *
  * @extends pm_node_t
  */
@@ -2411,6 +2733,7 @@ typedef struct pm_constant_path_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantPathNode#parent
      *
@@ -2464,7 +2787,12 @@ typedef struct pm_constant_path_node {
 /**
  * ConstantPathOperatorWriteNode
  *
- * Type: PM_CONSTANT_PATH_OPERATOR_WRITE_NODE
+ * Represents assigning to a constant path using an operator that isn't `=`.
+ *
+ *     Parent::Child += value
+ *     ^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_PATH_OPERATOR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2472,6 +2800,7 @@ typedef struct pm_constant_path_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantPathOperatorWriteNode#target
      */
@@ -2496,7 +2825,12 @@ typedef struct pm_constant_path_operator_write_node {
 /**
  * ConstantPathOrWriteNode
  *
- * Type: PM_CONSTANT_PATH_OR_WRITE_NODE
+ * Represents the use of the `||=` operator for assignment to a constant path.
+ *
+ *     Parent::Child ||= value
+ *     ^^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_PATH_OR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2504,6 +2838,7 @@ typedef struct pm_constant_path_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantPathOrWriteNode#target
      */
@@ -2523,7 +2858,12 @@ typedef struct pm_constant_path_or_write_node {
 /**
  * ConstantPathTargetNode
  *
- * Type: PM_CONSTANT_PATH_TARGET_NODE
+ * Represents writing to a constant path in a context that doesn't have an explicit value.
+ *
+ *     Foo::Foo, Bar::Bar = baz
+ *     ^^^^^^^^  ^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_PATH_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -2531,6 +2871,7 @@ typedef struct pm_constant_path_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantPathTargetNode#parent
      */
@@ -2555,7 +2896,18 @@ typedef struct pm_constant_path_target_node {
 /**
  * ConstantPathWriteNode
  *
- * Type: PM_CONSTANT_PATH_WRITE_NODE
+ * Represents writing to a constant path.
+ *
+ *     ::Foo = 1
+ *     ^^^^^^^^^
+ *
+ *     Foo::Bar = 1
+ *     ^^^^^^^^^^^^
+ *
+ *     ::Foo::Bar = 1
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_PATH_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2563,6 +2915,7 @@ typedef struct pm_constant_path_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantPathWriteNode#target
      *
@@ -2600,7 +2953,12 @@ typedef struct pm_constant_path_write_node {
 /**
  * ConstantReadNode
  *
- * Type: PM_CONSTANT_READ_NODE
+ * Represents referencing a constant.
+ *
+ *     Foo
+ *     ^^^
+ *
+ * Type: ::PM_CONSTANT_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -2608,6 +2966,7 @@ typedef struct pm_constant_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantReadNode#name
      *
@@ -2623,7 +2982,12 @@ typedef struct pm_constant_read_node {
 /**
  * ConstantTargetNode
  *
- * Type: PM_CONSTANT_TARGET_NODE
+ * Represents writing to a constant in a context that doesn't have an explicit value.
+ *
+ *     Foo, Bar = baz
+ *     ^^^  ^^^
+ *
+ * Type: ::PM_CONSTANT_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -2631,6 +2995,7 @@ typedef struct pm_constant_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantTargetNode#name
      */
@@ -2640,7 +3005,12 @@ typedef struct pm_constant_target_node {
 /**
  * ConstantWriteNode
  *
- * Type: PM_CONSTANT_WRITE_NODE
+ * Represents writing to a constant.
+ *
+ *     Foo = 1
+ *     ^^^^^^^
+ *
+ * Type: ::PM_CONSTANT_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -2648,6 +3018,7 @@ typedef struct pm_constant_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ConstantWriteNode#name
      *
@@ -2696,7 +3067,13 @@ typedef struct pm_constant_write_node {
 /**
  * DefNode
  *
- * Type: PM_DEF_NODE
+ * Represents a method definition.
+ *
+ *     def method
+ *     end
+ *     ^^^^^^^^^^
+ *
+ * Type: ::PM_DEF_NODE
  *
  * @extends pm_node_t
  */
@@ -2704,6 +3081,7 @@ typedef struct pm_def_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * DefNode#name
      */
@@ -2768,7 +3146,12 @@ typedef struct pm_def_node {
 /**
  * DefinedNode
  *
- * Type: PM_DEFINED_NODE
+ * Represents the use of the `defined?` keyword.
+ *
+ *     defined?(a)
+ *     ^^^^^^^^^^^
+ *
+ * Type: ::PM_DEFINED_NODE
  *
  * @extends pm_node_t
  */
@@ -2776,6 +3159,7 @@ typedef struct pm_defined_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * DefinedNode#lparen_loc
      */
@@ -2800,7 +3184,12 @@ typedef struct pm_defined_node {
 /**
  * ElseNode
  *
- * Type: PM_ELSE_NODE
+ * Represents an `else` clause in a `case`, `if`, or `unless` statement.
+ *
+ *     if a then b else c end
+ *                 ^^^^^^^^^^
+ *
+ * Type: ::PM_ELSE_NODE
  *
  * @extends pm_node_t
  */
@@ -2808,6 +3197,7 @@ typedef struct pm_else_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ElseNode#else_keyword_loc
      */
@@ -2827,7 +3217,12 @@ typedef struct pm_else_node {
 /**
  * EmbeddedStatementsNode
  *
- * Type: PM_EMBEDDED_STATEMENTS_NODE
+ * Represents an interpolated set of statements.
+ *
+ *     "foo #{bar}"
+ *          ^^^^^^
+ *
+ * Type: ::PM_EMBEDDED_STATEMENTS_NODE
  *
  * @extends pm_node_t
  */
@@ -2835,6 +3230,7 @@ typedef struct pm_embedded_statements_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * EmbeddedStatementsNode#opening_loc
      */
@@ -2854,7 +3250,12 @@ typedef struct pm_embedded_statements_node {
 /**
  * EmbeddedVariableNode
  *
- * Type: PM_EMBEDDED_VARIABLE_NODE
+ * Represents an interpolated variable.
+ *
+ *     "foo #@bar"
+ *          ^^^^^
+ *
+ * Type: ::PM_EMBEDDED_VARIABLE_NODE
  *
  * @extends pm_node_t
  */
@@ -2862,6 +3263,7 @@ typedef struct pm_embedded_variable_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * EmbeddedVariableNode#operator_loc
      */
@@ -2876,7 +3278,16 @@ typedef struct pm_embedded_variable_node {
 /**
  * EnsureNode
  *
- * Type: PM_ENSURE_NODE
+ * Represents an `ensure` clause in a `begin` statement.
+ *
+ *     begin
+ *       foo
+ *     ensure
+ *     ^^^^^^
+ *       bar
+ *     end
+ *
+ * Type: ::PM_ENSURE_NODE
  *
  * @extends pm_node_t
  */
@@ -2884,6 +3295,7 @@ typedef struct pm_ensure_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * EnsureNode#ensure_keyword_loc
      */
@@ -2903,19 +3315,36 @@ typedef struct pm_ensure_node {
 /**
  * FalseNode
  *
- * Type: PM_FALSE_NODE
+ * Represents the use of the literal `false` keyword.
+ *
+ *     false
+ *     ^^^^^
+ *
+ * Type: ::PM_FALSE_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_false_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_false_node_t;
 
 /**
  * FindPatternNode
  *
- * Type: PM_FIND_PATTERN_NODE
+ * Represents a find pattern in pattern matching.
+ *
+ *     foo in *bar, baz, *qux
+ *            ^^^^^^^^^^^^^^^
+ *
+ *     foo in [*bar, baz, *qux]
+ *            ^^^^^^^^^^^^^^^^^
+ *
+ *     foo in Foo(*bar, baz, *qux)
+ *            ^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_FIND_PATTERN_NODE
  *
  * @extends pm_node_t
  */
@@ -2923,6 +3352,7 @@ typedef struct pm_find_pattern_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * FindPatternNode#constant
      */
@@ -2931,7 +3361,7 @@ typedef struct pm_find_pattern_node {
     /**
      * FindPatternNode#left
      */
-    struct pm_node *left;
+    struct pm_splat_node *left;
 
     /**
      * FindPatternNode#requireds
@@ -2957,9 +3387,15 @@ typedef struct pm_find_pattern_node {
 /**
  * FlipFlopNode
  *
- * Type: PM_FLIP_FLOP_NODE
- * Flags:
- *    PM_RANGE_FLAGS_EXCLUDE_END
+ * Represents the use of the `..` or `...` operators to create flip flops.
+ *
+ *     baz if foo .. bar
+ *            ^^^^^^^^^^
+ *
+ * Type: ::PM_FLIP_FLOP_NODE
+
+ * Flags (#pm_range_flags):
+ * * ::PM_RANGE_FLAGS_EXCLUDE_END
  *
  * @extends pm_node_t
  */
@@ -2967,6 +3403,7 @@ typedef struct pm_flip_flop_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * FlipFlopNode#left
      */
@@ -2986,7 +3423,12 @@ typedef struct pm_flip_flop_node {
 /**
  * FloatNode
  *
- * Type: PM_FLOAT_NODE
+ * Represents a floating point number literal.
+ *
+ *     1.0
+ *     ^^^
+ *
+ * Type: ::PM_FLOAT_NODE
  *
  * @extends pm_node_t
  */
@@ -2994,6 +3436,7 @@ typedef struct pm_float_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * FloatNode#value
      *
@@ -3005,7 +3448,12 @@ typedef struct pm_float_node {
 /**
  * ForNode
  *
- * Type: PM_FOR_NODE
+ * Represents the use of the `for` keyword.
+ *
+ *     for i in a end
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_FOR_NODE
  *
  * @extends pm_node_t
  */
@@ -3013,38 +3461,76 @@ typedef struct pm_for_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ForNode#index
+     *
+     * The index expression for `for` loops.
+     *
+     *     for i in a end
+     *         ^
      */
     struct pm_node *index;
 
     /**
      * ForNode#collection
+     *
+     * The collection to iterate over.
+     *
+     *     for i in a end
+     *              ^
      */
     struct pm_node *collection;
 
     /**
      * ForNode#statements
+     *
+     * Represents the body of statements to execute for each iteration of the loop.
+     *
+     *     for i in a
+     *       foo(i)
+     *       ^^^^^^
+     *     end
      */
     struct pm_statements_node *statements;
 
     /**
      * ForNode#for_keyword_loc
+     *
+     * The location of the `for` keyword.
+     *
+     *     for i in a end
+     *     ^^^
      */
     pm_location_t for_keyword_loc;
 
     /**
      * ForNode#in_keyword_loc
+     *
+     * The location of the `in` keyword.
+     *
+     *     for i in a end
+     *           ^^
      */
     pm_location_t in_keyword_loc;
 
     /**
      * ForNode#do_keyword_loc
+     *
+     * The location of the `do` keyword, if present.
+     *
+     *     for i in a do end
+     *                ^^
      */
     pm_location_t do_keyword_loc;
 
     /**
      * ForNode#end_keyword_loc
+     *
+     * The location of the `end` keyword.
+     *
+     *     for i in a end
+     *                ^^^
      */
     pm_location_t end_keyword_loc;
 } pm_for_node_t;
@@ -3052,31 +3538,51 @@ typedef struct pm_for_node {
 /**
  * ForwardingArgumentsNode
  *
- * Type: PM_FORWARDING_ARGUMENTS_NODE
+ * Represents forwarding all arguments to this method to another method.
+ *
+ *     def foo(...)
+ *       bar(...)
+ *           ^^^
+ *     end
+ *
+ * Type: ::PM_FORWARDING_ARGUMENTS_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_forwarding_arguments_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_forwarding_arguments_node_t;
 
 /**
  * ForwardingParameterNode
  *
- * Type: PM_FORWARDING_PARAMETER_NODE
+ * Represents the use of the forwarding parameter in a method, block, or lambda declaration.
+ *
+ *     def foo(...)
+ *             ^^^
+ *     end
+ *
+ * Type: ::PM_FORWARDING_PARAMETER_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_forwarding_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_forwarding_parameter_node_t;
 
 /**
  * ForwardingSuperNode
  *
- * Type: PM_FORWARDING_SUPER_NODE
+ * Represents the use of the `super` keyword without parentheses or arguments.
+ *
+ *     super
+ *     ^^^^^
+ *
+ * Type: ::PM_FORWARDING_SUPER_NODE
  *
  * @extends pm_node_t
  */
@@ -3084,6 +3590,7 @@ typedef struct pm_forwarding_super_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ForwardingSuperNode#block
      */
@@ -3093,7 +3600,12 @@ typedef struct pm_forwarding_super_node {
 /**
  * GlobalVariableAndWriteNode
  *
- * Type: PM_GLOBAL_VARIABLE_AND_WRITE_NODE
+ * Represents the use of the `&&=` operator for assignment to a global variable.
+ *
+ *     $target &&= value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_GLOBAL_VARIABLE_AND_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3101,6 +3613,7 @@ typedef struct pm_global_variable_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * GlobalVariableAndWriteNode#name
      */
@@ -3125,7 +3638,12 @@ typedef struct pm_global_variable_and_write_node {
 /**
  * GlobalVariableOperatorWriteNode
  *
- * Type: PM_GLOBAL_VARIABLE_OPERATOR_WRITE_NODE
+ * Represents assigning to a global variable using an operator that isn't `=`.
+ *
+ *     $target += value
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_GLOBAL_VARIABLE_OPERATOR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3133,6 +3651,7 @@ typedef struct pm_global_variable_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * GlobalVariableOperatorWriteNode#name
      */
@@ -3162,7 +3681,12 @@ typedef struct pm_global_variable_operator_write_node {
 /**
  * GlobalVariableOrWriteNode
  *
- * Type: PM_GLOBAL_VARIABLE_OR_WRITE_NODE
+ * Represents the use of the `||=` operator for assignment to a global variable.
+ *
+ *     $target ||= value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_GLOBAL_VARIABLE_OR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3170,6 +3694,7 @@ typedef struct pm_global_variable_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * GlobalVariableOrWriteNode#name
      */
@@ -3194,7 +3719,12 @@ typedef struct pm_global_variable_or_write_node {
 /**
  * GlobalVariableReadNode
  *
- * Type: PM_GLOBAL_VARIABLE_READ_NODE
+ * Represents referencing a global variable.
+ *
+ *     $foo
+ *     ^^^^
+ *
+ * Type: ::PM_GLOBAL_VARIABLE_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -3202,6 +3732,7 @@ typedef struct pm_global_variable_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * GlobalVariableReadNode#name
      *
@@ -3217,7 +3748,12 @@ typedef struct pm_global_variable_read_node {
 /**
  * GlobalVariableTargetNode
  *
- * Type: PM_GLOBAL_VARIABLE_TARGET_NODE
+ * Represents writing to a global variable in a context that doesn't have an explicit value.
+ *
+ *     $foo, $bar = baz
+ *     ^^^^  ^^^^
+ *
+ * Type: ::PM_GLOBAL_VARIABLE_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -3225,6 +3761,7 @@ typedef struct pm_global_variable_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * GlobalVariableTargetNode#name
      */
@@ -3234,7 +3771,12 @@ typedef struct pm_global_variable_target_node {
 /**
  * GlobalVariableWriteNode
  *
- * Type: PM_GLOBAL_VARIABLE_WRITE_NODE
+ * Represents writing to a global variable.
+ *
+ *     $foo = 1
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_GLOBAL_VARIABLE_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3242,6 +3784,7 @@ typedef struct pm_global_variable_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * GlobalVariableWriteNode#name
      *
@@ -3290,7 +3833,12 @@ typedef struct pm_global_variable_write_node {
 /**
  * HashNode
  *
- * Type: PM_HASH_NODE
+ * Represents a hash literal.
+ *
+ *     { a => b }
+ *     ^^^^^^^^^^
+ *
+ * Type: ::PM_HASH_NODE
  *
  * @extends pm_node_t
  */
@@ -3298,6 +3846,7 @@ typedef struct pm_hash_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * HashNode#opening_loc
      *
@@ -3335,7 +3884,15 @@ typedef struct pm_hash_node {
 /**
  * HashPatternNode
  *
- * Type: PM_HASH_PATTERN_NODE
+ * Represents a hash pattern in pattern matching.
+ *
+ *     foo => { a: 1, b: 2 }
+ *            ^^^^^^^^^^^^^^
+ *
+ *     foo => { a: 1, b: 2, **c }
+ *            ^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_HASH_PATTERN_NODE
  *
  * @extends pm_node_t
  */
@@ -3343,6 +3900,7 @@ typedef struct pm_hash_pattern_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * HashPatternNode#constant
      */
@@ -3372,7 +3930,18 @@ typedef struct pm_hash_pattern_node {
 /**
  * IfNode
  *
- * Type: PM_IF_NODE
+ * Represents the use of the `if` keyword, either in the block form or the modifier form, or a ternary expression.
+ *
+ *     bar if foo
+ *     ^^^^^^^^^^
+ *
+ *     if foo then bar end
+ *     ^^^^^^^^^^^^^^^^^^^
+ *
+ *     foo ? bar : baz
+ *     ^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_IF_NODE
  *
  * @extends pm_node_t
  */
@@ -3380,6 +3949,7 @@ typedef struct pm_if_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * IfNode#if_keyword_loc
      *
@@ -3438,7 +4008,7 @@ typedef struct pm_if_node {
     struct pm_statements_node *statements;
 
     /**
-     * IfNode#consequent
+     * IfNode#subsequent
      *
      * Represents an `ElseNode` or an `IfNode` when there is an `else` or an `elsif` in the `if` statement.
      *
@@ -3454,7 +4024,7 @@ typedef struct pm_if_node {
      *     if foo then bar else baz end
      *                     ^^^^^^^^^^^^
      */
-    struct pm_node *consequent;
+    struct pm_node *subsequent;
 
     /**
      * IfNode#end_keyword_loc
@@ -3472,7 +4042,12 @@ typedef struct pm_if_node {
 /**
  * ImaginaryNode
  *
- * Type: PM_IMAGINARY_NODE
+ * Represents an imaginary number literal.
+ *
+ *     1.0i
+ *     ^^^^
+ *
+ * Type: ::PM_IMAGINARY_NODE
  *
  * @extends pm_node_t
  */
@@ -3480,6 +4055,7 @@ typedef struct pm_imaginary_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ImaginaryNode#numeric
      */
@@ -3489,7 +4065,18 @@ typedef struct pm_imaginary_node {
 /**
  * ImplicitNode
  *
- * Type: PM_IMPLICIT_NODE
+ * Represents a node that is implicitly being added to the tree but doesn't correspond directly to a node in the source.
+ *
+ *     { foo: }
+ *       ^^^^
+ *
+ *     { Foo: }
+ *       ^^^^
+ *
+ *     foo in { bar: }
+ *              ^^^^
+ *
+ * Type: ::PM_IMPLICIT_NODE
  *
  * @extends pm_node_t
  */
@@ -3497,6 +4084,7 @@ typedef struct pm_implicit_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ImplicitNode#value
      */
@@ -3506,19 +4094,39 @@ typedef struct pm_implicit_node {
 /**
  * ImplicitRestNode
  *
- * Type: PM_IMPLICIT_REST_NODE
+ * Represents using a trailing comma to indicate an implicit rest parameter.
+ *
+ *     foo { |bar,| }
+ *               ^
+ *
+ *     foo in [bar,]
+ *                ^
+ *
+ *     for foo, in bar do end
+ *            ^
+ *
+ *     foo, = bar
+ *        ^
+ *
+ * Type: ::PM_IMPLICIT_REST_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_implicit_rest_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_implicit_rest_node_t;
 
 /**
  * InNode
  *
- * Type: PM_IN_NODE
+ * Represents the use of the `in` keyword in a case statement.
+ *
+ *     case a; in b then c end
+ *             ^^^^^^^^^^^
+ *
+ * Type: ::PM_IN_NODE
  *
  * @extends pm_node_t
  */
@@ -3526,6 +4134,7 @@ typedef struct pm_in_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InNode#pattern
      */
@@ -3550,12 +4159,18 @@ typedef struct pm_in_node {
 /**
  * IndexAndWriteNode
  *
- * Type: PM_INDEX_AND_WRITE_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents the use of the `&&=` operator on a call to the `[]` method.
+ *
+ *     foo.bar[baz] &&= value
+ *     ^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INDEX_AND_WRITE_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -3563,6 +4178,7 @@ typedef struct pm_index_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * IndexAndWriteNode#receiver
      */
@@ -3591,7 +4207,7 @@ typedef struct pm_index_and_write_node {
     /**
      * IndexAndWriteNode#block
      */
-    struct pm_node *block;
+    struct pm_block_argument_node *block;
 
     /**
      * IndexAndWriteNode#operator_loc
@@ -3607,12 +4223,18 @@ typedef struct pm_index_and_write_node {
 /**
  * IndexOperatorWriteNode
  *
- * Type: PM_INDEX_OPERATOR_WRITE_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents the use of an assignment operator on a call to `[]`.
+ *
+ *     foo.bar[baz] += value
+ *     ^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INDEX_OPERATOR_WRITE_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -3620,6 +4242,7 @@ typedef struct pm_index_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * IndexOperatorWriteNode#receiver
      */
@@ -3648,7 +4271,7 @@ typedef struct pm_index_operator_write_node {
     /**
      * IndexOperatorWriteNode#block
      */
-    struct pm_node *block;
+    struct pm_block_argument_node *block;
 
     /**
      * IndexOperatorWriteNode#binary_operator
@@ -3669,12 +4292,18 @@ typedef struct pm_index_operator_write_node {
 /**
  * IndexOrWriteNode
  *
- * Type: PM_INDEX_OR_WRITE_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents the use of the `||=` operator on a call to `[]`.
+ *
+ *     foo.bar[baz] ||= value
+ *     ^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INDEX_OR_WRITE_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -3682,6 +4311,7 @@ typedef struct pm_index_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * IndexOrWriteNode#receiver
      */
@@ -3710,7 +4340,7 @@ typedef struct pm_index_or_write_node {
     /**
      * IndexOrWriteNode#block
      */
-    struct pm_node *block;
+    struct pm_block_argument_node *block;
 
     /**
      * IndexOrWriteNode#operator_loc
@@ -3726,12 +4356,26 @@ typedef struct pm_index_or_write_node {
 /**
  * IndexTargetNode
  *
- * Type: PM_INDEX_TARGET_NODE
- * Flags:
- *    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
- *    PM_CALL_NODE_FLAGS_VARIABLE_CALL
- *    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
- *    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
+ * Represents assigning to an index.
+ *
+ *     foo[bar], = 1
+ *     ^^^^^^^^
+ *
+ *     begin
+ *     rescue => foo[bar]
+ *               ^^^^^^^^
+ *     end
+ *
+ *     for foo[bar] in baz do end
+ *         ^^^^^^^^
+ *
+ * Type: ::PM_INDEX_TARGET_NODE
+
+ * Flags (#pm_call_node_flags):
+ * * ::PM_CALL_NODE_FLAGS_SAFE_NAVIGATION
+ * * ::PM_CALL_NODE_FLAGS_VARIABLE_CALL
+ * * ::PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE
+ * * ::PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY
  *
  * @extends pm_node_t
  */
@@ -3739,6 +4383,7 @@ typedef struct pm_index_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * IndexTargetNode#receiver
      */
@@ -3762,13 +4407,18 @@ typedef struct pm_index_target_node {
     /**
      * IndexTargetNode#block
      */
-    struct pm_node *block;
+    struct pm_block_argument_node *block;
 } pm_index_target_node_t;
 
 /**
  * InstanceVariableAndWriteNode
  *
- * Type: PM_INSTANCE_VARIABLE_AND_WRITE_NODE
+ * Represents the use of the `&&=` operator for assignment to an instance variable.
+ *
+ *     @target &&= value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INSTANCE_VARIABLE_AND_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3776,6 +4426,7 @@ typedef struct pm_instance_variable_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InstanceVariableAndWriteNode#name
      */
@@ -3800,7 +4451,12 @@ typedef struct pm_instance_variable_and_write_node {
 /**
  * InstanceVariableOperatorWriteNode
  *
- * Type: PM_INSTANCE_VARIABLE_OPERATOR_WRITE_NODE
+ * Represents assigning to an instance variable using an operator that isn't `=`.
+ *
+ *     @target += value
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INSTANCE_VARIABLE_OPERATOR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3808,6 +4464,7 @@ typedef struct pm_instance_variable_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InstanceVariableOperatorWriteNode#name
      */
@@ -3837,7 +4494,12 @@ typedef struct pm_instance_variable_operator_write_node {
 /**
  * InstanceVariableOrWriteNode
  *
- * Type: PM_INSTANCE_VARIABLE_OR_WRITE_NODE
+ * Represents the use of the `||=` operator for assignment to an instance variable.
+ *
+ *     @target ||= value
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INSTANCE_VARIABLE_OR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3845,6 +4507,7 @@ typedef struct pm_instance_variable_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InstanceVariableOrWriteNode#name
      */
@@ -3869,7 +4532,12 @@ typedef struct pm_instance_variable_or_write_node {
 /**
  * InstanceVariableReadNode
  *
- * Type: PM_INSTANCE_VARIABLE_READ_NODE
+ * Represents referencing an instance variable.
+ *
+ *     @foo
+ *     ^^^^
+ *
+ * Type: ::PM_INSTANCE_VARIABLE_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -3877,6 +4545,7 @@ typedef struct pm_instance_variable_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InstanceVariableReadNode#name
      *
@@ -3892,7 +4561,12 @@ typedef struct pm_instance_variable_read_node {
 /**
  * InstanceVariableTargetNode
  *
- * Type: PM_INSTANCE_VARIABLE_TARGET_NODE
+ * Represents writing to an instance variable in a context that doesn't have an explicit value.
+ *
+ *     @foo, @bar = baz
+ *     ^^^^  ^^^^
+ *
+ * Type: ::PM_INSTANCE_VARIABLE_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -3900,6 +4574,7 @@ typedef struct pm_instance_variable_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InstanceVariableTargetNode#name
      */
@@ -3909,7 +4584,12 @@ typedef struct pm_instance_variable_target_node {
 /**
  * InstanceVariableWriteNode
  *
- * Type: PM_INSTANCE_VARIABLE_WRITE_NODE
+ * Represents writing to an instance variable.
+ *
+ *     @foo = 1
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_INSTANCE_VARIABLE_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -3917,6 +4597,7 @@ typedef struct pm_instance_variable_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InstanceVariableWriteNode#name
      *
@@ -3965,12 +4646,18 @@ typedef struct pm_instance_variable_write_node {
 /**
  * IntegerNode
  *
- * Type: PM_INTEGER_NODE
- * Flags:
- *    PM_INTEGER_BASE_FLAGS_BINARY
- *    PM_INTEGER_BASE_FLAGS_DECIMAL
- *    PM_INTEGER_BASE_FLAGS_OCTAL
- *    PM_INTEGER_BASE_FLAGS_HEXADECIMAL
+ * Represents an integer number literal.
+ *
+ *     1
+ *     ^
+ *
+ * Type: ::PM_INTEGER_NODE
+
+ * Flags (#pm_integer_base_flags):
+ * * ::PM_INTEGER_BASE_FLAGS_BINARY
+ * * ::PM_INTEGER_BASE_FLAGS_DECIMAL
+ * * ::PM_INTEGER_BASE_FLAGS_OCTAL
+ * * ::PM_INTEGER_BASE_FLAGS_HEXADECIMAL
  *
  * @extends pm_node_t
  */
@@ -3978,6 +4665,7 @@ typedef struct pm_integer_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * IntegerNode#value
      *
@@ -3989,19 +4677,25 @@ typedef struct pm_integer_node {
 /**
  * InterpolatedMatchLastLineNode
  *
- * Type: PM_INTERPOLATED_MATCH_LAST_LINE_NODE
- * Flags:
- *    PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
- *    PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
- *    PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
- *    PM_REGULAR_EXPRESSION_FLAGS_ONCE
- *    PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
- *    PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
- *    PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
- *    PM_REGULAR_EXPRESSION_FLAGS_UTF_8
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
+ * Represents a regular expression literal that contains interpolation that is being used in the predicate of a conditional to implicitly match against the last line read by an IO object.
+ *
+ *     if /foo #{bar} baz/ then end
+ *        ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INTERPOLATED_MATCH_LAST_LINE_NODE
+
+ * Flags (#pm_regular_expression_flags):
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ONCE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_UTF_8
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
  *
  * @extends pm_node_t
  */
@@ -4009,6 +4703,7 @@ typedef struct pm_interpolated_match_last_line_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InterpolatedMatchLastLineNode#opening_loc
      */
@@ -4028,19 +4723,25 @@ typedef struct pm_interpolated_match_last_line_node {
 /**
  * InterpolatedRegularExpressionNode
  *
- * Type: PM_INTERPOLATED_REGULAR_EXPRESSION_NODE
- * Flags:
- *    PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
- *    PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
- *    PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
- *    PM_REGULAR_EXPRESSION_FLAGS_ONCE
- *    PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
- *    PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
- *    PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
- *    PM_REGULAR_EXPRESSION_FLAGS_UTF_8
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
+ * Represents a regular expression literal that contains interpolation.
+ *
+ *     /foo #{bar} baz/
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INTERPOLATED_REGULAR_EXPRESSION_NODE
+
+ * Flags (#pm_regular_expression_flags):
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ONCE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_UTF_8
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
  *
  * @extends pm_node_t
  */
@@ -4048,6 +4749,7 @@ typedef struct pm_interpolated_regular_expression_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InterpolatedRegularExpressionNode#opening_loc
      */
@@ -4067,10 +4769,16 @@ typedef struct pm_interpolated_regular_expression_node {
 /**
  * InterpolatedStringNode
  *
- * Type: PM_INTERPOLATED_STRING_NODE
- * Flags:
- *    PM_INTERPOLATED_STRING_NODE_FLAGS_FROZEN
- *    PM_INTERPOLATED_STRING_NODE_FLAGS_MUTABLE
+ * Represents a string literal that contains interpolation.
+ *
+ *     "foo #{bar} baz"
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INTERPOLATED_STRING_NODE
+
+ * Flags (#pm_interpolated_string_node_flags):
+ * * ::PM_INTERPOLATED_STRING_NODE_FLAGS_FROZEN
+ * * ::PM_INTERPOLATED_STRING_NODE_FLAGS_MUTABLE
  *
  * @extends pm_node_t
  */
@@ -4078,6 +4786,7 @@ typedef struct pm_interpolated_string_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InterpolatedStringNode#opening_loc
      */
@@ -4097,7 +4806,12 @@ typedef struct pm_interpolated_string_node {
 /**
  * InterpolatedSymbolNode
  *
- * Type: PM_INTERPOLATED_SYMBOL_NODE
+ * Represents a symbol literal that contains interpolation.
+ *
+ *     :"foo #{bar} baz"
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INTERPOLATED_SYMBOL_NODE
  *
  * @extends pm_node_t
  */
@@ -4105,6 +4819,7 @@ typedef struct pm_interpolated_symbol_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InterpolatedSymbolNode#opening_loc
      */
@@ -4124,7 +4839,12 @@ typedef struct pm_interpolated_symbol_node {
 /**
  * InterpolatedXStringNode
  *
- * Type: PM_INTERPOLATED_X_STRING_NODE
+ * Represents an xstring literal that contains interpolation.
+ *
+ *     `foo #{bar} baz`
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_INTERPOLATED_X_STRING_NODE
  *
  * @extends pm_node_t
  */
@@ -4132,6 +4852,7 @@ typedef struct pm_interpolated_x_string_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * InterpolatedXStringNode#opening_loc
      */
@@ -4148,24 +4869,54 @@ typedef struct pm_interpolated_x_string_node {
     pm_location_t closing_loc;
 } pm_interpolated_x_string_node_t;
 
+/**
+ * ItLocalVariableReadNode
+ *
+ * Represents reading from the implicit `it` local variable.
+ *
+ *     -> { it }
+ *          ^^
+ *
+ * Type: ::PM_IT_LOCAL_VARIABLE_READ_NODE
+ *
+ * @extends pm_node_t
+ */
+typedef struct pm_it_local_variable_read_node {
+    /** The embedded base node. */
+    pm_node_t base;
+
+} pm_it_local_variable_read_node_t;
+
 /**
  * ItParametersNode
  *
- * Type: PM_IT_PARAMETERS_NODE
+ * Represents an implicit set of parameters through the use of the `it` keyword within a block or lambda.
+ *
+ *     -> { it + it }
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_IT_PARAMETERS_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_it_parameters_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_it_parameters_node_t;
 
 /**
  * KeywordHashNode
  *
- * Type: PM_KEYWORD_HASH_NODE
- * Flags:
- *    PM_KEYWORD_HASH_NODE_FLAGS_SYMBOL_KEYS
+ * Represents a hash literal without opening and closing braces.
+ *
+ *     foo(a: b)
+ *         ^^^^
+ *
+ * Type: ::PM_KEYWORD_HASH_NODE
+
+ * Flags (#pm_keyword_hash_node_flags):
+ * * ::PM_KEYWORD_HASH_NODE_FLAGS_SYMBOL_KEYS
  *
  * @extends pm_node_t
  */
@@ -4173,6 +4924,7 @@ typedef struct pm_keyword_hash_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * KeywordHashNode#elements
      */
@@ -4182,9 +4934,16 @@ typedef struct pm_keyword_hash_node {
 /**
  * KeywordRestParameterNode
  *
- * Type: PM_KEYWORD_REST_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents a keyword rest parameter to a method, block, or lambda definition.
+ *
+ *     def a(**b)
+ *           ^^^
+ *     end
+ *
+ * Type: ::PM_KEYWORD_REST_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -4192,6 +4951,7 @@ typedef struct pm_keyword_rest_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * KeywordRestParameterNode#name
      */
@@ -4211,7 +4971,12 @@ typedef struct pm_keyword_rest_parameter_node {
 /**
  * LambdaNode
  *
- * Type: PM_LAMBDA_NODE
+ * Represents using a lambda literal (not the lambda method call).
+ *
+ *     ->(value) { value * 2 }
+ *     ^^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_LAMBDA_NODE
  *
  * @extends pm_node_t
  */
@@ -4219,6 +4984,7 @@ typedef struct pm_lambda_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LambdaNode#locals
      */
@@ -4253,7 +5019,12 @@ typedef struct pm_lambda_node {
 /**
  * LocalVariableAndWriteNode
  *
- * Type: PM_LOCAL_VARIABLE_AND_WRITE_NODE
+ * Represents the use of the `&&=` operator for assignment to a local variable.
+ *
+ *     target &&= value
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_LOCAL_VARIABLE_AND_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -4261,6 +5032,7 @@ typedef struct pm_local_variable_and_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LocalVariableAndWriteNode#name_loc
      */
@@ -4290,7 +5062,12 @@ typedef struct pm_local_variable_and_write_node {
 /**
  * LocalVariableOperatorWriteNode
  *
- * Type: PM_LOCAL_VARIABLE_OPERATOR_WRITE_NODE
+ * Represents assigning to a local variable using an operator that isn't `=`.
+ *
+ *     target += value
+ *     ^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_LOCAL_VARIABLE_OPERATOR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -4298,6 +5075,7 @@ typedef struct pm_local_variable_operator_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LocalVariableOperatorWriteNode#name_loc
      */
@@ -4332,7 +5110,12 @@ typedef struct pm_local_variable_operator_write_node {
 /**
  * LocalVariableOrWriteNode
  *
- * Type: PM_LOCAL_VARIABLE_OR_WRITE_NODE
+ * Represents the use of the `||=` operator for assignment to a local variable.
+ *
+ *     target ||= value
+ *     ^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_LOCAL_VARIABLE_OR_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -4340,6 +5123,7 @@ typedef struct pm_local_variable_or_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LocalVariableOrWriteNode#name_loc
      */
@@ -4369,7 +5153,12 @@ typedef struct pm_local_variable_or_write_node {
 /**
  * LocalVariableReadNode
  *
- * Type: PM_LOCAL_VARIABLE_READ_NODE
+ * Represents reading a local variable. Note that this requires that a local variable of the same name has already been written to in the same scope, otherwise it is parsed as a method call.
+ *
+ *     foo
+ *     ^^^
+ *
+ * Type: ::PM_LOCAL_VARIABLE_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -4377,6 +5166,7 @@ typedef struct pm_local_variable_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LocalVariableReadNode#name
      *
@@ -4389,10 +5179,6 @@ typedef struct pm_local_variable_read_node {
      * Note that this can also be an underscore followed by a number for the default block parameters.
      *
      *     _1     # name `:_1`
-     *
-     * Finally, for the default `it` block parameter, the name is `0it`. This is to distinguish it from an `it` local variable that is explicitly declared.
-     *
-     *     it     # name `:0it`
      */
     pm_constant_id_t name;
 
@@ -4413,7 +5199,12 @@ typedef struct pm_local_variable_read_node {
 /**
  * LocalVariableTargetNode
  *
- * Type: PM_LOCAL_VARIABLE_TARGET_NODE
+ * Represents writing to a local variable in a context that doesn't have an explicit value.
+ *
+ *     foo, bar = baz
+ *     ^^^  ^^^
+ *
+ * Type: ::PM_LOCAL_VARIABLE_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -4421,6 +5212,7 @@ typedef struct pm_local_variable_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LocalVariableTargetNode#name
      */
@@ -4435,7 +5227,12 @@ typedef struct pm_local_variable_target_node {
 /**
  * LocalVariableWriteNode
  *
- * Type: PM_LOCAL_VARIABLE_WRITE_NODE
+ * Represents writing to a local variable.
+ *
+ *     foo = 1
+ *     ^^^^^^^
+ *
+ * Type: ::PM_LOCAL_VARIABLE_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -4443,6 +5240,7 @@ typedef struct pm_local_variable_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * LocalVariableWriteNode#name
      *
@@ -4508,19 +5306,25 @@ typedef struct pm_local_variable_write_node {
 /**
  * MatchLastLineNode
  *
- * Type: PM_MATCH_LAST_LINE_NODE
- * Flags:
- *    PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
- *    PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
- *    PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
- *    PM_REGULAR_EXPRESSION_FLAGS_ONCE
- *    PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
- *    PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
- *    PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
- *    PM_REGULAR_EXPRESSION_FLAGS_UTF_8
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
+ * Represents a regular expression literal used in the predicate of a conditional to implicitly match against the last line read by an IO object.
+ *
+ *     if /foo/i then end
+ *        ^^^^^^
+ *
+ * Type: ::PM_MATCH_LAST_LINE_NODE
+
+ * Flags (#pm_regular_expression_flags):
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ONCE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_UTF_8
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
  *
  * @extends pm_node_t
  */
@@ -4528,6 +5332,7 @@ typedef struct pm_match_last_line_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * MatchLastLineNode#opening_loc
      */
@@ -4552,7 +5357,12 @@ typedef struct pm_match_last_line_node {
 /**
  * MatchPredicateNode
  *
- * Type: PM_MATCH_PREDICATE_NODE
+ * Represents the use of the modifier `in` operator.
+ *
+ *     foo in bar
+ *     ^^^^^^^^^^
+ *
+ * Type: ::PM_MATCH_PREDICATE_NODE
  *
  * @extends pm_node_t
  */
@@ -4560,6 +5370,7 @@ typedef struct pm_match_predicate_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * MatchPredicateNode#value
      */
@@ -4579,7 +5390,12 @@ typedef struct pm_match_predicate_node {
 /**
  * MatchRequiredNode
  *
- * Type: PM_MATCH_REQUIRED_NODE
+ * Represents the use of the `=>` operator.
+ *
+ *     foo => bar
+ *     ^^^^^^^^^^
+ *
+ * Type: ::PM_MATCH_REQUIRED_NODE
  *
  * @extends pm_node_t
  */
@@ -4587,6 +5403,7 @@ typedef struct pm_match_required_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * MatchRequiredNode#value
      */
@@ -4606,7 +5423,12 @@ typedef struct pm_match_required_node {
 /**
  * MatchWriteNode
  *
- * Type: PM_MATCH_WRITE_NODE
+ * Represents writing local variables using a regular expression match with named capture groups.
+ *
+ *     /(?<foo>bar)/ =~ baz
+ *     ^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_MATCH_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -4614,6 +5436,7 @@ typedef struct pm_match_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * MatchWriteNode#call
      */
@@ -4628,19 +5451,27 @@ typedef struct pm_match_write_node {
 /**
  * MissingNode
  *
- * Type: PM_MISSING_NODE
+ * Represents a node that is missing from the source and results in a syntax error.
+ *
+ * Type: ::PM_MISSING_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_missing_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_missing_node_t;
 
 /**
  * ModuleNode
  *
- * Type: PM_MODULE_NODE
+ * Represents a module declaration involving the `module` keyword.
+ *
+ *     module Foo end
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_MODULE_NODE
  *
  * @extends pm_node_t
  */
@@ -4648,6 +5479,7 @@ typedef struct pm_module_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ModuleNode#locals
      */
@@ -4682,7 +5514,17 @@ typedef struct pm_module_node {
 /**
  * MultiTargetNode
  *
- * Type: PM_MULTI_TARGET_NODE
+ * Represents a multi-target expression.
+ *
+ *     a, (b, c) = 1, 2, 3
+ *        ^^^^^^
+ *
+ * This can be a part of `MultiWriteNode` as above, or the target of a `for` loop
+ *
+ *     for a, b in [[1, 2], [3, 4]]
+ *         ^^^^
+ *
+ * Type: ::PM_MULTI_TARGET_NODE
  *
  * @extends pm_node_t
  */
@@ -4690,28 +5532,69 @@ typedef struct pm_multi_target_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * MultiTargetNode#lefts
+     *
+     * Represents the targets expressions before a splat node.
+     *
+     *     a, (b, c, *) = 1, 2, 3, 4, 5
+     *         ^^^^
+     *
+     * The splat node can be absent, in that case all target expressions are in the left field.
+     *
+     *     a, (b, c) = 1, 2, 3, 4, 5
+     *         ^^^^
      */
     struct pm_node_list lefts;
 
     /**
      * MultiTargetNode#rest
+     *
+     * Represents a splat node in the target expression.
+     *
+     *     a, (b, *c) = 1, 2, 3, 4
+     *            ^^
+     *
+     * The variable can be empty, this results in a `SplatNode` with a `nil` expression field.
+     *
+     *     a, (b, *) = 1, 2, 3, 4
+     *            ^
+     *
+     * If the `*` is omitted, this field will contain an `ImplicitRestNode`
+     *
+     *     a, (b,) = 1, 2, 3, 4
+     *          ^
      */
     struct pm_node *rest;
 
     /**
      * MultiTargetNode#rights
+     *
+     * Represents the targets expressions after a splat node.
+     *
+     *     a, (*, b, c) = 1, 2, 3, 4, 5
+     *            ^^^^
      */
     struct pm_node_list rights;
 
     /**
      * MultiTargetNode#lparen_loc
+     *
+     * The location of the opening parenthesis.
+     *
+     *     a, (b, c) = 1, 2, 3
+     *        ^
      */
     pm_location_t lparen_loc;
 
     /**
      * MultiTargetNode#rparen_loc
+     *
+     * The location of the closing parenthesis.
+     *
+     *     a, (b, c) = 1, 2, 3
+     *             ^
      */
     pm_location_t rparen_loc;
 } pm_multi_target_node_t;
@@ -4719,7 +5602,12 @@ typedef struct pm_multi_target_node {
 /**
  * MultiWriteNode
  *
- * Type: PM_MULTI_WRITE_NODE
+ * Represents a write to a multi-target expression.
+ *
+ *     a, b, c = 1, 2, 3
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_MULTI_WRITE_NODE
  *
  * @extends pm_node_t
  */
@@ -4727,38 +5615,89 @@ typedef struct pm_multi_write_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * MultiWriteNode#lefts
+     *
+     * Represents the targets expressions before a splat node.
+     *
+     *     a, b, * = 1, 2, 3, 4, 5
+     *     ^^^^
+     *
+     * The splat node can be absent, in that case all target expressions are in the left field.
+     *
+     *     a, b, c = 1, 2, 3, 4, 5
+     *     ^^^^^^^
      */
     struct pm_node_list lefts;
 
     /**
      * MultiWriteNode#rest
+     *
+     * Represents a splat node in the target expression.
+     *
+     *     a, b, *c = 1, 2, 3, 4
+     *           ^^
+     *
+     * The variable can be empty, this results in a `SplatNode` with a `nil` expression field.
+     *
+     *     a, b, * = 1, 2, 3, 4
+     *           ^
+     *
+     * If the `*` is omitted, this field will contain an `ImplicitRestNode`
+     *
+     *     a, b, = 1, 2, 3, 4
+     *         ^
      */
     struct pm_node *rest;
 
     /**
      * MultiWriteNode#rights
+     *
+     * Represents the targets expressions after a splat node.
+     *
+     *     a, *, b, c = 1, 2, 3, 4, 5
+     *           ^^^^
      */
     struct pm_node_list rights;
 
     /**
      * MultiWriteNode#lparen_loc
+     *
+     * The location of the opening parenthesis.
+     *
+     *     (a, b, c) = 1, 2, 3
+     *     ^
      */
     pm_location_t lparen_loc;
 
     /**
      * MultiWriteNode#rparen_loc
+     *
+     * The location of the closing parenthesis.
+     *
+     *     (a, b, c) = 1, 2, 3
+     *             ^
      */
     pm_location_t rparen_loc;
 
     /**
      * MultiWriteNode#operator_loc
+     *
+     * The location of the operator.
+     *
+     *     a, b, c = 1, 2, 3
+     *             ^
      */
     pm_location_t operator_loc;
 
     /**
      * MultiWriteNode#value
+     *
+     * The value to write to the targets. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
+     *
+     *     a, b, c = 1, 2, 3
+     *               ^^^^^^^
      */
     struct pm_node *value;
 } pm_multi_write_node_t;
@@ -4766,7 +5705,12 @@ typedef struct pm_multi_write_node {
 /**
  * NextNode
  *
- * Type: PM_NEXT_NODE
+ * Represents the use of the `next` keyword.
+ *
+ *     next 1
+ *     ^^^^^^
+ *
+ * Type: ::PM_NEXT_NODE
  *
  * @extends pm_node_t
  */
@@ -4774,6 +5718,7 @@ typedef struct pm_next_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * NextNode#arguments
      */
@@ -4788,19 +5733,31 @@ typedef struct pm_next_node {
 /**
  * NilNode
  *
- * Type: PM_NIL_NODE
+ * Represents the use of the `nil` keyword.
+ *
+ *     nil
+ *     ^^^
+ *
+ * Type: ::PM_NIL_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_nil_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_nil_node_t;
 
 /**
  * NoKeywordsParameterNode
  *
- * Type: PM_NO_KEYWORDS_PARAMETER_NODE
+ * Represents the use of `**nil` inside method arguments.
+ *
+ *     def a(**nil)
+ *           ^^^^^
+ *     end
+ *
+ * Type: ::PM_NO_KEYWORDS_PARAMETER_NODE
  *
  * @extends pm_node_t
  */
@@ -4808,6 +5765,7 @@ typedef struct pm_no_keywords_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * NoKeywordsParameterNode#operator_loc
      */
@@ -4822,7 +5780,12 @@ typedef struct pm_no_keywords_parameter_node {
 /**
  * NumberedParametersNode
  *
- * Type: PM_NUMBERED_PARAMETERS_NODE
+ * Represents an implicit set of parameters through the use of numbered parameters within a block or lambda.
+ *
+ *     -> { _1 + _2 }
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_NUMBERED_PARAMETERS_NODE
  *
  * @extends pm_node_t
  */
@@ -4830,6 +5793,7 @@ typedef struct pm_numbered_parameters_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * NumberedParametersNode#maximum
      */
@@ -4839,7 +5803,12 @@ typedef struct pm_numbered_parameters_node {
 /**
  * NumberedReferenceReadNode
  *
- * Type: PM_NUMBERED_REFERENCE_READ_NODE
+ * Represents reading a numbered reference to a capture in the previous match.
+ *
+ *     $1
+ *     ^^
+ *
+ * Type: ::PM_NUMBERED_REFERENCE_READ_NODE
  *
  * @extends pm_node_t
  */
@@ -4847,6 +5816,7 @@ typedef struct pm_numbered_reference_read_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * NumberedReferenceReadNode#number
      *
@@ -4864,9 +5834,16 @@ typedef struct pm_numbered_reference_read_node {
 /**
  * OptionalKeywordParameterNode
  *
- * Type: PM_OPTIONAL_KEYWORD_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents an optional keyword parameter to a method, block, or lambda definition.
+ *
+ *     def a(b: 1)
+ *           ^^^^
+ *     end
+ *
+ * Type: ::PM_OPTIONAL_KEYWORD_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -4874,6 +5851,7 @@ typedef struct pm_optional_keyword_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * OptionalKeywordParameterNode#name
      */
@@ -4893,9 +5871,16 @@ typedef struct pm_optional_keyword_parameter_node {
 /**
  * OptionalParameterNode
  *
- * Type: PM_OPTIONAL_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents an optional parameter to a method, block, or lambda definition.
+ *
+ *     def a(b = 1)
+ *           ^^^^^
+ *     end
+ *
+ * Type: ::PM_OPTIONAL_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -4903,6 +5888,7 @@ typedef struct pm_optional_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * OptionalParameterNode#name
      */
@@ -4927,7 +5913,12 @@ typedef struct pm_optional_parameter_node {
 /**
  * OrNode
  *
- * Type: PM_OR_NODE
+ * Represents the use of the `||` operator or the `or` keyword.
+ *
+ *     left or right
+ *     ^^^^^^^^^^^^^
+ *
+ * Type: ::PM_OR_NODE
  *
  * @extends pm_node_t
  */
@@ -4935,6 +5926,7 @@ typedef struct pm_or_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * OrNode#left
      *
@@ -4951,7 +5943,7 @@ typedef struct pm_or_node {
     /**
      * OrNode#right
      *
-     * Represents the right side of the expression. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
+     * Represents the right side of the expression.
      *
      *     left || right
      *             ^^^^^
@@ -4975,7 +5967,13 @@ typedef struct pm_or_node {
 /**
  * ParametersNode
  *
- * Type: PM_PARAMETERS_NODE
+ * Represents the list of parameters on a method, block, or lambda definition.
+ *
+ *     def a(b, c, d)
+ *           ^^^^^^^
+ *     end
+ *
+ * Type: ::PM_PARAMETERS_NODE
  *
  * @extends pm_node_t
  */
@@ -4983,6 +5981,7 @@ typedef struct pm_parameters_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ParametersNode#requireds
      */
@@ -5022,7 +6021,12 @@ typedef struct pm_parameters_node {
 /**
  * ParenthesesNode
  *
- * Type: PM_PARENTHESES_NODE
+ * Represents a parenthesized expression
+ *
+ *     (10 + 34)
+ *     ^^^^^^^^^
+ *
+ * Type: ::PM_PARENTHESES_NODE
  *
  * @extends pm_node_t
  */
@@ -5030,6 +6034,7 @@ typedef struct pm_parentheses_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ParenthesesNode#body
      */
@@ -5049,7 +6054,12 @@ typedef struct pm_parentheses_node {
 /**
  * PinnedExpressionNode
  *
- * Type: PM_PINNED_EXPRESSION_NODE
+ * Represents the use of the `^` operator for pinning an expression in a pattern matching expression.
+ *
+ *     foo in ^(bar)
+ *            ^^^^^^
+ *
+ * Type: ::PM_PINNED_EXPRESSION_NODE
  *
  * @extends pm_node_t
  */
@@ -5057,6 +6067,7 @@ typedef struct pm_pinned_expression_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * PinnedExpressionNode#expression
      */
@@ -5081,7 +6092,12 @@ typedef struct pm_pinned_expression_node {
 /**
  * PinnedVariableNode
  *
- * Type: PM_PINNED_VARIABLE_NODE
+ * Represents the use of the `^` operator for pinning a variable in a pattern matching expression.
+ *
+ *     foo in ^bar
+ *            ^^^^
+ *
+ * Type: ::PM_PINNED_VARIABLE_NODE
  *
  * @extends pm_node_t
  */
@@ -5089,6 +6105,7 @@ typedef struct pm_pinned_variable_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * PinnedVariableNode#variable
      */
@@ -5103,7 +6120,12 @@ typedef struct pm_pinned_variable_node {
 /**
  * PostExecutionNode
  *
- * Type: PM_POST_EXECUTION_NODE
+ * Represents the use of the `END` keyword.
+ *
+ *     END { foo }
+ *     ^^^^^^^^^^^
+ *
+ * Type: ::PM_POST_EXECUTION_NODE
  *
  * @extends pm_node_t
  */
@@ -5111,6 +6133,7 @@ typedef struct pm_post_execution_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * PostExecutionNode#statements
      */
@@ -5135,7 +6158,12 @@ typedef struct pm_post_execution_node {
 /**
  * PreExecutionNode
  *
- * Type: PM_PRE_EXECUTION_NODE
+ * Represents the use of the `BEGIN` keyword.
+ *
+ *     BEGIN { foo }
+ *     ^^^^^^^^^^^^^
+ *
+ * Type: ::PM_PRE_EXECUTION_NODE
  *
  * @extends pm_node_t
  */
@@ -5143,6 +6171,7 @@ typedef struct pm_pre_execution_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * PreExecutionNode#statements
      */
@@ -5167,7 +6196,9 @@ typedef struct pm_pre_execution_node {
 /**
  * ProgramNode
  *
- * Type: PM_PROGRAM_NODE
+ * The top level node of any parse tree.
+ *
+ * Type: ::PM_PROGRAM_NODE
  *
  * @extends pm_node_t
  */
@@ -5175,6 +6206,7 @@ typedef struct pm_program_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ProgramNode#locals
      */
@@ -5189,9 +6221,18 @@ typedef struct pm_program_node {
 /**
  * RangeNode
  *
- * Type: PM_RANGE_NODE
- * Flags:
- *    PM_RANGE_FLAGS_EXCLUDE_END
+ * Represents the use of the `..` or `...` operators.
+ *
+ *     1..2
+ *     ^^^^
+ *
+ *     c if a =~ /left/ ... b =~ /right/
+ *          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_RANGE_NODE
+
+ * Flags (#pm_range_flags):
+ * * ::PM_RANGE_FLAGS_EXCLUDE_END
  *
  * @extends pm_node_t
  */
@@ -5199,6 +6240,7 @@ typedef struct pm_range_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RangeNode#left
      *
@@ -5237,7 +6279,18 @@ typedef struct pm_range_node {
 /**
  * RationalNode
  *
- * Type: PM_RATIONAL_NODE
+ * Represents a rational number literal.
+ *
+ *     1.0r
+ *     ^^^^
+ *
+ * Type: ::PM_RATIONAL_NODE
+
+ * Flags (#pm_integer_base_flags):
+ * * ::PM_INTEGER_BASE_FLAGS_BINARY
+ * * ::PM_INTEGER_BASE_FLAGS_DECIMAL
+ * * ::PM_INTEGER_BASE_FLAGS_OCTAL
+ * * ::PM_INTEGER_BASE_FLAGS_HEXADECIMAL
  *
  * @extends pm_node_t
  */
@@ -5245,40 +6298,66 @@ typedef struct pm_rational_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
-     * RationalNode#numeric
+     * RationalNode#numerator
+     *
+     * The numerator of the rational number.
+     *
+     *     1.5r # numerator 3
      */
-    struct pm_node *numeric;
+    pm_integer_t numerator;
+
+    /**
+     * RationalNode#denominator
+     *
+     * The denominator of the rational number.
+     *
+     *     1.5r # denominator 2
+     */
+    pm_integer_t denominator;
 } pm_rational_node_t;
 
 /**
  * RedoNode
  *
- * Type: PM_REDO_NODE
+ * Represents the use of the `redo` keyword.
+ *
+ *     redo
+ *     ^^^^
+ *
+ * Type: ::PM_REDO_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_redo_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_redo_node_t;
 
 /**
  * RegularExpressionNode
  *
- * Type: PM_REGULAR_EXPRESSION_NODE
- * Flags:
- *    PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
- *    PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
- *    PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
- *    PM_REGULAR_EXPRESSION_FLAGS_ONCE
- *    PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
- *    PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
- *    PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
- *    PM_REGULAR_EXPRESSION_FLAGS_UTF_8
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
- *    PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
+ * Represents a regular expression literal with no interpolation.
+ *
+ *     /foo/i
+ *     ^^^^^^
+ *
+ * Type: ::PM_REGULAR_EXPRESSION_NODE
+
+ * Flags (#pm_regular_expression_flags):
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EXTENDED
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ONCE
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_EUC_JP
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_UTF_8
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING
  *
  * @extends pm_node_t
  */
@@ -5286,6 +6365,7 @@ typedef struct pm_regular_expression_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RegularExpressionNode#opening_loc
      */
@@ -5310,9 +6390,16 @@ typedef struct pm_regular_expression_node {
 /**
  * RequiredKeywordParameterNode
  *
- * Type: PM_REQUIRED_KEYWORD_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents a required keyword parameter to a method, block, or lambda definition.
+ *
+ *     def a(b: )
+ *           ^^
+ *     end
+ *
+ * Type: ::PM_REQUIRED_KEYWORD_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -5320,6 +6407,7 @@ typedef struct pm_required_keyword_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RequiredKeywordParameterNode#name
      */
@@ -5334,9 +6422,16 @@ typedef struct pm_required_keyword_parameter_node {
 /**
  * RequiredParameterNode
  *
- * Type: PM_REQUIRED_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents a required parameter to a method, block, or lambda definition.
+ *
+ *     def a(b)
+ *           ^
+ *     end
+ *
+ * Type: ::PM_REQUIRED_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -5344,6 +6439,7 @@ typedef struct pm_required_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RequiredParameterNode#name
      */
@@ -5353,7 +6449,12 @@ typedef struct pm_required_parameter_node {
 /**
  * RescueModifierNode
  *
- * Type: PM_RESCUE_MODIFIER_NODE
+ * Represents an expression modified with a rescue.
+ *
+ *     foo rescue nil
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_RESCUE_MODIFIER_NODE
  *
  * @extends pm_node_t
  */
@@ -5361,6 +6462,7 @@ typedef struct pm_rescue_modifier_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RescueModifierNode#expression
      */
@@ -5380,7 +6482,17 @@ typedef struct pm_rescue_modifier_node {
 /**
  * RescueNode
  *
- * Type: PM_RESCUE_NODE
+ * Represents a rescue statement.
+ *
+ *     begin
+ *     rescue Foo, *splat, Bar => ex
+ *       foo
+ *     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ *     end
+ *
+ * `Foo, *splat, Bar` are in the `exceptions` field. `ex` is in the `exception` field.
+ *
+ * Type: ::PM_RESCUE_NODE
  *
  * @extends pm_node_t
  */
@@ -5388,6 +6500,7 @@ typedef struct pm_rescue_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RescueNode#keyword_loc
      */
@@ -5414,17 +6527,24 @@ typedef struct pm_rescue_node {
     struct pm_statements_node *statements;
 
     /**
-     * RescueNode#consequent
+     * RescueNode#subsequent
      */
-    struct pm_rescue_node *consequent;
+    struct pm_rescue_node *subsequent;
 } pm_rescue_node_t;
 
 /**
  * RestParameterNode
  *
- * Type: PM_REST_PARAMETER_NODE
- * Flags:
- *    PM_PARAMETER_FLAGS_REPEATED_PARAMETER
+ * Represents a rest parameter to a method, block, or lambda definition.
+ *
+ *     def a(*b)
+ *           ^^
+ *     end
+ *
+ * Type: ::PM_REST_PARAMETER_NODE
+
+ * Flags (#pm_parameter_flags):
+ * * ::PM_PARAMETER_FLAGS_REPEATED_PARAMETER
  *
  * @extends pm_node_t
  */
@@ -5432,6 +6552,7 @@ typedef struct pm_rest_parameter_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * RestParameterNode#name
      */
@@ -5451,21 +6572,30 @@ typedef struct pm_rest_parameter_node {
 /**
  * RetryNode
  *
- * Type: PM_RETRY_NODE
+ * Represents the use of the `retry` keyword.
+ *
+ *     retry
+ *     ^^^^^
+ *
+ * Type: ::PM_RETRY_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_retry_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_retry_node_t;
 
 /**
  * ReturnNode
  *
- * Type: PM_RETURN_NODE
- * Flags:
- *    PM_RETURN_NODE_FLAGS_REDUNDANT
+ * Represents the use of the `return` keyword.
+ *
+ *     return 1
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_RETURN_NODE
  *
  * @extends pm_node_t
  */
@@ -5473,6 +6603,7 @@ typedef struct pm_return_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ReturnNode#keyword_loc
      */
@@ -5487,23 +6618,36 @@ typedef struct pm_return_node {
 /**
  * SelfNode
  *
- * Type: PM_SELF_NODE
+ * Represents the `self` keyword.
+ *
+ *     self
+ *     ^^^^
+ *
+ * Type: ::PM_SELF_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_self_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_self_node_t;
 
 /**
  * ShareableConstantNode
  *
- * Type: PM_SHAREABLE_CONSTANT_NODE
- * Flags:
- *    PM_SHAREABLE_CONSTANT_NODE_FLAGS_LITERAL
- *    PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_EVERYTHING
- *    PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_COPY
+ * This node wraps a constant write to indicate that when the value is written, it should have its shareability state modified.
+ *
+ *     # shareable_constant_value: literal
+ *     C = { a: 1 }
+ *     ^^^^^^^^^^^^
+ *
+ * Type: ::PM_SHAREABLE_CONSTANT_NODE
+
+ * Flags (#pm_shareable_constant_node_flags):
+ * * ::PM_SHAREABLE_CONSTANT_NODE_FLAGS_LITERAL
+ * * ::PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_EVERYTHING
+ * * ::PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_COPY
  *
  * @extends pm_node_t
  */
@@ -5511,6 +6655,7 @@ typedef struct pm_shareable_constant_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * ShareableConstantNode#write
      *
@@ -5522,7 +6667,12 @@ typedef struct pm_shareable_constant_node {
 /**
  * SingletonClassNode
  *
- * Type: PM_SINGLETON_CLASS_NODE
+ * Represents a singleton class declaration involving the `class` keyword.
+ *
+ *     class << self end
+ *     ^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_SINGLETON_CLASS_NODE
  *
  * @extends pm_node_t
  */
@@ -5530,6 +6680,7 @@ typedef struct pm_singleton_class_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * SingletonClassNode#locals
      */
@@ -5564,24 +6715,36 @@ typedef struct pm_singleton_class_node {
 /**
  * SourceEncodingNode
  *
- * Type: PM_SOURCE_ENCODING_NODE
+ * Represents the use of the `__ENCODING__` keyword.
+ *
+ *     __ENCODING__
+ *     ^^^^^^^^^^^^
+ *
+ * Type: ::PM_SOURCE_ENCODING_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_source_encoding_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_source_encoding_node_t;
 
 /**
  * SourceFileNode
  *
- * Type: PM_SOURCE_FILE_NODE
- * Flags:
- *    PM_STRING_FLAGS_FORCED_UTF8_ENCODING
- *    PM_STRING_FLAGS_FORCED_BINARY_ENCODING
- *    PM_STRING_FLAGS_FROZEN
- *    PM_STRING_FLAGS_MUTABLE
+ * Represents the use of the `__FILE__` keyword.
+ *
+ *     __FILE__
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_SOURCE_FILE_NODE
+
+ * Flags (#pm_string_flags):
+ * * ::PM_STRING_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_STRING_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_STRING_FLAGS_FROZEN
+ * * ::PM_STRING_FLAGS_MUTABLE
  *
  * @extends pm_node_t
  */
@@ -5589,6 +6752,7 @@ typedef struct pm_source_file_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * SourceFileNode#filepath
      *
@@ -5600,19 +6764,30 @@ typedef struct pm_source_file_node {
 /**
  * SourceLineNode
  *
- * Type: PM_SOURCE_LINE_NODE
+ * Represents the use of the `__LINE__` keyword.
+ *
+ *     __LINE__
+ *     ^^^^^^^^
+ *
+ * Type: ::PM_SOURCE_LINE_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_source_line_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_source_line_node_t;
 
 /**
  * SplatNode
  *
- * Type: PM_SPLAT_NODE
+ * Represents the use of the splat operator.
+ *
+ *     [*a]
+ *      ^^
+ *
+ * Type: ::PM_SPLAT_NODE
  *
  * @extends pm_node_t
  */
@@ -5620,6 +6795,7 @@ typedef struct pm_splat_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * SplatNode#operator_loc
      */
@@ -5634,7 +6810,12 @@ typedef struct pm_splat_node {
 /**
  * StatementsNode
  *
- * Type: PM_STATEMENTS_NODE
+ * Represents a set of statements contained within some scope.
+ *
+ *     foo; bar; baz
+ *     ^^^^^^^^^^^^^
+ *
+ * Type: ::PM_STATEMENTS_NODE
  *
  * @extends pm_node_t
  */
@@ -5642,6 +6823,7 @@ typedef struct pm_statements_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * StatementsNode#body
      */
@@ -5651,12 +6833,24 @@ typedef struct pm_statements_node {
 /**
  * StringNode
  *
- * Type: PM_STRING_NODE
- * Flags:
- *    PM_STRING_FLAGS_FORCED_UTF8_ENCODING
- *    PM_STRING_FLAGS_FORCED_BINARY_ENCODING
- *    PM_STRING_FLAGS_FROZEN
- *    PM_STRING_FLAGS_MUTABLE
+ * Represents a string literal, a string contained within a `%w` list, or plain string content within an interpolated string.
+ *
+ *     "foo"
+ *     ^^^^^
+ *
+ *     %w[foo]
+ *        ^^^
+ *
+ *     "foo #{bar} baz"
+ *      ^^^^      ^^^^
+ *
+ * Type: ::PM_STRING_NODE
+
+ * Flags (#pm_string_flags):
+ * * ::PM_STRING_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_STRING_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_STRING_FLAGS_FROZEN
+ * * ::PM_STRING_FLAGS_MUTABLE
  *
  * @extends pm_node_t
  */
@@ -5664,6 +6858,7 @@ typedef struct pm_string_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * StringNode#opening_loc
      */
@@ -5688,7 +6883,15 @@ typedef struct pm_string_node {
 /**
  * SuperNode
  *
- * Type: PM_SUPER_NODE
+ * Represents the use of the `super` keyword with parentheses or arguments.
+ *
+ *     super()
+ *     ^^^^^^^
+ *
+ *     super foo, bar
+ *     ^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_SUPER_NODE
  *
  * @extends pm_node_t
  */
@@ -5696,6 +6899,7 @@ typedef struct pm_super_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * SuperNode#keyword_loc
      */
@@ -5725,11 +6929,20 @@ typedef struct pm_super_node {
 /**
  * SymbolNode
  *
- * Type: PM_SYMBOL_NODE
- * Flags:
- *    PM_SYMBOL_FLAGS_FORCED_UTF8_ENCODING
- *    PM_SYMBOL_FLAGS_FORCED_BINARY_ENCODING
- *    PM_SYMBOL_FLAGS_FORCED_US_ASCII_ENCODING
+ * Represents a symbol literal or a symbol contained within a `%i` list.
+ *
+ *     :foo
+ *     ^^^^
+ *
+ *     %i[foo]
+ *        ^^^
+ *
+ * Type: ::PM_SYMBOL_NODE
+
+ * Flags (#pm_symbol_flags):
+ * * ::PM_SYMBOL_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_SYMBOL_FLAGS_FORCED_BINARY_ENCODING
+ * * ::PM_SYMBOL_FLAGS_FORCED_US_ASCII_ENCODING
  *
  * @extends pm_node_t
  */
@@ -5737,6 +6950,7 @@ typedef struct pm_symbol_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * SymbolNode#opening_loc
      */
@@ -5761,19 +6975,30 @@ typedef struct pm_symbol_node {
 /**
  * TrueNode
  *
- * Type: PM_TRUE_NODE
+ * Represents the use of the literal `true` keyword.
+ *
+ *     true
+ *     ^^^^
+ *
+ * Type: ::PM_TRUE_NODE
  *
  * @extends pm_node_t
  */
 typedef struct pm_true_node {
     /** The embedded base node. */
     pm_node_t base;
+
 } pm_true_node_t;
 
 /**
  * UndefNode
  *
- * Type: PM_UNDEF_NODE
+ * Represents the use of the `undef` keyword.
+ *
+ *     undef :foo, :bar, :baz
+ *     ^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_UNDEF_NODE
  *
  * @extends pm_node_t
  */
@@ -5781,6 +7006,7 @@ typedef struct pm_undef_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * UndefNode#names
      */
@@ -5795,7 +7021,15 @@ typedef struct pm_undef_node {
 /**
  * UnlessNode
  *
- * Type: PM_UNLESS_NODE
+ * Represents the use of the `unless` keyword, either in the block form or the modifier form.
+ *
+ *     bar unless foo
+ *     ^^^^^^^^^^^^^^
+ *
+ *     unless foo then bar end
+ *     ^^^^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_UNLESS_NODE
  *
  * @extends pm_node_t
  */
@@ -5803,6 +7037,7 @@ typedef struct pm_unless_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * UnlessNode#keyword_loc
      *
@@ -5833,7 +7068,9 @@ typedef struct pm_unless_node {
      * UnlessNode#then_keyword_loc
      *
      * The location of the `then` keyword, if present.
-     * unless cond then bar end ^^^^
+     *
+     *     unless cond then bar end
+     *                 ^^^^
      */
     pm_location_t then_keyword_loc;
 
@@ -5849,14 +7086,14 @@ typedef struct pm_unless_node {
     struct pm_statements_node *statements;
 
     /**
-     * UnlessNode#consequent
+     * UnlessNode#else_clause
      *
      * The else clause of the unless expression, if present.
      *
      *     unless cond then bar else baz end
      *                          ^^^^^^^^
      */
-    struct pm_else_node *consequent;
+    struct pm_else_node *else_clause;
 
     /**
      * UnlessNode#end_keyword_loc
@@ -5872,9 +7109,18 @@ typedef struct pm_unless_node {
 /**
  * UntilNode
  *
- * Type: PM_UNTIL_NODE
- * Flags:
- *    PM_LOOP_FLAGS_BEGIN_MODIFIER
+ * Represents the use of the `until` keyword, either in the block form or the modifier form.
+ *
+ *     bar until foo
+ *     ^^^^^^^^^^^^^
+ *
+ *     until foo do bar end
+ *     ^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_UNTIL_NODE
+
+ * Flags (#pm_loop_flags):
+ * * ::PM_LOOP_FLAGS_BEGIN_MODIFIER
  *
  * @extends pm_node_t
  */
@@ -5882,6 +7128,7 @@ typedef struct pm_until_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * UntilNode#keyword_loc
      */
@@ -5906,7 +7153,14 @@ typedef struct pm_until_node {
 /**
  * WhenNode
  *
- * Type: PM_WHEN_NODE
+ * Represents the use of the `when` keyword within a case statement.
+ *
+ *     case true
+ *     when true
+ *     ^^^^^^^^^
+ *     end
+ *
+ * Type: ::PM_WHEN_NODE
  *
  * @extends pm_node_t
  */
@@ -5914,6 +7168,7 @@ typedef struct pm_when_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * WhenNode#keyword_loc
      */
@@ -5938,9 +7193,18 @@ typedef struct pm_when_node {
 /**
  * WhileNode
  *
- * Type: PM_WHILE_NODE
- * Flags:
- *    PM_LOOP_FLAGS_BEGIN_MODIFIER
+ * Represents the use of the `while` keyword, either in the block form or the modifier form.
+ *
+ *     bar while foo
+ *     ^^^^^^^^^^^^^
+ *
+ *     while foo do bar end
+ *     ^^^^^^^^^^^^^^^^^^^^
+ *
+ * Type: ::PM_WHILE_NODE
+
+ * Flags (#pm_loop_flags):
+ * * ::PM_LOOP_FLAGS_BEGIN_MODIFIER
  *
  * @extends pm_node_t
  */
@@ -5948,6 +7212,7 @@ typedef struct pm_while_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * WhileNode#keyword_loc
      */
@@ -5972,10 +7237,16 @@ typedef struct pm_while_node {
 /**
  * XStringNode
  *
- * Type: PM_X_STRING_NODE
- * Flags:
- *    PM_ENCODING_FLAGS_FORCED_UTF8_ENCODING
- *    PM_ENCODING_FLAGS_FORCED_BINARY_ENCODING
+ * Represents an xstring literal with no interpolation.
+ *
+ *     `foo`
+ *     ^^^^^
+ *
+ * Type: ::PM_X_STRING_NODE
+
+ * Flags (#pm_encoding_flags):
+ * * ::PM_ENCODING_FLAGS_FORCED_UTF8_ENCODING
+ * * ::PM_ENCODING_FLAGS_FORCED_BINARY_ENCODING
  *
  * @extends pm_node_t
  */
@@ -5983,6 +7254,7 @@ typedef struct pm_x_string_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * XStringNode#opening_loc
      */
@@ -6007,7 +7279,12 @@ typedef struct pm_x_string_node {
 /**
  * YieldNode
  *
- * Type: PM_YIELD_NODE
+ * Represents the use of the `yield` keyword.
+ *
+ *     yield 1
+ *     ^^^^^^^
+ *
+ * Type: ::PM_YIELD_NODE
  *
  * @extends pm_node_t
  */
@@ -6015,6 +7292,7 @@ typedef struct pm_yield_node {
     /** The embedded base node. */
     pm_node_t base;
 
+
     /**
      * YieldNode#keyword_loc
      */
@@ -6040,11 +7318,20 @@ typedef struct pm_yield_node {
  * Flags for arguments nodes.
  */
 typedef enum pm_arguments_node_flags {
-    /** if arguments contain keywords */
-    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORDS = 1,
+    /** if the arguments contain forwarding */
+    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_FORWARDING = 4,
 
-    /** if arguments contain keyword splat */
-    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORD_SPLAT = 2,
+    /** if the arguments contain keywords */
+    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORDS = 8,
+
+    /** if the arguments contain a keyword splat */
+    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_KEYWORD_SPLAT = 16,
+
+    /** if the arguments contain a splat */
+    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_SPLAT = 32,
+
+    /** if the arguments contain multiple splats */
+    PM_ARGUMENTS_NODE_FLAGS_CONTAINS_MULTIPLE_SPLATS = 64,
 } pm_arguments_node_flags_t;
 
 /**
@@ -6052,7 +7339,7 @@ typedef enum pm_arguments_node_flags {
  */
 typedef enum pm_array_node_flags {
     /** if array contains splat nodes */
-    PM_ARRAY_NODE_FLAGS_CONTAINS_SPLAT = 1,
+    PM_ARRAY_NODE_FLAGS_CONTAINS_SPLAT = 4,
 } pm_array_node_flags_t;
 
 /**
@@ -6060,16 +7347,16 @@ typedef enum pm_array_node_flags {
  */
 typedef enum pm_call_node_flags {
     /** &. operator */
-    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION = 1,
+    PM_CALL_NODE_FLAGS_SAFE_NAVIGATION = 4,
 
     /** a call that could have been a local variable */
-    PM_CALL_NODE_FLAGS_VARIABLE_CALL = 2,
+    PM_CALL_NODE_FLAGS_VARIABLE_CALL = 8,
 
     /** a call that is an attribute write, so the value being written should be returned */
-    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE = 4,
+    PM_CALL_NODE_FLAGS_ATTRIBUTE_WRITE = 16,
 
     /** a call that ignores method visibility */
-    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY = 8,
+    PM_CALL_NODE_FLAGS_IGNORE_VISIBILITY = 32,
 } pm_call_node_flags_t;
 
 /**
@@ -6077,10 +7364,10 @@ typedef enum pm_call_node_flags {
  */
 typedef enum pm_encoding_flags {
     /** internal bytes forced the encoding to UTF-8 */
-    PM_ENCODING_FLAGS_FORCED_UTF8_ENCODING = 1,
+    PM_ENCODING_FLAGS_FORCED_UTF8_ENCODING = 4,
 
     /** internal bytes forced the encoding to binary */
-    PM_ENCODING_FLAGS_FORCED_BINARY_ENCODING = 2,
+    PM_ENCODING_FLAGS_FORCED_BINARY_ENCODING = 8,
 } pm_encoding_flags_t;
 
 /**
@@ -6088,16 +7375,16 @@ typedef enum pm_encoding_flags {
  */
 typedef enum pm_integer_base_flags {
     /** 0b prefix */
-    PM_INTEGER_BASE_FLAGS_BINARY = 1,
+    PM_INTEGER_BASE_FLAGS_BINARY = 4,
 
     /** 0d or no prefix */
-    PM_INTEGER_BASE_FLAGS_DECIMAL = 2,
+    PM_INTEGER_BASE_FLAGS_DECIMAL = 8,
 
     /** 0o or 0 prefix */
-    PM_INTEGER_BASE_FLAGS_OCTAL = 4,
+    PM_INTEGER_BASE_FLAGS_OCTAL = 16,
 
     /** 0x prefix */
-    PM_INTEGER_BASE_FLAGS_HEXADECIMAL = 8,
+    PM_INTEGER_BASE_FLAGS_HEXADECIMAL = 32,
 } pm_integer_base_flags_t;
 
 /**
@@ -6105,10 +7392,10 @@ typedef enum pm_integer_base_flags {
  */
 typedef enum pm_interpolated_string_node_flags {
     /** frozen by virtue of a `frozen_string_literal: true` comment or `--enable-frozen-string-literal`; only for adjacent string literals like `'a' 'b'` */
-    PM_INTERPOLATED_STRING_NODE_FLAGS_FROZEN = 1,
+    PM_INTERPOLATED_STRING_NODE_FLAGS_FROZEN = 4,
 
     /** mutable by virtue of a `frozen_string_literal: false` comment or `--disable-frozen-string-literal`; only for adjacent string literals like `'a' 'b'` */
-    PM_INTERPOLATED_STRING_NODE_FLAGS_MUTABLE = 2,
+    PM_INTERPOLATED_STRING_NODE_FLAGS_MUTABLE = 8,
 } pm_interpolated_string_node_flags_t;
 
 /**
@@ -6116,7 +7403,7 @@ typedef enum pm_interpolated_string_node_flags {
  */
 typedef enum pm_keyword_hash_node_flags {
     /** a keyword hash which only has `AssocNode` elements all with symbol keys, which means the elements can be treated as keyword arguments */
-    PM_KEYWORD_HASH_NODE_FLAGS_SYMBOL_KEYS = 1,
+    PM_KEYWORD_HASH_NODE_FLAGS_SYMBOL_KEYS = 4,
 } pm_keyword_hash_node_flags_t;
 
 /**
@@ -6124,7 +7411,7 @@ typedef enum pm_keyword_hash_node_flags {
  */
 typedef enum pm_loop_flags {
     /** a loop after a begin statement, so the body is executed first before the condition */
-    PM_LOOP_FLAGS_BEGIN_MODIFIER = 1,
+    PM_LOOP_FLAGS_BEGIN_MODIFIER = 4,
 } pm_loop_flags_t;
 
 /**
@@ -6132,7 +7419,7 @@ typedef enum pm_loop_flags {
  */
 typedef enum pm_parameter_flags {
     /** a parameter name that has been repeated in the method signature */
-    PM_PARAMETER_FLAGS_REPEATED_PARAMETER = 1,
+    PM_PARAMETER_FLAGS_REPEATED_PARAMETER = 4,
 } pm_parameter_flags_t;
 
 /**
@@ -6140,7 +7427,7 @@ typedef enum pm_parameter_flags {
  */
 typedef enum pm_range_flags {
     /** ... operator */
-    PM_RANGE_FLAGS_EXCLUDE_END = 1,
+    PM_RANGE_FLAGS_EXCLUDE_END = 4,
 } pm_range_flags_t;
 
 /**
@@ -6148,59 +7435,51 @@ typedef enum pm_range_flags {
  */
 typedef enum pm_regular_expression_flags {
     /** i - ignores the case of characters when matching */
-    PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE = 1,
+    PM_REGULAR_EXPRESSION_FLAGS_IGNORE_CASE = 4,
 
     /** x - ignores whitespace and allows comments in regular expressions */
-    PM_REGULAR_EXPRESSION_FLAGS_EXTENDED = 2,
+    PM_REGULAR_EXPRESSION_FLAGS_EXTENDED = 8,
 
     /** m - allows $ to match the end of lines within strings */
-    PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE = 4,
+    PM_REGULAR_EXPRESSION_FLAGS_MULTI_LINE = 16,
 
     /** o - only interpolates values into the regular expression once */
-    PM_REGULAR_EXPRESSION_FLAGS_ONCE = 8,
+    PM_REGULAR_EXPRESSION_FLAGS_ONCE = 32,
 
     /** e - forces the EUC-JP encoding */
-    PM_REGULAR_EXPRESSION_FLAGS_EUC_JP = 16,
+    PM_REGULAR_EXPRESSION_FLAGS_EUC_JP = 64,
 
     /** n - forces the ASCII-8BIT encoding */
-    PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT = 32,
+    PM_REGULAR_EXPRESSION_FLAGS_ASCII_8BIT = 128,
 
     /** s - forces the Windows-31J encoding */
-    PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J = 64,
+    PM_REGULAR_EXPRESSION_FLAGS_WINDOWS_31J = 256,
 
     /** u - forces the UTF-8 encoding */
-    PM_REGULAR_EXPRESSION_FLAGS_UTF_8 = 128,
+    PM_REGULAR_EXPRESSION_FLAGS_UTF_8 = 512,
 
     /** internal bytes forced the encoding to UTF-8 */
-    PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING = 256,
+    PM_REGULAR_EXPRESSION_FLAGS_FORCED_UTF8_ENCODING = 1024,
 
     /** internal bytes forced the encoding to binary */
-    PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING = 512,
+    PM_REGULAR_EXPRESSION_FLAGS_FORCED_BINARY_ENCODING = 2048,
 
     /** internal bytes forced the encoding to US-ASCII */
-    PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING = 1024,
+    PM_REGULAR_EXPRESSION_FLAGS_FORCED_US_ASCII_ENCODING = 4096,
 } pm_regular_expression_flags_t;
 
-/**
- * Flags for return nodes.
- */
-typedef enum pm_return_node_flags {
-    /** a return statement that is redundant because it is the last statement in a method */
-    PM_RETURN_NODE_FLAGS_REDUNDANT = 1,
-} pm_return_node_flags_t;
-
 /**
  * Flags for shareable constant nodes.
  */
 typedef enum pm_shareable_constant_node_flags {
     /** constant writes that should be modified with shareable constant value literal */
-    PM_SHAREABLE_CONSTANT_NODE_FLAGS_LITERAL = 1,
+    PM_SHAREABLE_CONSTANT_NODE_FLAGS_LITERAL = 4,
 
     /** constant writes that should be modified with shareable constant value experimental everything */
-    PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_EVERYTHING = 2,
+    PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_EVERYTHING = 8,
 
     /** constant writes that should be modified with shareable constant value experimental copy */
-    PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_COPY = 4,
+    PM_SHAREABLE_CONSTANT_NODE_FLAGS_EXPERIMENTAL_COPY = 16,
 } pm_shareable_constant_node_flags_t;
 
 /**
@@ -6208,16 +7487,16 @@ typedef enum pm_shareable_constant_node_flags {
  */
 typedef enum pm_string_flags {
     /** internal bytes forced the encoding to UTF-8 */
-    PM_STRING_FLAGS_FORCED_UTF8_ENCODING = 1,
+    PM_STRING_FLAGS_FORCED_UTF8_ENCODING = 4,
 
     /** internal bytes forced the encoding to binary */
-    PM_STRING_FLAGS_FORCED_BINARY_ENCODING = 2,
+    PM_STRING_FLAGS_FORCED_BINARY_ENCODING = 8,
 
     /** frozen by virtue of a `frozen_string_literal: true` comment or `--enable-frozen-string-literal` */
-    PM_STRING_FLAGS_FROZEN = 4,
+    PM_STRING_FLAGS_FROZEN = 16,
 
     /** mutable by virtue of a `frozen_string_literal: false` comment or `--disable-frozen-string-literal` */
-    PM_STRING_FLAGS_MUTABLE = 8,
+    PM_STRING_FLAGS_MUTABLE = 32,
 } pm_string_flags_t;
 
 /**
@@ -6225,13 +7504,13 @@ typedef enum pm_string_flags {
  */
 typedef enum pm_symbol_flags {
     /** internal bytes forced the encoding to UTF-8 */
-    PM_SYMBOL_FLAGS_FORCED_UTF8_ENCODING = 1,
+    PM_SYMBOL_FLAGS_FORCED_UTF8_ENCODING = 4,
 
     /** internal bytes forced the encoding to binary */
-    PM_SYMBOL_FLAGS_FORCED_BINARY_ENCODING = 2,
+    PM_SYMBOL_FLAGS_FORCED_BINARY_ENCODING = 8,
 
     /** internal bytes forced the encoding to US-ASCII */
-    PM_SYMBOL_FLAGS_FORCED_US_ASCII_ENCODING = 4,
+    PM_SYMBOL_FLAGS_FORCED_US_ASCII_ENCODING = 16,
 } pm_symbol_flags_t;
 
 /**
@@ -6240,6 +7519,6 @@ typedef enum pm_symbol_flags {
  * to specify that through the environment. It will never be true except for in
  * those build systems.
  */
-#define PRISM_SERIALIZE_ONLY_SEMANTICS_FIELDS false
+#define PRISM_SERIALIZE_ONLY_SEMANTICS_FIELDS 0
 
 #endif