Mouse
=====

Windows/Linux
-------------

Building blocks:

* Positive/negative:
	* Add to selection: <kbd>Ctrl</kbd>
	* Subtract from selection: <kbd>Alt</kbd> (only works with block selection in v3; presumably bug)
* Selection type:
	* Linear selection: <kbd>Left Click</kbd>
	* Block selection: <kbd>Middle Click</kbd> or <kbd>Shift</kbd> + <kbd>Right Click</kbd>

Combine as you see fit.  For example:

* Add to selection: <kbd>Ctrl</kbd> + <kbd>Left Click</kbd> (and optionally drag)
* Subtract from selection: <kbd>Alt</kbd> + <kbd>Left Click</kbd> (and drag--this combination doesn't work in Sublime Text 3, but supposedly it works in 2)
* Add block selection: <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Right Click</kbd> (and drag)
* Subtract block selection: <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>Right Click</kbd> (and drag)

Mac OS X
--------

Building blocks:

* Positive/negative:
	* Add to selection: <kbd>⌘</kbd>
	* Subtract from selection: <kbd>⇧⌘</kbd> (only works with block selection in v3; presumably bug)
* Selection type:
	* Linear selection: <kbd>Left Click</kbd>
	* Block selection: <kbd>Middle Click</kbd> or <kbd>⌥</kbd> + <kbd>Left Click</kbd>

Combine as you see fit.  For example:

* Add to selection: <kbd>⌘</kbd> + <kbd>Left Click</kbd> (and optionally drag)
* Subtract from selection: <kbd>⇧⌘</kbd> + <kbd>Left Click</kbd> (and drag--this combination doesn't work in Sublime Text 3, but supposedly it works in 2)
* Add block selection: <kbd>⌥⌘</kbd> + <kbd>Left Click</kbd> (and drag)
* Subtract block selection: <kbd>⌥⇧⌘</kbd> + <kbd>Left Click</kbd> (and drag)

Keyboard
========

Windows/Linux
-------------

* Return to single selection mode: <kbd>Esc</kbd>
* Extend selection upward/downward at all carets: <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Up</kbd>/<kbd>Down</kbd>
* Extend selection leftward/rightward at all carets: <kbd>Shift</kbd> + <kbd>Left</kbd>/<kbd>Right</kbd>
* Move all carets up/down/left/right, and clear selection: <kbd>Up</kbd>/<kbd>Down</kbd>/<kbd>Left</kbd>/<kbd>Right</kbd>
* Undo the last selection motion: <kbd>Ctrl</kbd> + <kbd>U</kbd>
* Add next occurrence of selected text to selection: <kbd>Ctrl</kbd> + <kbd>D</kbd>
* Add all occurrences of the selected text to the selection: <kbd>Alt</kbd> + <kbd>F3</kbd>
* Rotate between occurrences of selected text (single selection): <kbd>Ctrl</kbd> + <kbd>F3</kbd>
* Turn a single linear selection into a block selection, with a caret at the end of the selected text in each line: <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>L</kbd>

Mac OS X
--------

* Return to single selection mode: <kbd>⎋</kbd> (that's the Mac symbol for Escape)
* Extend selection upward/downward at all carets: <kbd>⌃⇧⇡</kbd>, <kbd>⌃⇧⇣</kbd> (See note)
* Extend selection leftward/rightward at all carets: <kbd>⇧⇠</kbd>/<kbd>⇧⇢</kbd>
* Move all carets up/down/left/right and clear selection: <kbd>⇠</kbd>, <kbd>⇡</kbd>, <kbd>⇣</kbd>, <kbd>⇢</kbd>
* Undo the last selection motion: <kbd>⌘U</kbd>
* Add next occurrence of selected text to selection: <kbd>⌘D</kbd>
* Add all occurrences of the selected text to the selection: <kbd>⌃⌘G</kbd>
* Rotate between occurrences of selected text (single selection): I'm too lazy to open my MacBook to figure it out, and it's not documented, but it most certainly exists.
* Turn a single linear selection into a block selection, with a caret at the end of the selected text in each line: <kbd>⇧⌘L</kbd>

**Note**

On Yosemite, <kbd>⌃⇧⇡</kbd> and <kbd>⌃⇧⇣</kbd> are system keyboard shortcuts by default.  If you want them to work in Sublime Text, you will need to change them:

1. Open `System Preferences`.
2. Click the `Keyboard` category.
3. Select `Mission Control` in the left listbox.
4. Change the keyboard shortcuts for `Mission Control` and `Application windows` (or disable them).  I use <kbd>⌃⌥⇡</kbd> and <kbd>⌃⌥⇣</kbd>.