emacs/tree-sitter.tree-sitter
1
0
Fork 0
mirror of https://github.com/tree-sitter/tree-sitter.git synced 2026-09-10 07:36:22 -04:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

fix(docs): explicitly warn against aliasing supertypes

Browse source
This commit is contained in:
Will Lillis 2026-06-04 01:25:43 -04:00
parent d10b7272d2
commit 4154ff23c0
1 changed files with 7 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
docs/src/creating-parsers/3-writing-the-grammar.md
View file

@ -520,6 +520,13 @@ module.exports = grammar({
Although supertype rules are hidden from the syntax tree, they can still be used in queries. See the chapter on
[Query Syntax][query syntax] for more information.
```admonish warning
Aliasing a supertype rule makes the node in the alias match the supertype in
name only and will not be treated as a supertype. For `alias($.foo, $.bar)` a
query targeting `bar` will not transparently match the supertype's subtypes the
way a query targeting `foo` would.
```
# Lexical Analysis
Tree-sitter's parsing process is divided into two phases: parsing (which is described above) and [lexing][lexing] — the