Doc: Describe shortcuts for moving within and between blocks

- Describe the "Enable smart selection changing" option and
  the keyboard shortcuts used.
- Update screen shot.

Change-Id: I6ea08db91d1143c756573e6de8d5a50db994091f
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>

4 files changed, 31 insertions, 9 deletions

diff --git a/doc/images/qtcreator-editor-settings.png b/doc/images/qtcreator-editor-settings.png
index 9766b153f3..583af66502 100644
--- a/doc/images/qtcreator-editor-settings.png
+++ b/doc/images/qtcreator-editor-settings.png
diff --git a/doc/src/editors/creator-editors.qdoc b/doc/src/editors/creator-editors.qdoc
index 35017f9122..bc631612aa 100644
--- a/doc/src/editors/creator-editors.qdoc
+++ b/doc/src/editors/creator-editors.qdoc
@@ -142,6 +142,17 @@
     \uicontrol Tools > \uicontrol Options > \uicontrol {Text Editor} >
     \uicontrol Display and deselect \uicontrol {Animate matching parentheses}.
 
+    You can use keyboard shortcuts to move within and between blocks. To go to
+    block end, press \key {Ctrl+]} and to go to block start, press
+    \key {Ctrl+[}. To also select the lines from the cursor position to the end
+    or beginning of the block, press \key {Ctrl+Shift+]} and
+    \key {Ctrl+Shift+[}, respectively.
+
+    To select the current block, press \key Ctrl+U. A second key press extends
+    the selection to the parent block. To undo the last selection, press
+    \key {Ctrl+Alt+Shift+U}. To enable smart block selection, select
+    \uicontrol Tools > \uicontrol Options > \uicontrol {Text Editor} >
+    \uicontrol Behavior > \uicontrol {Enable smart selection changing}.
 */
 
 
diff --git a/doc/src/howto/creator-keyboard-shortcuts.qdoc b/doc/src/howto/creator-keyboard-shortcuts.qdoc
index 46257783e0..c8fab9e447 100644
--- a/doc/src/howto/creator-keyboard-shortcuts.qdoc
+++ b/doc/src/howto/creator-keyboard-shortcuts.qdoc
@@ -337,11 +337,25 @@
             \li  Go to block start
             \li  Ctrl+[
         \row
-            \li  Go to block end with selection
-            \li  Ctrl+}
+            \li  Go to block end and select the lines between the current cursor
+                 position and the end of the block
+            \li  Ctrl+Shift+]
         \row
-            \li  Go to block start with selection
-            \li  Ctrl+{
+            \li  Go to block start and select the lines between the current
+                 cursor position and the beginning of the block
+            \li  Ctrl+Shift+[
+        \row
+            \li  Select the current block
+
+                 The second press extends the selection to the parent block. To
+                 enable this behavior, select \uicontrol Tools >
+                 \uicontrol Options > \uicontrol {Text Editor} >
+                 \uicontrol Behavior >
+                 \uicontrol {Enable smart selection changing}.
+            \li  Ctrl+U
+        \row
+            \li  Undo the latest smart block selection
+            \li  Ctrl+Alt+Shift+U
         \row
             \li  Move current line down
             \li  Ctrl+Shift+Down
@@ -355,11 +369,6 @@
             \li  Rewrap paragraph
             \li  Ctrl+E, R
         \row
-            \li  Select the current block
-
-               The second press extends the selection to the parent block
-            \li  Ctrl+U
-        \row
             \li  Enable text wrapping
             \li  Ctrl+E, Ctrl+W
         \row
diff --git a/doc/src/projects/creator-projects-settings-editor.qdoc b/doc/src/projects/creator-projects-settings-editor.qdoc
index f1f49b90fb..c2b8a108bd 100644
--- a/doc/src/projects/creator-projects-settings-editor.qdoc
+++ b/doc/src/projects/creator-projects-settings-editor.qdoc
@@ -74,6 +74,8 @@
 
         \li \l{Configuring Fonts}
 
+        \li \l{Highlighting and Folding Blocks}
+
         \li \l{Viewing Function Tooltips}
 
     \endlist