From 29d047c928099a32af5b312192ac9dfb3826d304 Mon Sep 17 00:00:00 2001
From: Tomáš Znamenáček
Date: Thu, 3 Dec 2015 15:15:05 +0100
Subject: Documented that we don’t accept Option-Shift shortcuts by default.

The reason is that Option-Shift shortcuts are often already used
by system to insert some special characters. See `MASShortcutValidator`
for details, including how to enable support for these shortcuts.
Fixes #79.
---
 Framework/MASShortcutValidator.h | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/Framework/MASShortcutValidator.h b/Framework/MASShortcutValidator.h
index cc5f816..95fe828 100644
--- a/Framework/MASShortcutValidator.h
+++ b/Framework/MASShortcutValidator.h
@@ -1,9 +1,23 @@
 #import "MASShortcut.h"
 
+/**
+ This class is used by the recording control to tell which shortcuts are acceptable.
+
+ There are two kinds of shortcuts that are not considered acceptable: shortcuts that
+ are too simple (like single letter keys) and shortcuts that are already used by the
+ operating system.
+*/
 @interface MASShortcutValidator : NSObject
 
-// The following API enable hotkeys with the Option key as the only modifier
-// For example, Option-G will not generate © and Option-R will not paste ®
+/**
+ Set to `YES` if you want to accept Option-something shortcuts.
+
+ `NO` by default, since Option-something shortcuts are often used by system,
+ for example Option-G will type the © sign. This also applies to Option-Shift
+ shortcuts – in other words, shortcut recorder will not accept shortcuts like
+ Option-Shift-K by default. (Again, since Option-Shift-K inserts the Apple
+ logo sign by default.)
+*/
 @property(assign) BOOL allowAnyShortcutWithOptionModifier;
 
 + (instancetype) sharedValidator;
-- 
cgit v1.2.3