[Bf-docboard-svn] bf-manual: [9381] trunk/blender_docs/manual: Improve "Keymap" section

Aaron Carlisle noreply at blender.org
Mon Jun 27 16:35:17 CEST 2022 

Revision: 9381
          https://developer.blender.org/rBM9381
Author:   Blendify
Date:     2022-06-27 16:35:16 +0200 (Mon, 27 Jun 2022)
Log Message:
-----------
Improve "Keymap" section

Adds a bunch of clarifications to the "Keymap" section of the manual,
as well as one more small addition for "Getting Started."

Differential Revision: https://developer.blender.org/D15259

Modified Paths:
--------------
    trunk/blender_docs/manual/getting_started/installing/windows.rst
    trunk/blender_docs/manual/interface/keymap/blender_default.rst
    trunk/blender_docs/manual/interface/keymap/introduction.rst

Modified: trunk/blender_docs/manual/getting_started/installing/windows.rst
===================================================================
--- trunk/blender_docs/manual/getting_started/installing/windows.rst	2022-06-27 14:27:52 UTC (rev 9380)
+++ trunk/blender_docs/manual/getting_started/installing/windows.rst	2022-06-27 14:35:16 UTC (rev 9381)
@@ -25,7 +25,9 @@
 
 No start menu item will be created and no blend-file association will be registered,
 but there is also no need for administrator rights. You can register the file association
-manually by running ``blender -r`` from the :doc:`Command Line </advanced/command_line/arguments>`.
+manually by clicking *Make Default* on the System tab of the
+:doc:`Preferences </editors/preferences/system>`. Alternatively, you can run ``blender -r``
+from the :doc:`Command Line </advanced/command_line/arguments>`.
 
 .. tip:: How to Make a Portable Installation
 

Modified: trunk/blender_docs/manual/interface/keymap/blender_default.rst
===================================================================
--- trunk/blender_docs/manual/interface/keymap/blender_default.rst	2022-06-27 14:27:52 UTC (rev 9380)
+++ trunk/blender_docs/manual/interface/keymap/blender_default.rst	2022-06-27 14:35:16 UTC (rev 9381)
@@ -51,7 +51,7 @@
    * - :kbd:`Ctrl-Spacebar`
      - Toggle Maximize Area.
    * - :kbd:`Ctrl-Alt-Spacebar`
-     - Toggle Fullscreen Area
+     - Toggle Fullscreen Area.
    * - :kbd:`Ctrl-PageUp` / :kbd:`Ctrl-PageDown`
      - Next/previous Workspace.
    * - :kbd:`Spacebar`
@@ -107,17 +107,23 @@
    :widths: 10 90
 
    * - :kbd:`Tab`
-     - Edit-mode toggle.
+     - Toggle Edit mode.
    * - :kbd:`Ctrl-Tab`
-     - Mode switching pie menu (toggles Pose Mode for armatures).
+     - Toggle Pose mode for armatures, or show a mode switching pie menu for others.
    * - :kbd:`1` - :kbd:`3`
-     - Edit mesh vertex/edge/face toggle (:kbd:`Shift` extends, :kbd:`Ctrl` expands & contracts).
+     - In Edit Mode, switch between editing vertices (:kbd:`1`), edges (:kbd:`2`), or faces (:kbd:`3`).
+
+       Hold :kbd:`Shift` to toggle one of these without disabling the others.
+
+       Hold :kbd:`Ctrl` to alter how the selection is transformed from the old mode to the new.
+       
+       See :doc:`Mesh Selection Modes </modeling/meshes/selecting/introduction>` for details.
    * - :kbd:`AccentGrave`
-     - 3D Viewport navigation pie menu.
+     - Show 3D Viewport navigation pie menu.
    * - :kbd:`Ctrl-AccentGrave`
      - Toggle gizmos.
    * - :kbd:`Shift-AccentGrave`
-     - Walk/Fly Navigation.
+     - Start Walk/Fly Navigation.
 
 
 Platform Specific Keys
@@ -146,9 +152,9 @@
 .. _keymap-blender_default-prefs-select_with:
 
 Select with Mouse Button
-   Controls which mouse button, either right or left, is used to select items in Blender.
-   If *Left* is selected the :kbd:`RMB` will be a context sensitive menu,
-   if *Right* is selected the :kbd:`LMB` will place the 3D Cursor.
+   Controls which mouse button, either left or right, is used to select items in Blender.
+   If *Left* is selected, the :kbd:`RMB` will be a context sensitive menu.
+   If *Right* is selected, the :kbd:`LMB` will place the 3D Cursor.
 
 .. _keymap-blender_default-spacebar_action:
 
@@ -157,8 +163,8 @@
    These and other shortcuts can be modified in the :doc:`keymap preferences </editors/preferences/keymap>`.
 
    :Play:
