[Bf-docboard-svn] bf-manual: [7479] trunk/blender_docs/manual: Blend Previews: Document Operator options

[Aaron Carlisle]

Revision: 7479
          https://developer.blender.org/rBM7479
Author:   Blendify
Date:     2020-12-10 23:00:22 +0100 (Thu, 10 Dec 2020)
Log Message:
-----------
Blend Previews: Document Operator options

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/preferences/save_load.rst
    trunk/blender_docs/manual/files/blend/previews.rst

Modified: trunk/blender_docs/manual/editors/preferences/save_load.rst
===================================================================
--- trunk/blender_docs/manual/editors/preferences/save_load.rst	2020-12-10 21:34:05 UTC (rev 7478)
+++ trunk/blender_docs/manual/editors/preferences/save_load.rst	2020-12-10 22:00:22 UTC (rev 7479)
@@ -35,6 +35,8 @@
       Entering :kbd:`Tab` in the Text Editor adds the appropriate number of spaces
       instead of using characters.
 
+.. _prefs-save_load-backups:
+
 Save Versions
    Number of versions created (for backup) when saving newer versions of a file.
 

Modified: trunk/blender_docs/manual/files/blend/previews.rst
===================================================================
--- trunk/blender_docs/manual/files/blend/previews.rst	2020-12-10 21:34:05 UTC (rev 7478)
+++ trunk/blender_docs/manual/files/blend/previews.rst	2020-12-10 22:00:22 UTC (rev 7479)
@@ -43,20 +43,6 @@
 in the current blend-file. You still need to save the file if you want to write them to the drive.
 
 
-.. _bpy.ops.wm.previews_clear:
-
-Clear Data-Block Previews
--------------------------
-
-.. admonition:: Reference
-   :class: refbox
-
-   :Menu:      :menuselection:`File --> Data Previews --> Clear Data-blocks Previews`
-
-Clear all, a generic type of, or a specific data-block type of previews in the current blend-file.
-You still need to save the file if you want to clear them from the drive.
-
-
 .. _bpy.ops.wm.previews_batch_generate:
 
 Batch Generate Previews
@@ -73,7 +59,38 @@
 This is currently the only way to generate and store in blend-files previews for scenes, collections and objects.
 Note that since this involves a lot of rendering, even of small sizes, the process may take some time to complete.
 
+Scenes
+   Generate previews of scenes and their collections.
+Collections
+   Generate previews of collections of objects.
+Objects
+   Generate previews of objects.
+Materials & Textures
+   Generates previews for materials, textures, images, and other internal data.
+Trusted Blend Files
+   When enabled, Python scripts and drivers that may be included in the file will be run automatically.
+   Enable this only if you created the file yourself,
+   or you trust that the person who gave it to you did not include any malicious code with it.
+   See :doc:`Python Security </advanced/scripting/security>` to configure default trust options.
+Save Backups
+   Keep a :ref:`backup version <prefs-save_load-backups>` (blend1-file)
+   of the files when saving with generated previews.
 
+
+.. _bpy.ops.wm.previews_clear:
+
+Clear Data-Block Previews
+-------------------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`File --> Data Previews --> Clear Data-blocks Previews`
+
+Clear all, a generic type of, or a specific data-block type of previews in the current blend-file.
+You still need to save the file if you want to clear them from the drive.
+
+
 .. _bpy.ops.wm.previews_batch_clear:
 
 Batch Clear Previews
@@ -86,3 +103,20 @@
 
 Clear some data-block types' previews (you can choose which in its options),
 in one or more blend-files on your drive. You should not use this operator on the file currently opened in Blender.
+
+Scenes
+   Generate previews of scenes and their collections.
+Collections
+   Generate previews of collections of objects.
+Objects
+   Generate previews of objects.
+Materials & Textures
+   Generates previews for materials, textures, images, and other internal data.
+Trusted Blend Files
+   When enabled, Python scripts and drivers that may be included in the file will be run automatically.
+   Enable this only if you created the file yourself,
+   or you trust that the person who gave it to you did not include any malicious code with it.
+   See :doc:`Python Security </advanced/scripting/security>` to configure default trust options.
+Save Backups
+   Keep a :ref:`backup version <prefs-save_load-backups>` (blend1-file)
+   of the files when saving with generated previews.