docopt.tmLanguage

A TextMate grammar for docopt-style command synopsis notation — which may look like e.g.:

cat [OPTION]... [FILE]...

cd [ -qsLP ] {+|-}n

prog -a [-bc -e param] --arg0 val0 --arg1=val1

prog <thing> [[+-]feature ...]

The closest to an authoritative "docopt spec" would be POSIX 12.1 Utility Argument Syntax or docopt.org. The grammar generally supports the syntax each of these specify, but also accommodates other forms commonly seen in the wild, e.g. the {+|-} form.

AI/human authorship

This README.md file is written by me, Carl, a human developer. The grammar itself is written by LLMs.

Similar/related grammars

• https://github.com/Vallentin/vscode-bnf (bnf.tmLanguage)
• https://github.com/victor-gp/cmd-help-sublime-syntax (text.cmd-help)

References

• POSIX 12.1 Utility Argument Syntax
• docopt.org