[Bf-docboard-svn] bf-manual: [7002] trunk/blender_docs/manual: Cleanup: Armature Layers

[Aaron Carlisle]

Revision: 7002
          https://developer.blender.org/rBM7002
Author:   Blendify
Date:     2020-08-28 01:41:35 +0200 (Fri, 28 Aug 2020)
Log Message:
-----------
Cleanup: Armature Layers

Modified Paths:
--------------
    trunk/blender_docs/manual/animation/armatures/bones/editing/change_layers.rst
    trunk/blender_docs/manual/animation/armatures/properties/skeleton.rst
    trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst

Modified: trunk/blender_docs/manual/animation/armatures/bones/editing/change_layers.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/bones/editing/change_layers.rst	2020-08-27 22:18:08 UTC (rev 7001)
+++ trunk/blender_docs/manual/animation/armatures/bones/editing/change_layers.rst	2020-08-27 23:41:35 UTC (rev 7002)
@@ -3,6 +3,8 @@
 Change Layers
 *************
 
+.. _bpy.ops.armature.armature_layers:
+
 Change Armature Layers
 ======================
 
@@ -12,9 +14,17 @@
    :Mode:      Edit Mode
    :Menu:      :menuselection:`Armature --> Change Armature Layers`
 
-Todo.
+Each armature has 32 :ref:`Layers <bpy.types.Armature.layers>`
+to organize armatures by "regrouping" them into sets of bones.
+only bones in active layers will be visible/editable, but they will always be effective
+(i.e. move objects or deform geometry), whether in an active layer or not.
+This operator changes which layers are visible in the 3D Viewport.
+To show several layers at once, :kbd:`Shift-LMB` on the desired layers to view.
+To move bones to a given layer, use :ref:`bpy.ops.armature.bone_layers`.
 
 
+.. _bpy.ops.armature.bone_layers:
+
 Change Bone Layers
 ==================
 
@@ -23,5 +33,6 @@
 
    :Mode:      Edit Mode
    :Menu:      :menuselection:`Armature --> Change Bone Layers`
+   :Hotkey:    :kbd:`M`
 
 Todo.

Modified: trunk/blender_docs/manual/animation/armatures/properties/skeleton.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/properties/skeleton.rst	2020-08-27 22:18:08 UTC (rev 7001)
+++ trunk/blender_docs/manual/animation/armatures/properties/skeleton.rst	2020-08-27 23:41:35 UTC (rev 7002)
@@ -15,51 +15,32 @@
 
 In this panel you can arrange sets of bones into different layers for easier manipulation.
 
+.. _bpy.types.Armature.pose_position:
 
-Position
-========
+Pose Position
+   A radio button to switch between Pose Position and Rest Position.
 
-A radio button to switch between Pose Position and Rest Position.
+   In *Edit Mode*, you always see armatures in their rest position,
+   in *Object Mode* and *Pose Mode*, by default, you see them in *Pose Position*
+   (i.e. as it was transformed in the *Pose Mode*).
+   If you want to see it in the rest position in all modes, select *Rest Position*.
 
-Whereas in *Edit Mode*, you always see your armature in its rest position,
-in *Object Mode* and *Pose Mode* you see it by default in its *Pose Position*
-(i.e. as it was transformed in the *Pose Mode*).
-If you want to see it in the rest position in all modes,
-enable the *Rest Position* button in the *Armature* tab (*Edit Mode*).
+.. _bpy.types.Armature.layers:
 
-
-.. _armature-layers:
-
 Armature Layers
-===============
+   Each armature has 32 layers to organize armatures by "regrouping" them into sets of bones.
+   only bones in active layers will be visible/editable, but they will always be effective
+   (i.e. move objects or deform geometry), whether in an active layer or not.
+   This property changes which layers are visible in the 3D Viewport.
+   To show several layers at once, :kbd:`Shift-LMB` on the desired layers to view.
+   To move bones to a given layer, use :ref:`bpy.ops.armature.bone_layers`.
 
-Each armature has 32 "Armature layers" which allow you to organize your armature by
-"regrouping" sets of bones into layers; this works similar to scene layers
-(those containing your objects). You can then "move" a bone to a given layer,
-hide or show one or several layers, etc.
+.. _bpy.types.Armature.layers_protected:
 
-
-Showing/Hiding Bone Layers
---------------------------
-
-Only bones in active layers will be visible/editable, but they will always be effective
-(i.e. move objects or deform geometry), whether in an active layer or not.
-To (de)activate a layer, you have several options, depending in which mode you are in:
-
-- In all modes, use the row of small buttons at the top of the *Display Options* group, *Armature* panel.
-  If you want to enable/disable several layers at once, as usual, hold :kbd:`Shift` while clicking...
-- In *Edit Mode* and *Pose Mode*, you can also do this from the *3D View*,
-  either by using the menu :menuselection:`Armature --> Switch Armature Layers` or
-  :menuselection:`Pose --> Switch Armature Layers`, or the :kbd:`Shift-M` shortcut,
-  to display a small pop-up menu containing the same buttons as described above
-  (here again, you can use :kbd:`Shift-LMB` clicks to (de)select several layers at once).
-
-
 Protected Layers
-----------------
+   You can lock a given bone layer for all :ref:`proxies <object-proxy>`
+   of your armature, i.e. all bones in this layer will not be editable.
 
-You can lock a given bone layer for all :ref:`proxies <object-proxy>`
-of your armature, i.e. all bones in this layer will not be editable.
-To do so, in the *Skeleton* panel, :kbd:`Ctrl-LMB` click on the relevant button, the layer lock will be enabled.
+   .. note::
 
-Protected layers in proxy are restored to proxy settings on file reload and undo.
+      *Protected Layers* in proxy are restored to proxy settings on file reload and undo.

Modified: trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst
===================================================================
--- trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst	2020-08-27 22:18:08 UTC (rev 7001)
+++ trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst	2020-08-27 23:41:35 UTC (rev 7002)
@@ -53,4 +53,4 @@
 This helps keeping complex rigs usage sensible, by only exposing some 'public' bone layers as editable by users.
 
 Set the *Protected Layers* in the source file using the *Skeleton* panel of the *Armatures* properties.
-See :ref:`Armature Layers <armature-layers>`.
+See :ref:`Armature Layers <bpy.types.Armature.layers>`.