[Bf-blender-cvs] [5186cfbea4c] master: Depsgraph: State behavior details more explicitly

[Sergey Sharybin]

Commit: 5186cfbea4c1c1111d6e6061ab877ee8d9b4f206
Author: Sergey Sharybin
Date:   Fri May 17 10:23:31 2019 +0200
Branches: master
https://developer.blender.org/rB5186cfbea4c1c1111d6e6061ab877ee8d9b4f206

Depsgraph: State behavior details more explicitly

===================================================================

M	doc/python_api/examples/bpy.types.Depsgraph.4.py
M	doc/python_api/examples/bpy.types.Depsgraph.5.py
M	source/blender/makesrna/intern/rna_object_api.c

===================================================================

diff --git a/doc/python_api/examples/bpy.types.Depsgraph.4.py b/doc/python_api/examples/bpy.types.Depsgraph.4.py
index 41f94a32c4c..a7b6068cfae 100644
--- a/doc/python_api/examples/bpy.types.Depsgraph.4.py
+++ b/doc/python_api/examples/bpy.types.Depsgraph.4.py
@@ -15,6 +15,10 @@ animation or modifiers into account:
 When is used on evaluated object all modifiers are taken into account.
 
 .. note:: The result mesh is owned by the object. It can be freed by calling `object.to_mesh_clear()`.
+.. note::
+   The result mesh must be treated as temporary, and can not be referenced from objects in the main
+   database. If the mesh intended to be used in a persistent manner use bpy.data.meshes.new_from_object()
+   instead.
 .. note:: If object does not have geometry (i.e. camera) the functions returns None.
 """
 import bpy
diff --git a/doc/python_api/examples/bpy.types.Depsgraph.5.py b/doc/python_api/examples/bpy.types.Depsgraph.5.py
index a37d2674ecd..353161a547a 100644
--- a/doc/python_api/examples/bpy.types.Depsgraph.5.py
+++ b/doc/python_api/examples/bpy.types.Depsgraph.5.py
@@ -17,7 +17,7 @@ When is used on evaluated object all modifiers are taken into account.
 All the references (such as materials) are re-mapped to original. This ensures validity and
 consistency of the main database.
 
-.. note:: The result mesh is added to the main database.
+.. note:: The result mesh is added to the main database. This mesh can be referenced by any object,
 .. note:: If object does not have geometry (i.e. camera) the functions returns None.
 """
 import bpy
diff --git a/source/blender/makesrna/intern/rna_object_api.c b/source/blender/makesrna/intern/rna_object_api.c
index da00e1f155d..7362f6ba610 100644
--- a/source/blender/makesrna/intern/rna_object_api.c
+++ b/source/blender/makesrna/intern/rna_object_api.c
@@ -895,7 +895,8 @@ void RNA_api_object(StructRNA *srna)
   RNA_def_function_ui_description(
       func,
       "Create a Mesh data-block from the current state of the object. The object owns the "
-      "data-block. To force free it use to_mesh_clear()");
+      "data-block. To force free it use to_mesh_clear(). "
+      "The result is temporary and can not be used by objects from the main database");
   RNA_def_function_flag(func, FUNC_USE_REPORTS);
   parm = RNA_def_pointer(func, "mesh", "Mesh", "", "Mesh created from object");
   RNA_def_function_return(func, parm);