Tweak doc section about overriding context - point out context.copy() usage!

1 files changed, 6 insertions, 1 deletions

diff --git a/doc/python_api/examples/bpy.ops.1.py b/doc/python_api/examples/bpy.ops.1.py
index b4137e5c740..d89a1360c1c 100644
--- a/doc/python_api/examples/bpy.ops.1.py
+++ b/doc/python_api/examples/bpy.ops.1.py
@@ -10,9 +10,14 @@ The context overrides are passed as a dictionary, with keys matching the context
 member names in bpy.context.
 For example to override ``bpy.context.active_object``,
 you would pass ``{'active_object': object}``.
+
+.. note::
+   You will nearly always want to use a copy of the actual current context as basis
+   (otherwise, you'll have to find and gather all needed data yourself).
 """
 
 # remove all objects in scene rather than the selected ones
 import bpy
-override = {'selected_bases': list(bpy.context.scene.object_bases)}
+override = bpy.context.copy()
+override['selected_bases'] = list(bpy.context.scene.object_bases)
 bpy.ops.object.delete(override)