[Bf-docboard-svn] bf-manual: [8696] trunk/blender_docs/manual: Assets: document Clear Asset operators

[Sybren A. Stüvel]

Revision: 8696
          https://developer.blender.org/rBM8696
Author:   sybren
Date:     2021-11-26 17:03:31 +0100 (Fri, 26 Nov 2021)
Log Message:
-----------
Assets: document Clear Asset operators

Modified Paths:
--------------
    trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
    trunk/blender_docs/manual/files/asset_libraries/introduction.rst
    trunk/blender_docs/manual/files/data_blocks.rst
    trunk/blender_docs/manual/scene_layout/object/editing/asset.rst

Modified: trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst	2021-11-26 15:46:16 UTC (rev 8695)
+++ trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst	2021-11-26 16:03:31 UTC (rev 8696)
@@ -242,6 +242,7 @@
 used in the pose. This can be used to create a selection set, or simply to
 remind yourself what was part of the pose and what wasn’t.
 
+.. _pose-library-from-viewport:
 
 Use from 3D Viewport
 --------------------

Modified: trunk/blender_docs/manual/files/asset_libraries/introduction.rst
===================================================================
--- trunk/blender_docs/manual/files/asset_libraries/introduction.rst	2021-11-26 15:46:16 UTC (rev 8695)
+++ trunk/blender_docs/manual/files/asset_libraries/introduction.rst	2021-11-26 16:03:31 UTC (rev 8696)
@@ -180,12 +180,38 @@
 
 Assets can be used from the :doc:`/editors/asset_browser`.
 
-.. TODO::
+The pose library extends this, and adds an Asset View to the 3D Viewport. See
+:ref:`pose-library-from-viewport`.
 
-   Add documentation for / link to docs of the Asset View, which is used in the
-   pose library.
 
+.. _bpy.ops.asset.clear:
+.. _assets-clear-set-fake-user:
 
+Removing Assets
+---------------
+
+Asset metadata can be erased by the *Clear Asset* operator. This operator is
+available in data-block selectors, the Asset Browser, and for Objects in the 3D
+Viewport menu.
+
+.. figure:: /images/asset_browser-clear-asset.png
+
+   *Clear Asset* in the Asset Browser.
+
+Clear Asset
+   Removes the asset metadata (catalog, description, author, preview, tags),
+   effectively turning an asset into a regular data-block. As such, the same
+   removal rules apply as with other data-blocks. For example, if a mesh object
+   is still placed in the scene, *Clear Asset* will not remove it from the
+   scene. See :ref:`data-system-datablock-life-time`.
+
+Clear Asset (Set Fake User)
+   Performs the same operation as *Clear Asset*, and then marks the data-block
+   as :ref:`protected <data-system-datablock-fake-user>`. This makes it possible
+   to no longer have the data-block marked as asset, and still be sure it is
+   not lost when saving the blend file.
+
+
 .. _asset-libraries-design-limitations:
 
 Design Limitations

Modified: trunk/blender_docs/manual/files/data_blocks.rst
===================================================================
--- trunk/blender_docs/manual/files/data_blocks.rst	2021-11-26 15:46:16 UTC (rev 8695)
+++ trunk/blender_docs/manual/files/data_blocks.rst	2021-11-26 16:03:31 UTC (rev 8696)
@@ -255,6 +255,8 @@
        | Used by each window, which has its own workspace.
 
 
+.. _data-system-datablock-life-time:
+
 Life Time
 =========
 

Modified: trunk/blender_docs/manual/scene_layout/object/editing/asset.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/asset.rst	2021-11-26 15:46:16 UTC (rev 8695)
+++ trunk/blender_docs/manual/scene_layout/object/editing/asset.rst	2021-11-26 16:03:31 UTC (rev 8696)
@@ -3,7 +3,7 @@
 Asset
 *****
 
-Todo Asset Browser.
+Operations for managing the :term:`Asset` status of an object.
 
 Mark as Asset
 =============