Query syntax for consecutive sibling nodes?

[euclidianAce]

The documentation seems to be incorrect or I am misinterpreting it.

Grouping Sibling Nodes

You can also use parentheses for grouping a sequence of sibling nodes. For example, this pattern would match a comment followed by a function declaration:

(
  (comment)
  (function_declaration)
)

I would expect this query to match against comments followed by function declarations, but when run in the playground with some simple C code

// this is a comment, not followed immediately by a function, but eventually followed by a function
static const int x = 2;

// this is a comment, followed by a function
int main(void) {
    return 0;
}

// this is just a comment, at the end of the code

when running the query

(
  (comment) @a
  (function_definition) @b
) @c

in the playground, the two top comments are matched, despite the first comment and main having a node between them. This makes sense, I guess, but is there query syntax for named nodes directly next to each other?

[vigoux]

Hi, I think that what you are searching for is the . syntax, and that the query you want is :

(
  (comment) @a
  .
  (function_definition) @b
) @c

[euclidianAce]

Thanks! Is there somewhere where this is documented? Or is the query language not fully documented yet?

[stsewd]

Yeah, there are some undocumented features #549
#738

I opened a PR documented some of them #713