[Bf-docboard-svn] bf-manual: [7810] trunk/blender_docs/manual/files/linked_libraries/library_overrides.rst: Library Overrides: Manual.

[Jeroen Bakker]

Revision: 7810
          https://developer.blender.org/rBM7810
Author:   jbakker
Date:     2021-03-09 08:16:30 +0100 (Tue, 09 Mar 2021)
Log Message:
-----------
Library Overrides: Manual.

Differential: D10642

Modified Paths:
--------------
    trunk/blender_docs/manual/files/linked_libraries/library_overrides.rst

Modified: trunk/blender_docs/manual/files/linked_libraries/library_overrides.rst
===================================================================
--- trunk/blender_docs/manual/files/linked_libraries/library_overrides.rst	2021-03-08 20:35:39 UTC (rev 7809)
+++ trunk/blender_docs/manual/files/linked_libraries/library_overrides.rst	2021-03-09 07:16:30 UTC (rev 7810)
@@ -17,7 +17,7 @@
 
 Library overrides supports:
 
-- Multiple independent overrides of a same linked data (e.g. a whole character).
+- Multiple independent overrides of a same linked data (e.g. having the same character multiple times in the same scene).
 - Adding new modifiers and constraints, anywhere in the stack.
 - Recursively chaining overrides (i.e. link and override overrides from another library file, etc.).
 
@@ -33,9 +33,16 @@
 Creating an Override
 ====================
 
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Relations --> Make Override Library...`
+   :Outliner:  :menuselection:`Context Menu --> ID Data --> Add Library Override Hierarchy`
+               :menuselection:`Context Menu --> ID Data --> Add Library Override`
+
 There are two ways to create an override of a linked data-block.
 
-
 Single Data-Block Override
 --------------------------
 
@@ -46,15 +53,16 @@
 - The data-block menu in the UI (:kbd:`Shift-LMB` on the chain icon to the right),
   in which case only that specific usage will be remapped to the new local override.
 
+.. _bpy.ops.object.make_override_library:
 
-Make Library Override Operator
-------------------------------
+Make Library Override Operator/Add Library Override Hierarchy
+-------------------------------------------------------------
 
-This one operates in the 3D Viewport, over linked objects or local empties instantiating a linked collection
-(typically, a linked character) and can be found at :menuselection:`Object --> Relations --> Make Library Overrides...`.
+This operator goes over linked objects or local empties instantiating a linked collection
+(typically, a linked character).
 
-It will go through the whole hierarchy of collections and objects,
-and override all those needed to allow posing/animation of a character.
+The operator will go through the whole hierarchy
+of collections and objects, and override all those needed to allow posing/animation of a character.
 
 .. note:: Proper Collections Layout Matters
 
@@ -63,8 +71,6 @@
    Otherwise, some won't be automatically overridden, and manual work will be needed to fix the override.
 
 
-.. _bpy.ops.object.convert_proxy_to_override:
-
 Converting Proxies to Library Override
 ======================================
 
@@ -74,7 +80,7 @@
    :Mode:      Object Mode
    :Menu:      :menuselection:`Object --> Relations --> Convert Proxy to Library Override`
 
-Converts older a :doc:`Proxy </files/linked_libraries/library_proxies>` to a local override.
+Converts a :doc:`Proxy </files/linked_libraries/library_proxies>` to a local override.
 This operator is used to help convert older blend-files to the new override system.
 
 
@@ -93,3 +99,99 @@
 Note that you cannot override-edit an existing animation, you'll have to create a new action.
 
 You can manually define or remove an override from the context menu of the relevant property.
+
+.. _bpy.ops.ui.override_type_set_button:
+
+Define Overrides
+----------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Property:  :menuselection:`Context Menu --> Define Overrides`
+               :menuselection:`Context Menu --> Define Override`
+
+Mark a property to be overridden in the local blend file. For array properties
+all elements will be overridden.
+
+Define Single Override
+----------------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Property:  :menuselection:`Context Menu --> Define Single Override`
+
+Mark a property to be overridden in the local blend file. For array properties only
+the selected element will be overridden.
+
+.. _bpy.ops.ui.remove_override_button:
+
+Remove Overrides
+----------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Property:  :menuselection:`Context Menu --> Remove Overrides`
+               :menuselection:`Context Menu --> Remove Override`
+
+Remove the property from the overrides. The value of the linked in data block will be used.
+For array properties all elements will be removed from the override.
+
+Remove Single Override
+----------------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Property:  :menuselection:`Context Menu --> Remove Single Override`
+
+Remove the property from the overrides. The value of the linked in data block will be used.
+For array properties only the selected elements will be removed from the override.
+
+
+Reset Library Override
+======================
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Outliner:  :menuselection:`Context Menu --> ID Data --> Reset Library Override`
+               :menuselection:`Context Menu --> ID Data --> Reset Library Override Hierarchy`
+
+Reset the override to its original values. `Reset Library Override Hierarchy` will also reset
+the overrides of its child data-blocks.
+
+Resync Library Override Hierarchy
+=================================
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Outliner:  :menuselection:`Context Menu --> ID Data --> Resync Library Override Hierarchy`
+
+The structure of the linked data (the relationships between linked data-blocks) can be changed.
+Overrides need to be resynced to match the new structure. This operator will resync the override
+to the new structure in the library.
+
+Delete Library Override Hierarchy
+=================================
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Outliner:  :menuselection:`Context Menu --> ID Data --> Delete Library Override Hierarchy`
+
+Remove the library override from the selected data-block and all its children and replace them with
+the original linked data-block. This will revert the `Make Library Override`.
+
+.. _bpy.ops.object.convert_proxy_to_override:
+