aboutsummaryrefslogtreecommitdiffstats
path: root/Spec.md
diff options
context:
space:
mode:
authorTomáš Znamenáček2015-01-28 15:19:46 +0100
committerTomáš Znamenáček2015-01-28 15:19:46 +0100
commitde647cf8251faa14239bdbbc8027116f6e5627c6 (patch)
treeadbed2416c1dedd0d6622ccb5017897c17a3d452 /Spec.md
parent0db346d02be95bd66af52c1b9cd88439084bf295 (diff)
downloadMASShortcut-de647cf8251faa14239bdbbc8027116f6e5627c6.tar.bz2
Talk about shortcut “formatting” instead of “rendering”.
Diffstat (limited to 'Spec.md')
-rw-r--r--Spec.md6
1 files changed, 3 insertions, 3 deletions
diff --git a/Spec.md b/Spec.md
index 16bb46f..e13576c 100644
--- a/Spec.md
+++ b/Spec.md
@@ -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.