[Bf-docboard-svn] bf-manual: [9595] trunk/blender_docs/manual/advanced/blender_directory_layout.rst: Include "Overriding Default Directories" section in blender_directory_layout

Campbell Barton noreply at blender.org
Tue Oct 4 05:32:07 CEST 2022


Revision: 9595
          https://developer.blender.org/rBM9595
Author:   campbellbarton
Date:     2022-10-04 05:32:07 +0200 (Tue, 04 Oct 2022)
Log Message:
-----------
Include "Overriding Default Directories" section in blender_directory_layout

Include a reference to envieonment variables with some examples for why
users may wish to override these directories.

Modified Paths:
--------------
    trunk/blender_docs/manual/advanced/blender_directory_layout.rst

Modified: trunk/blender_docs/manual/advanced/blender_directory_layout.rst
===================================================================
--- trunk/blender_docs/manual/advanced/blender_directory_layout.rst	2022-10-04 02:58:58 UTC (rev 9594)
+++ trunk/blender_docs/manual/advanced/blender_directory_layout.rst	2022-10-04 03:32:07 UTC (rev 9595)
@@ -199,3 +199,16 @@
 - User Preference (see :ref:`prefs-file-paths`).
 - Environment variables (``TEMP`` on Windows, ``TMP`` & ``TMP_DIR`` on other platforms).
 - The ``/tmp/`` directory.
+
+
+Overriding Default Directories
+==============================
+
+It's possible to override the default **USER** and **SYSTEM** directories using environment variables.
+
+While this shouldn't be needed for typical usage, some specialized use cases may take advantage of this, such as:
+
+- Using a shared network drives for specific paths.
+- Isolating an instance from the default user files to prevent automated tasks from accessing user configuration.
+
+See :ref:`command-line-args-environment-variables` for details.



More information about the Bf-docboard-svn mailing list