[Bf-docboard-svn] bf-manual: [8445] trunk/blender_docs/manual/modeling/meshes/tools/knife.rst: Update Knife Tool documentation for 3.0 changes from GSoC project

[Howard Trickey]

Revision: 8445
          https://developer.blender.org/rBM8445
Author:   howardt
Date:     2021-10-01 16:17:40 +0200 (Fri, 01 Oct 2021)
Log Message:
-----------
Update Knife Tool documentation for 3.0 changes from GSoC project

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/meshes/tools/knife.rst

Modified: trunk/blender_docs/manual/modeling/meshes/tools/knife.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/tools/knife.rst	2021-09-28 21:25:20 UTC (rev 8444)
+++ trunk/blender_docs/manual/modeling/meshes/tools/knife.rst	2021-10-01 14:17:40 UTC (rev 8445)
@@ -25,6 +25,9 @@
 Surrounding red squares mean that there is a cut already in that position,
 so no additional vertex will be created (besides the first one).
 
+If multiple objects are selected before entering Edit mode,
+then knife cuts will affect all of those objects.
+
 .. list-table::
 
    * - .. figure:: /images/modeling_meshes_tools_knife_line-before.png
@@ -49,7 +52,19 @@
 Only Selected :kbd:`Shift-K`
    Only cuts through selected geometry.
 
+X-Ray
+   Show cut points on non-visible geometry too, when Occlude Geometry is off.
 
+Measurement
+   Which visible measurements to show: a choice of *Distance*, *Angle*, *None*, or *Both*.
+
+Angle snapping
+   Whether or not dragged lines should be contrained to particular angles, and if so,
+   which coordinate system the angle is relative to. A choice of *None*, *Screen*, or *Relative*.
+
+Angle snapping increment
+   When angle snapping is on, the angle will be constrained to a multiple of this angle.
+
 Controls
 ========
 
@@ -57,7 +72,7 @@
    Confirms the cut.
    :kbd:`Return` will leave selected every edge except the new edges created from the cut.
 
-Cancel :kbd:`RMB`
+Cancel :kbd:`ESC`
    Cancels the cut.
 
 Draw a Continuous Line :kbd:`LMB` drag.
@@ -67,7 +82,7 @@
 Close Loop double-click :kbd:`LMB`
    This is a quick way to close the loop you are currently cutting.
 
-New Cut :kbd:`E`
+New Cut :kbd:`RMB`
    Begins a new cut. This allows you to define multiple distinct cut lines.
    If multiple cuts have been defined, they are recognized as new snapping points.
 
@@ -81,19 +96,25 @@
 
              Result of starting new cuts while in the tool.
 
-Midpoint Snap :kbd:`Ctrl`
+Midpoint Snap :kbd:`Shift`
    Hold to snap the cursor to the midpoint of edges,
    meaning that all cuts will be performed at the exact center of each cut edge.
 
-Ignore Snap :kbd:`Shift`
+Ignore Snap :kbd:`Ctrl`
    Hold to make the tool ignore snapping,
    unlike the default where mouse cursor snaps to near edges.
 
-Cut Through: :kbd:`Z`
+Cut Through: :kbd:`C`
    Allow the Cut tool to cut through to obscured faces, instead of only the visible ones.
 
-Angle Constrain :kbd:`C`
-   Constrains the cut to 45 degree increments.
+Angle Constrain :kbd:`A`
+   Constrains the cut line to certain degree increments.
+   The increment can be specified in the Tool Settings (see above), or can be typed
+   when angle constraining is active.
+   The default angles are in the plane of the screen, but typing :kbd:`A` again
+   makes it relative to the last cut edge.
+   If the last cut edge is ambiguous (because the cut was on a vertex),
+   typing :kbd:`R` cyles through the possible reference edges.
 
    .. list-table::
 
@@ -107,7 +128,25 @@
 
              Result of constraining cut angle.
 
+Axis Constrain :kbd:`X`, :kbd:`Y`, or :kbd:`Z`
+   Constrains the cut line to one of the coordinate system axes.
+   Intitially it will be the global axis with the given name,
+   but pressing the same key again switches to the Object's local axis system.
+   Additionally, the if the scene transformation orientation is set to some
+   custom orientation (say, from a face), the constraints will be in that coordinate system.
 
+Visible Measurements :kbd:`S`
+   Shows measurements of the cuts being made: angles with respect to a mesh edge, lengths, or both.
+   Pressing :kbd:`S` repeatedly cycles between what can be shown:
+   *Only Distance*, *Only Angles*, *Both*, or *None*.
+
+Undo :kbd:`Ctrl-Z`
+   Undoes the previous cut segment. The starting point for the next cut is adjusted accordingly.
+   If a cut is a drag cut, the entire drag cut is undone.
+
+X-Ray Mode :kbd:`V`
+   Toggles whether or not cuts to segments behind the visible geometry are shown.
+
 Known Limitations
 =================