On 10 Aug 2016, at 09:47, Allan Odgaard <mailinglist@textmate.org> wrote:

The “line number” does not need to care about most of what I mentioned above, ideally it would reflect when there are carets on multiple lines, but as the variable was introduced before this was a feature, we cannot extend the format without breaking existing stuff and instead a new variable was introduced with exact information (TM_SELECTION).

The format of TM_SELECTION is:

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]*