Scope Selector

The scope selector syntax is as follows:

atom:         «string» | '*'
scope:        «atom» ('.' «atom»)*
path:         '^'? «scope» ('>'? «scope»)* '$'?
group:        '(' «selector» ')'
filter:       ("L:"|"R:"|"B:") («group» | «path»)
expression:   '-'? («filter» | «group» | «path»)
composite:    «expression» ([|&-] «expression»)*
selector:     «composite» (',' «composite»)*
  • Left/right scope matching
  • Begin/end anchoring, ignoring attribute scopes
  • Wildcard matching
  • Descendent selector

Format String



\U, \L, \E, \u, \l
\t, \r, \n, \x{HHHH}, \xHH
  • Used for: grammar names, .tm_properties values, Preferences → Variables, replacement strings

For nested replacements, use named captures as variables are inherited.

Glob String

\«char»         -- Literal «char»
?               -- Match one character
*               -- Match zero or more characters¹
**              -- Match zero or more path components
{«a»,«b»,«c»}   -- Match «a» or «b» or «c»
[«a»«b»«c»]     -- Match an «a», «b» or «c» character
[«a»-«b»]       -- Match one character in the range «a»-«b»
[^«a»-«b»]      -- Match one character not in the range «a»-«b»
~«a» or !«a»    -- Do not match «a», e.g. to match all but *.h
                   files under src/ use `src/**~*.h`

Negations (~ or !) can be followed by more negations. E.g. to exclude both lib*.a and *.o use:


Braces can be nested and contain other glob characters. Example:


Will match these files:

¹ The asterisk will not match slashes nor a leading period.

  • Used in .tm_properties, Find in Folder

Selection String

selection    = «range» ('&' «range»)*
range        = «pos» | «normal_range» | «column_range»
pos          = «line» (':' «column»)? ('+' «offset»)?
normal_range = «pos» '-' «pos»
column_range = «pos» 'x' «pos»
line         = [1-9][0-9]*
column       = [1-9][0-9]*
offset       = [1-9][0-9]*

This can be used with mate -l, Go to Line…, and the ⌘T dialog (by putting :«selection string» after the file name) — as for the latter, if a string on the find clipboard has this format, it will be the default value in ⌘T, this is useful if you have a line in Terminal like: warning: no return statement.

You can then select press ⌘E and jump to Avian and press ⌘T followed by (one shortcoming is that ⌘T doesn’t show the currently open file, so it will only work if is not already the active file).

Modified Property List

See TextMate 1.x manual.

Regular Expression