[Bf-blender-cvs] [0f6d5c9a9d4] master: Docs: minor improvements to info_advanced_blender_as_bpy wording
Campbell Barton
noreply at git.blender.org
Fri Sep 23 07:04:22 CEST 2022
Commit: 0f6d5c9a9d4abd672ecce4812da69564d918b2fc
Author: Campbell Barton
Date: Fri Sep 23 15:03:15 2022 +1000
Branches: master
https://developer.blender.org/rB0f6d5c9a9d4abd672ecce4812da69564d918b2fc
Docs: minor improvements to info_advanced_blender_as_bpy wording
===================================================================
M doc/python_api/rst/info_advanced_blender_as_bpy.rst
===================================================================
diff --git a/doc/python_api/rst/info_advanced_blender_as_bpy.rst b/doc/python_api/rst/info_advanced_blender_as_bpy.rst
index b3fbfd2fe6d..9d2861ff627 100644
--- a/doc/python_api/rst/info_advanced_blender_as_bpy.rst
+++ b/doc/python_api/rst/info_advanced_blender_as_bpy.rst
@@ -78,9 +78,10 @@ Signal Handlers
to cancel a render and a crash log is not written in the event of a crash.
Startup and Preferences
- When the ``bpy`` module loads, the file is not empty as you might expect,
- there is a default cube, camera and light. If you wish to start from a blank file use:
- ``bpy.ops.wm.read_factory_settings(use_empty=True)``.
+ When the ``bpy`` module loads it contains the default startup scene
+ (instead of an "empty" blend-file as you might expect), so there is a default cube, camera and light.
+
+ If you wish to start from an empty file use: ``bpy.ops.wm.read_factory_settings(use_empty=True)``.
The users startup and preferences are ignored to prevent your local configuration from impacting scripts behavior.
The Python module behaves as if ``--factory-startup`` was passed as a command line argument.
@@ -101,9 +102,10 @@ Limitations
Most constraints of Blender as an application still apply:
Reloading Unsupported
- Reloading via ``importlib.reload`` will raise an exception instead of reloading and resetting the module.
+ Reloading the ``bpy`` module via ``importlib.reload`` will raise an exception
+ instead of reloading and resetting the module.
- The operator ``bpy.ops.wm.read_factory_settings()`` can be used to reset the internal state.
+ Instead, the operator ``bpy.ops.wm.read_factory_settings()`` can be used to reset the internal state.
Single Blend File Restriction
Only a single ``.blend`` file can be edited at a time.
More information about the Bf-blender-cvs
mailing list