[Bf-docboard-svn] bf-manual: [8230] trunk/blender_docs/manual/animation/armatures/posing: Cleanup and deduplicate auto ik documentation

[Aaron Carlisle]

Revision: 8230
          https://developer.blender.org/rBM8230
Author:   Blendify
Date:     2021-07-24 02:28:39 +0200 (Sat, 24 Jul 2021)
Log Message:
-----------
Cleanup and deduplicate auto ik documentation

Fixes: T89020

Modified Paths:
--------------
    trunk/blender_docs/manual/animation/armatures/posing/bone_constraints/inverse_kinematics/introduction.rst
    trunk/blender_docs/manual/animation/armatures/posing/tool_settings.rst

Modified: trunk/blender_docs/manual/animation/armatures/posing/bone_constraints/inverse_kinematics/introduction.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/posing/bone_constraints/inverse_kinematics/introduction.rst	2021-07-23 22:05:41 UTC (rev 8229)
+++ trunk/blender_docs/manual/animation/armatures/posing/bone_constraints/inverse_kinematics/introduction.rst	2021-07-24 00:28:39 UTC (rev 8230)
@@ -3,10 +3,10 @@
 Introduction
 ************
 
-IK simplifies the animation process,
+Inverse Kinematics (IK) simplifies the animation process,
 and makes it possible to make more advanced animations with lesser effort.
 
-IK allows you to position the last bone in a bone chain and
+Inverse Kinematics allow you to position the last bone in a bone chain and
 the other bones are positioned automatically.
 This is like how moving someone's finger would cause their arm to follow it.
 By normal posing techniques, you would have to start from the root bone,
@@ -17,43 +17,11 @@
 
 This effort is effectively avoided by use of IK.
 
+IK is mostly done with bone constraints although there is also a simple
+:ref:`bpy.types.Pose.use_auto_ik` feature in pose mode.
+They work by the same method but the constraints offer more options and control.
+Please refer to the following pages for details about these constraints:
 
-Automatic IK
-============
-
-.. reference::
-
-   :Mode:      Pose Mode
-   :Panel:     :menuselection:`Sidebar region --> Tool --> Pose Options`
-
-Automatic IK is a tool for quick posing, it can be enabled in the Toolbar in the 3D Viewport,
-when in Pose Mode. When the Auto IK option is enabled, translating a bone will activate
-inverse kinematics and rotate the parent bone, and the parent's parent, and so on, to
-follow the selected bone. The IK chain can only extend from a child to a parent bone
-if the child is *connected* to it.
-
-The length of the chain is increased
-(if there is a connected parent available to add to it)
-with :kbd:`Ctrl-PageUp` or :kbd:`Ctrl-WheelDown`,
-and decreased with :kbd:`Ctrl-PageDown` or :kbd:`Ctrl-WheelUp`.
-However, the initial chain length is 0, which effectively
-means follow the connections to parent bones as far as possible, with no length limit.
-So pressing :kbd:`Ctrl-PageUp` the first time sets the chain length to 1 (move only the selected bone),
-and pressing :kbd:`Ctrl-PageDown` at this point sets it back to 0 (unlimited) again.
-Thus, you have to press :kbd:`Ctrl-PageUp` *more than once* from the initial state
-to set a finite chain length greater than 1.
-
-This is a more limited feature than using an IK constraint, which can be configured,
-but it can be useful for quick posing.
-
-
-IK Constraints
-==============
-
-IK is mostly done with bone constraints.
-They work by the same method but offer more choices and settings.
-Please refer to these pages for detail about the settings for the constraints:
-
 - :doc:`IK Solver </animation/constraints/tracking/ik_solver>`
 - :doc:`Spline IK </animation/constraints/tracking/spline_ik>`
 

Modified: trunk/blender_docs/manual/animation/armatures/posing/tool_settings.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/posing/tool_settings.rst	2021-07-23 22:05:41 UTC (rev 8229)
+++ trunk/blender_docs/manual/animation/armatures/posing/tool_settings.rst	2021-07-24 00:28:39 UTC (rev 8230)
@@ -16,12 +16,28 @@
    :Mode:      Pose Mode
    :Panel:     :menuselection:`Sidebar --> Tool --> Pose Options --> Auto IK`
 
-The auto IK option in the Sidebar enables a temporary IK constraint when posing bones.
-The chain acts from the tip of the selected bone to root of the upper-most parent bone.
-Note that this mode lacks options,
-and only works by applying the resulting transform to the bones in the chain.
+Automatic IK is a tool for quick posing, when enabled, translating a bone will activate
+inverse kinematics and rotate the parent bone, and the parent's parent, and so on, to
+follow the selected bone. The IK chain can only extend from a child to a parent bone
+if the child is *connected* to it.
 
+While moving bones, the length of the chain (the number of affected bones)
+can be increased or decreased using keyboard hotkeys.
+Pressing :kbd:`PageUp` will increase in chain length by one
+and :kbd:`PageDown` decreases the length by one.
+The chain length can also be controled with :kbd:`WheelUp` or :kbd:`WheelDown`.
 
+The initial chain length is 0, which effectively means follow
+the connections to parent bones as far as possible, with no length limit.
+So pressing increasing the chain length the first time sets the length to 1 (move only the selected bone),
+and at this point, decreasing the length point sets it back to 0 (unlimited) again.
+Thus, you have to increase the chain length *more than once* from the initial state
+to set a finite chain length greater than 1.
+
+This is a more limited feature than using an IK constraint,
+which can be configured, but it can be useful for quick posing.
+
+
 .. _bpy.types.Pose.use_mirror_x:
 
 X-Axis Mirror