From aca19dc6a76dff950c027ed586ab2faf6bab3b8a 2013-08-01 05:49:16
From: Paul Ivanov <pi@berkeley.edu>
Date: 2013-08-01 05:49:16
Subject: [PATCH] add keyboard shortcut to docs, closes #2960

---

diff --git a/docs/source/interactive/notebook.rst b/docs/source/interactive/notebook.rst
index 42e1bda..ae5dbef 100644
--- a/docs/source/interactive/notebook.rst
+++ b/docs/source/interactive/notebook.rst
@@ -351,31 +351,30 @@ afresh.
 
 Keyboard shortcuts
 ~~~~~~~~~~~~~~~~~~
-All actions in the notebook can be achieved with the mouse, but keyboard 
-shortcuts are also available for the most common ones, so that productive use 
-of the notebook can be achieved with minimal mouse usage. The main shortcuts 
+All actions in the notebook can be performed with the mouse, but keyboard 
+shortcuts are also available for the most common ones. The essential shortcuts
 to remember are the following:
 
-* :kbd:`Shift-Enter`: 
-
+* :kbd:`Shift-Enter`:  run cell
     Execute the current cell, show output (if any), and jump to the next cell 
     below. If :kbd:`Shift-Enter` is invoked on the last input cell, a new code 
     cell will also be created. Note that in the notebook, typing :kbd:`Enter` 
     on its own *never* forces execution, but rather just inserts a new line in 
-    the current input cell. In the Notebook it is thus always necessary to use 
-    :kbd:`Shift-Enter` to execute the cell (or use the ``Cell | Run`` menu 
-    item).
+    the current input cell. :kbd:`Shift-Enter` is equivalent to clicking the 
+    ``Cell | Run`` menu item.
 
-* :kbd:`Ctrl-Enter`: 
+* :kbd:`Ctrl-Enter`: run cell in-place
     Execute the current cell as if it were in "terminal mode", where any 
-    output is shown, but the cursor *remains* in the current cell. This is 
-    convenient for doing quick experiments in place, or for querying things 
-    like filesystem content, without needing to create additional cells that 
-    you may not want to be saved in the notebook.
-
-* :kbd:`Alt-Enter`: 
+    output is shown, but the cursor *remains* in the current cell. The cell's
+    entire contents are selected after execution, so you can just start typing
+    and only the new input will be in the cell. This is convenient for doing
+    quick experiments in place, or for querying things like filesystem
+    content, without needing to create additional cells that you may not want
+    to be saved in the notebook.
+
+* :kbd:`Alt-Enter`: run cell, insert below
     Executes the current cell, shows the output, and inserts a *new* input 
-    cell between the current cell and the adjacent cell (if one exists). This  
+    cell between the current cell and the cell below (if one exists). This  
     is thus a shortcut for the sequence :kbd:`Shift-Enter`, :kbd:`Ctrl-m a`.
     (:kbd:`Ctrl-m a` adds a new cell above the current one.)
   
@@ -384,6 +383,46 @@ to remember are the following:
   followed by a single letter or character. For example, if you type 
   :kbd:`Ctrl-m h` (that is, the sole letter :kbd:`h` after :kbd:`Ctrl-m`), 
   IPython will show you all the available keyboard shortcuts.
+
+
+..
+    TODO: these live in IPython/html/static/notebook/js/quickhelp.js
+    They were last updated for IPython 1.0 release, so update them again for
+    future releases.
+
+Here is the complete set of keyboard shortcuts available:
+
+============  ==========================
+**Shortcut**        **Action**
+------------  --------------------------
+Shift-Enter    run cell
+Ctrl-Enter     run cell in-place
+Alt-Enter      run cell, insert below
+Ctrl-m x       cut cell
+Ctrl-m c       copy cell
+Ctrl-m v       paste cell
+Ctrl-m d       delete cell
+Ctrl-m z       undo last cell deletion
+Ctrl-m -       split cell
+Ctrl-m a       insert cell above
+Ctrl-m b       insert cell below
+Ctrl-m o       toggle output
+Ctrl-m O       toggle output scroll
+Ctrl-m l       toggle line numbers
+Ctrl-m s       save notebook
+Ctrl-m j       move cell down
+Ctrl-m k       move cell up
+Ctrl-m y       code cell
+Ctrl-m m       markdown cell
+Ctrl-m t       raw cell
+Ctrl-m 1-6     heading 1-6 cell
+Ctrl-m p       select previous
+Ctrl-m n       select next
+Ctrl-m i       interrupt kernel
+Ctrl-m .       restart kernel
+Ctrl-m h       show keyboard shortcuts
+============  ==========================
+
    
 
 Magic commands