manual/files/data_blocks.rst

@@ -101,7 +101,7 @@ Pack
    * - :doc:`Brush </sculpt_paint/brush/index>`
      - |tick|
      - |none|
-     - Used by paint tools.
+     - Used as brush assets in sculpt and paint modes.
    * - :doc:`Camera </render/cameras>`
      - |tick|
      - |none|

manual/sculpt_paint/brush/brush_management.rst

@@ -1,6 +1,6 @@
-****************
-Brush Management
-****************
+**************
+Manage Brushes
+**************
 
 Brush assets are stored in :doc:`asset libraries </files/asset_libraries/introduction>` to make them accesible from
 any Blender session. There are two ways of managing brush assets:
@@ -17,6 +17,9 @@ any Blender session. There are two ways of managing brush assets:
 Asset Operators
 ===============
 
+Note that only assets created via :ref:`Duplicate Asset... <bpy.ops.brush.asset_save_as>` can be edited using these
+operators. For others (including brush assets bundled in the Essentials library), these operations will be grayed out.
+
 .. reference::
 
    :Mode:      All Paint Modes
@@ -30,32 +33,34 @@ Asset Operators
 
    Brush Asset panel in the tool settings showing asset operators.
 
+.. _bpy.ops.brush.asset_save_as:
+
 Duplicate Asset... (Duplicate icon)
    Creates a copy of the currently active brush as asset, and activates it. A popup is spawned to input some settings
    to use:
 
    Name
-      A custom name to use for the new brush
+      A custom name to use for the new brush.
    Library
       Choose an Asset Library to store the new brush asset in. The available asset libraries are configured
       :ref:`in the Preferences <bpy.types.UserAssetLibrary>`.
    Catalog
-      Choose an Asset Catalog to assign the brush asset to. Entering a non-existent name/path will create a new catalog
-      accordingly.
+      Choose an :doc:`Asset Catalog </files/asset_libraries/catalogs>` to assign the brush asset to. Entering a
+      non-existent name/path will create a new catalog accordingly.
 
 Delete Asset
    Permanently remove this brush asset from the Asset Library it is stored in. This cannot be undone, so a popup will
    ask for confirmation.
 Edit Metadata...
-   Spawns a popup to change some of the available :ref:`asset metadata <editing-asset-metadata>` fields.
+   Spawns a popup to change some of the available :ref:`asset metadata <editing-asset-metadata>` fields:
 
    Catalog
-      Choose an Asset Catalog to assign the brush asset to. Entering a non-existent name/path will create a new catalog
-      accordingly.
+      Choose an :doc:`Asset Catalog </files/asset_libraries/catalogs>` to assign the brush asset to. Entering a
+      non-existent name/path will create a new catalog accordingly.
    Author
-      See :ref:`Asset Author <bpy.types.AssetMetaData.description>`
+      See :ref:`Asset Author <bpy.types.AssetMetaData.description>`.
    Description
-      See :ref:`Asset Description <bpy.types.AssetMetaData.description>`
+      See :ref:`Asset Description <bpy.types.AssetMetaData.description>`.
 Edit Preview Image...
    Opens a window with the File Browser to select an image for the asset preview.
 Update Asset