[Bf-docboard-svn] bf-manual: [8087] branches/blender-2.93-release/blender_docs/manual: Overrides: Resync updates

[Aaron Carlisle]

Revision: 8087
          https://developer.blender.org/rBM8087
Author:   Blendify
Date:     2021-05-25 20:33:23 +0200 (Tue, 25 May 2021)
Log Message:
-----------
Overrides: Resync updates

rB74557ca4f7cfe14090d6ca245e03e651b4b2524f
rBf707783d5f9fedbe2503d841bc8a74bed6092cdb

Modified Paths:
--------------
    branches/blender-2.93-release/blender_docs/manual/editors/preferences/experimental.rst
    branches/blender-2.93-release/blender_docs/manual/files/linked_libraries/library_overrides.rst

Modified: branches/blender-2.93-release/blender_docs/manual/editors/preferences/experimental.rst
===================================================================
--- branches/blender-2.93-release/blender_docs/manual/editors/preferences/experimental.rst	2021-05-25 14:39:31 UTC (rev 8086)
+++ branches/blender-2.93-release/blender_docs/manual/editors/preferences/experimental.rst	2021-05-25 18:33:23 UTC (rev 8087)
@@ -16,3 +16,7 @@
 
 Cycles Debug
    Show the Cycles rendering :doc:`Debug Panel </render/cycles/render_settings/debug>`.
+
+Override Auto Resync
+   Enables library overrides automatic resync detection and process on file load.
+   Disable when dealing with older blend-files that need manual Resync (Enforce) handling.

Modified: branches/blender-2.93-release/blender_docs/manual/files/linked_libraries/library_overrides.rst
===================================================================
--- branches/blender-2.93-release/blender_docs/manual/files/linked_libraries/library_overrides.rst	2021-05-25 14:39:31 UTC (rev 8086)
+++ branches/blender-2.93-release/blender_docs/manual/files/linked_libraries/library_overrides.rst	2021-05-25 18:33:23 UTC (rev 8087)
@@ -3,11 +3,10 @@
 Library Overrides
 *****************
 
-Library Overrides is a system designed to replace and
-supersede :doc:`Proxies </files/linked_libraries/library_proxies>`.
-Most types of linked data-blocks can be overridden, and the properties of those overrides
-can then be edited. When the library data changes, unmodified properties of the overridden one
-will be updated accordingly.
+Library Overrides is a system designed to replace and supersede
+:doc:`Proxies </files/linked_libraries/library_proxies>`.
+Most types of linked data-blocks can be overridden, and the properties of those overrides can then be edited.
+When the library data changes, unmodified properties of the overridden one will be updated accordingly.
 
 .. note::
 
@@ -92,6 +91,19 @@
 This operator is used to help convert older blend-files to the new override system.
 
 
+Syncing Overrides
+=================
+
+The relationships between linked data-blocks can be changed resulting in outdated overrides
+When this happens overrides need to be resynced to match the new structure.
+Overrides are automatically resynced when opening blend-files, however,
+overrides can be resynced manually using `Resync Library Override Hierarchy`_.
+
+.. tip::
+
+   Auto resyncing can be disabled in the :doc:`Experimental Preferences </editors/preferences/experimental>`.
+
+
 Editing an Override
 ===================
 
@@ -205,6 +217,25 @@
    if the deletion is undesirable the resync can be undone before saving the blend-file.
 
 
+Resync Library Override Hierarchy Enforce
+=========================================
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Editor:    Outliner
+   :Mode:      Object Mode
+   :Outliner:  :menuselection:`Context Menu --> ID Data --> Resync Library Override Hierarchy Enforce`
+
+In some cases, especially with older blend-files that were saved with 'broken' (non-hierarchy-matching) overrides,
+a regular resync itself cannot rebuild properly the override as expected (some objects might go missing e.g.).
+To solve this issue, this operator rebuilds the local override from its linked reference,
+as well as its hierarchy of dependencies, enforcing that hierarchy to match the linked data
+(i.e. ignoring exiting overrides on data-blocks properties).
+This is similar to a regular resync but is more aggressive resync,
+at the cost of a potential loss of some overrides on ID pointers properties.
+
+
 Delete Library Override Hierarchy
 =================================