Where can I find docs for TextMate grammars?

Question

I'm making a custom programming language. I wanted to make an VS Code extension, that will tokenize the language syntax. I also found out that it uses TextMate grammars. So I need to learn how to write a such grammar. And I can't find any documentation for TextMate grammars.

I've been searching internet for days and found some basic info like this, but I see that there's more through JSON schema. So i would appreciate official docs or reference that shows off ALL features. I've been looking literally everywhere and can't find anything else. Does anybody know where are these docs, or do they even exist??

Answer 1

The docs for scope selectors in TextMate v1 can be found at https://macromates.com/manual/en/language_grammars and https://macromates.com/manual/en/scope_selectors. For v2, at https://macromates.com/textmate/manual/language-grammars and https://macromates.com/textmate/manual/scopes.

If you want to look at examples, you can look at the builtin extensions. For example the one for HTML.