From 681de1b04814542285a1d30d083575647a736975 Mon Sep 17 00:00:00 2001
From: Haojian Wu <hokein.wu@gmail.com>
Date: Mon, 4 Aug 2014 09:47:42 +0800
Subject: [PATCH] :memo: Update global-shortcut API document.

---
 docs/README.md              |  2 +-
 docs/api/global-shortcut.md | 57 +++++++++++++++++++++++++++++++
 docs/api/shortcut.md        | 67 -------------------------------------
 3 files changed, 58 insertions(+), 68 deletions(-)
 create mode 100644 docs/api/global-shortcut.md
 delete mode 100644 docs/api/shortcut.md

diff --git a/docs/README.md b/docs/README.md
index 53e1100dae2b..4e9d54f46f24 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -22,7 +22,7 @@ Modules for browser side:
 * [power-monitor](api/power-monitor.md)
 * [protocol](api/protocol.md)
 * [tray](api/tray.md)
-* [shortcut](api/shortcut.md)
+* [global-shortcut](api/global-shortcut.md)
 
 Modules for web page:
 
diff --git a/docs/api/global-shortcut.md b/docs/api/global-shortcut.md
new file mode 100644
index 000000000000..7f08051c40bf
--- /dev/null
+++ b/docs/api/global-shortcut.md
@@ -0,0 +1,57 @@
+# global-shortcut
+
+The `global-shortcut` module can register/unregister a global keyboard shortcut
+in operating system, so that you can custom the operations for various shortcuts.
+Note that it is global, even the app does not get focused, it still works.
+
+```javascript
+var globalShortcut = require('global-shortcut');
+
+// Register a 'ctrl+x' shortcut listener.
+var ret = globalShortcut.register('ctrl+x', function() { console.log('ctrl+x is pressed'); })
+if (!ret)
+  console.log('registerion fails');
+
+// Check whether a shortcut is registered.
+console.log(globalShortcut.isRegistered('ctrl+x'));
+
+// Unregister a shortcut.
+globalShortcut.unregister('ctrl+x');
+
+// Unregister all shortcuts.
+globalShortcut.unregisterAll();
+```
+
+## globalShortcut.register(keycode, callback)
+
+* `keycode` String
+* `callback` Function
+
+Registers a global shortcut of `keycode`, the `callback` would be called when
+the registered shortcut is pressed by user.
+
+`keycode` is a string to specify shortcut key, such as "ctrl+shift+a".
+
+A `keycode` consists of modifier and key two parts:
+
+__Modifiers__: control(ctrl), command(cmd), alt, shift, commandorcontrol(cmdorctrl).
+
+__Supported keys__: 0-9, a-z, up, down, left, right, home, end, pagedown, pageup,
+insert, delete, esc, space, backspace, tab, f1-f12, volumeup, volumedown, media 
+keys(medianextrack, mediaprevioustrack, mediastop, mediaplaypause).
+
+## globalShortcut.isRegistered(keycode)
+
+* `keycode` String
+
+Return whether the shortcut is registered.
+
+## globalShortcut.unregister(keycode)
+
+* `keycode` String
+
+Unregisters the global shortcut of `keycode`.
+
+## globalShortcut.unregisterAll()
+
+Unregisters all the global shortcuts.
diff --git a/docs/api/shortcut.md b/docs/api/shortcut.md
deleted file mode 100644
index 5f85079037a4..000000000000
--- a/docs/api/shortcut.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# shortcut
-
-A `Shortcut` presents a global keyboard shortcut in operating system. If a 
-`Shortcut` is registered in app, the app will receive an `active` event when
-user presses the shortcut. Note that it is global, even your app does not get 
-focused, it still works.
-
-
-```javascript
-var Shortcut = require('shortcut');
-
-shortcut = new Shortcut('ctrl+a');
-shortcut.setKey('ctrl+s');
-shortcut.on('active', function() { console.log('ctrl+s pressed'); });
-shortcut.on('failed', function() { console.log("failed"); });
-shortcut.register();
-```
-
-## Class: Shortcut 
-
-`Shortcut` is an [EventEmitter](event-emitter).
-
-### new Shortcut(keycode)
-
-* `keycode` String
-
-Creates a new `Shortcut` associated with the `keycode`.
-
-`keycode` is a string to specify shortcut key, such as "ctrl+shift+a".
-
-A `keycode` consists of modifier and key two parts:
-
-__Modifiers__: control(ctrl), command(cmd), alt, shift, commandorcontrol(cmdorctrl).
-
-__Supported keys__: 0-9, a-z, up, down, left, right, home, end, pagedown, pageup,
-insert, delete, esc, space, backspace, tab, f1-f12, volumeup, volumedown, media 
-keys(medianextrack, mediaprevioustrack, mediastop, mediaplaypause).
-
-### Event: active
-
-Emitted when a registered `shortcut` is pressed by user.
-
-### Event: failed
-
-Emitted when the keycode of `shortcut` is invalid.
-
-### Shortcut.setKey(keycode)
-
-* `keycode` String 
-
-Set new `keycode` to a `Shortcut`. Note that this operation will override previous
-keycode and will unregister the `Shortcut`, developer should register the
-`Shortcut` again after `setKey`.
-
-### Shortcut.register
-
-Register a `Shortcut` to operating system.
-
-### Shortcut.unregister
-
-Unregister a `Shortcut` to operating system.
-
-### Shortcut.isRegistered
-
-Return whether the shortcut is registered.
-
-[event-emitter]: http://nodejs.org/api/events.html#events_class_events_eventemitter