[Bf-docboard-svn] bf-manual: [8540] trunk/blender_docs/manual: Update: proxies.

[Bastien Montagne]

Revision: 8540
          https://developer.blender.org/rBM8540
Author:   mont29
Date:     2021-10-27 15:54:53 +0200 (Wed, 27 Oct 2021)
Log Message:
-----------
Update: proxies.

Proxies are officially deprectaed in Blender 3.0, update their page accordingly.

Also add doc for the experimental option `Proxy to Override Auto Conversion`.

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/preferences/experimental.rst
    trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst

Modified: trunk/blender_docs/manual/editors/preferences/experimental.rst
===================================================================
--- trunk/blender_docs/manual/editors/preferences/experimental.rst	2021-10-27 11:42:50 UTC (rev 8539)
+++ trunk/blender_docs/manual/editors/preferences/experimental.rst	2021-10-27 13:54:53 UTC (rev 8540)
@@ -20,3 +20,7 @@
 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.
+
+Proxy to Override Auto Conversion
+   Enables conversion of proxies to library overrides on file load.
+   Disable if you want to keep existing proxies, and deal with their conversion yourself.

Modified: trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst
===================================================================
--- trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst	2021-10-27 11:42:50 UTC (rev 8539)
+++ trunk/blender_docs/manual/files/linked_libraries/library_proxies.rst	2021-10-27 13:54:53 UTC (rev 8540)
@@ -6,50 +6,22 @@
 Proxies
 *******
 
-Proxies are the historical way in Blender to allow some local editing of linked data-blocks.
-This is mostly aimed at character animation.
+Proxies were the historical way in Blender to allow some local editing of linked data-blocks.
+This was mostly aimed at character animation.
 
-One of their most important restrictions is that you can only have one proxy
-of any linked object in a given blend-file.
-
-A new system, more powerful and flexible, is currently being implemented:
+They are now fully deprecated as of Blender 3.0, replaced by the new
 :doc:`Library Overrides </files/linked_libraries/library_overrides>`.
 
+Existing proxies in older .blend files will be converted to library overrides when
+opening it in Blender 3.0.
 
-Make Proxy
-==========
+.. note::
 
-.. reference::
+   It is currently possible to keep existing proxies when opening an older .blend file,
+   by disabling the :doc:`Proxy to Override Auto Conversion </editors/preferences/experimental>`
+   experimental option in the Preferences.
+   
+   Existing Proxies will still work as expected in Blender 3.0.
+   
+   Removal of this option and the full proxy code is scheduled for Blender 3.1.
 
-   :Editor:    3D Viewport
-   :Mode:      Object Mode
-   :Menu:      :menuselection:`Object --> Relations --> Make Proxy...`
-
-This makes the active linked object into a local proxy, appending "_proxy" to its name.
-It allows you to make changes locally over an object (or collection) linked from an external library.
-
-Possible changes are restricted, you can mainly edit and animate transformations of the proxy object,
-and its constraints.
-Those changes remain local, they are not sent back to the external library.
-
-.. hint::
-
-   Another way to transform a linked object locally is with
-   the use of :doc:`Collection Instancing </scene_layout/object/properties/instancing/collection>`.
-   Instead of linking objects directly, it is often more useful to link in *collections*,
-   which can be assigned to empties and moved, while maintaining the link to the original file.
-
-   It is also useful to be able to add/remove objects from the collection (from within the library blend-file)
-   without having to manage re-linking of multiple objects.
-
-
-Proxy Armatures
----------------
-
-On rigged models, proxy objects allow you to edit and animate their poses.
-
-It is also possible, in the source (library) blend-file, to protect some bone layers from being editable in proxies.
-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 <bpy.types.Armature.layers>`.