diff options
| author | Tomáš Znamenáček | 2015-01-28 15:19:46 +0100 | 
|---|---|---|
| committer | Tomáš Znamenáček | 2015-01-28 15:19:46 +0100 | 
| commit | de647cf8251faa14239bdbbc8027116f6e5627c6 (patch) | |
| tree | adbed2416c1dedd0d6622ccb5017897c17a3d452 /Spec.md | |
| parent | 0db346d02be95bd66af52c1b9cd88439084bf295 (diff) | |
| download | MASShortcut-de647cf8251faa14239bdbbc8027116f6e5627c6.tar.bz2 | |
Talk about shortcut “formatting” instead of “rendering”.
Diffstat (limited to 'Spec.md')
| -rw-r--r-- | Spec.md | 6 | 
1 files changed, 3 insertions, 3 deletions
| @@ -14,12 +14,12 @@ Please stay high-level when writing the spec, do not document particular classes  * TBD: Option-key handling.  * All other shortcuts must be accepted. (Examples: Ctrl-Esc, Cmd-Delete, F16.) -# Rendering Shortcuts +# Formatting Shortcuts -On different keyboard layouts (such as US and Czech), a single shortcut (a combination of physical keys) can have different “names”. +On different keyboard layouts (such as US and Czech), a single shortcut (a combination of physical keys) may be formatted into different strings.  For example, the default system shortcut for toggling directly to Space #2 is Control–2. But when you switch to the Czech keyboard layout, the physical key with the `2` label now inserts the `ě` character. Thus, on most keyboard layouts the shortcut for toggling to Space #2 is called `^2`, but on the Czech layout it’s called `^ě`. (I stress that this is the same combination of hardware keys and the same `MASShortcut` instance.)  This is reflected by the system: When you open the System Preferences → Keyboard → Shortcuts pane, the shortcuts displayed depend on the currently selected keyboard layout (try switching between the US and Czech keyboard layouts and reopening the preference pane). -This means that the “identity” of a shortcut is given by its key code and modifiers (such as `kVK_ANSI_2` and `NSControlKeyMask`), not the `keyCodeString` returned by the `MASShortcut` class. This string may change depending on the current keyboard layout: `^2` with the US keyboard active, but `^ě` with the Czech keyboard active. +This means that the identity of a shortcut is given by its key code and modifiers (such as `kVK_ANSI_2` and `NSControlKeyMask`), not the `keyCodeString` returned by the `MASShortcut` class. This string may change depending on the current keyboard layout: `^2` with the US keyboard active, but `^ě` with the Czech keyboard active. | 