-      Starts playing through the :doc:`Timeline </editors/timeline>`,
-      this option is good for animation or video editing work.
+      Starts playing through the :doc:`Timeline </editors/timeline>`.
+      This option is good for animation or video editing work.
    :Tools:
       Opens the Toolbar underneath the cursor to quickly change the active tool.
       This option is good if you are doing a lot of modeling or rigging work.
@@ -171,9 +177,10 @@
    This option is only available when Left click *Select with Mouse Button* is chosen.
 
    :Press:
-      Allows immediate activation, preventing click events being passed to the tool.
+      The gizmo's operation gets initiated (and additional options become available in the Status Bar)
+      the moment you press down the mouse button on the gizmo.
    :Drag:
-      Allows click events to pass through to the tool, adding a small delay.
+      The operation only gets initiated once you start dragging the gizmo.
 
 Right Mouse Select Action
    The default action for the right mouse button.
@@ -190,12 +197,14 @@
 
 Alt Click Tool Prompt
    Tapping :kbd:`Alt` shows a prompt in the status bar prompting a second keystroke to activate the tool.
-   Note this option is not available when using :ref:`Emulate 3 Button Mouse <preferences-input-emulate-mouse>`.
+   Note that this option is not available when using :ref:`Emulate 3 Button Mouse <preferences-input-emulate-mouse>`.
 
 Alt Tool Access
    Hold :kbd:`Alt` to use the :doc:`Active Tool </interface/tool_system>` when the gizmo would normally be required.
-   This option is only available when Left click *Select with Mouse Button* is chosen.
-   Note this option is not available when using :ref:`Emulate 3 Button Mouse <preferences-input-emulate-mouse>`.
+   (For example, with the Move tool selected, you can hold :kbd:`Alt` and drag the mouse anywhere in the viewport
+   to move the selected object, rather than having to drag its gizmo.)
+   This option is only available when *Select with Mouse Button* is set to Left click
+   and :ref:`Emulate 3 Button Mouse <preferences-input-emulate-mouse>` is disabled.
 
 Alt Cursor Access
    Hold :kbd:`Alt-LMB` to place the Cursor (instead of :kbd:`LMB`), allows tools to activate on press
@@ -214,6 +223,9 @@
       Navigation pie menu, useful on systems without a numeric keypad.
    :Gizmos:
       Transform gizmos pie menu, useful for quickly switching between transform gizmos.
+      Note that this doesn't apply to tools that force a certain gizmo (Move, Rotate, Scale
+      and Transform); if you have such a tool selected, the gizmo will stay the same
+      no matter what you choose in the pie menu.
 
 Middle Mouse Action
    The action when :kbd:`MMB` dragging in the viewport, this also applies to trackpads.

Modified: trunk/blender_docs/manual/interface/keymap/introduction.rst
===================================================================
--- trunk/blender_docs/manual/interface/keymap/introduction.rst	2022-06-27 14:27:52 UTC (rev 9380)
+++ trunk/blender_docs/manual/interface/keymap/introduction.rst	2022-06-27 14:35:16 UTC (rev 9381)
@@ -44,11 +44,12 @@
 
 .. note::
 
-   Blender's default key-map has two main interaction modes left-click-select & right-click-select.
+   Blender has two main selection modes: left-click select and right-click select.
    See the :ref:`Select with Mouse Button <keymap-blender_default-prefs-select_with>` preference.
 
-   While :kbd:`LMB` select is default, both are fully supported and there are advantages with :kbd:`RMB` selection,
-   see: `Learn the benefits of right-click-select <https://vimeo.com/76335056>`__.
+   While left-click select is the default as it's the most common in other applications,
+   right-click select does have its advantages.
+   See: `Learn the benefits of right-click select <https://vimeo.com/76335056>`__.
 
 
 Hovering
@@ -95,14 +96,14 @@
 Python Scripting
 ----------------
 
-- :kbd:`Ctrl-C` -- Over any :ref:`ui-operator-buttons` copies their Python command into the clipboard.
+- :kbd:`Ctrl-C` over any :ref:`ui-operator-buttons` copies their Python command into the clipboard.
 
   This can be used in the Python Console or in the Text editor when writing scripts.
-- :kbd:`Shift-Ctrl-C` -- Over property buttons copies their data path for this property
+- :kbd:`Shift-Ctrl-C` over property buttons copies their data path for this property
   (also available from the context menu).
 
   Useful when writing drivers or scripts.
-- :kbd:`Shift-Ctrl-Alt-C` -- Over property buttons copies their *full* data path for the data-block and property.
+- :kbd:`Shift-Ctrl-Alt-C` over property buttons copies their *full* data path for the data-block and property.
 
   Note that in most cases it is best to access values based on the context, instead of by name.

More information about the Bf-docboard-svn mailing list