[Bf-docboard-svn] bf-manual: [9113] trunk/blender_docs/manual: Recovering Data, document recovering from saved versions

[Campbell Barton]

Revision: 9113
          https://developer.blender.org/rBM9113
Author:   campbellbarton
Date:     2022-03-15 01:36:05 +0100 (Tue, 15 Mar 2022)
Log Message:
-----------
Recovering Data, document recovering from saved versions

As Blender saves `*.blend1` files by default, it's worth 
noting this in documentation for recovering files.

Also add references to preferences for save-versions & auto-save
in the body of each section instead of under the general
"Recovering Data" heading.

Modified Paths:
--------------
    trunk/blender_docs/manual/files/blend/open_save.rst
    trunk/blender_docs/manual/troubleshooting/recover.rst

Modified: trunk/blender_docs/manual/files/blend/open_save.rst
===================================================================
--- trunk/blender_docs/manual/files/blend/open_save.rst	2022-03-14 23:54:21 UTC (rev 9112)
+++ trunk/blender_docs/manual/files/blend/open_save.rst	2022-03-15 00:36:05 UTC (rev 9113)
@@ -101,7 +101,7 @@
 
 .. seealso::
 
-   :ref:`Auto Saves <troubleshooting-file-recovery>`
+   :ref:`Auto Save <troubleshooting-file_recovery-auto_save>`
 
 
 .. _bpy.ops.wm.save_mainfile:
@@ -120,11 +120,7 @@
 
    The File Browser in save configuration.
 
-.. seealso::
 
-   :ref:`Auto Save <troubleshooting-file-recovery>`
-
-
 .. _bpy.ops.wm.save_as_mainfile:
 
 Save As

Modified: trunk/blender_docs/manual/troubleshooting/recover.rst
===================================================================
--- trunk/blender_docs/manual/troubleshooting/recover.rst	2022-03-14 23:54:21 UTC (rev 9112)
+++ trunk/blender_docs/manual/troubleshooting/recover.rst	2022-03-15 00:36:05 UTC (rev 9113)
@@ -19,13 +19,22 @@
    used to roll back from mistakes under normal operation, or return back to a specific action.
    See :doc:`/interface/undo_redo`.
 
-The *File* tab of the *Preferences* allows you to configure the two ways
-that Blender provides for you to regress to a previous version of your work.
-See :ref:`Auto Save Preferences <prefs-auto-save>` for details.
 
+.. _troubleshooting-file_recovery-save_versions:
 
-.. _troubleshooting-file-recovery:
+Recovering Save Versions
+========================
 
+By default Blender keeps an additional backup when saving files.
+So saving renames the previously saved file with a ``.blend1`` extension instead of overwriting it.
+
+This file can be used to revert to a previous state.
+
+See :ref:`Save Versions <prefs-save_load-backups>` to configure the number of versions kept.
+
+
+.. _troubleshooting-file_recovery-auto_save:
+
 Recovering Auto Saves
 =====================
 
@@ -53,6 +62,8 @@
 You will have to navigate to your :ref:`temp-dir`.
 The *Auto Saved* files are named using a random number and have a blend extension.
 
+See :ref:`Auto Save Preferences <prefs-auto-save>` to configure auto-save.
+
 Trusted Source
    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,
@@ -61,8 +72,7 @@
 
 .. tip::
 
-   It is important, when browsing, to enable the detailed list view.
-   Otherwise, you will not be able to figure out the dates of the auto-saved blend-files.
+   Enable the detailed list view when browsing auto-saved files to show which is the most recent.
 
    .. figure:: /images/troubleshooting_recover_display-file-date.png
 
@@ -70,6 +80,6 @@
 
 .. warning::
 
-   When recovering an *Auto Saved* file, you will lose any changes made since the last *Auto Save* was performed.
-   Only one *Auto Saved* file exists for each project, i.e. Blender does not keep older versions.
-   Hence, you will not be able to go back more than a few minutes with this tool.
+   When recovering an *Auto Saved* file, any changes made since the last *Auto Save* will be lost.
+   Only one *Auto Saved* file exists for each ``.blend`` file, i.e. Blender does not keep older versions.
+   Therefor, you will only be able to restore the most recent *Auto Save* file.