[Bf-blender-cvs] [2f8c8ec8fb5] blender2.8: Docs: BMesh.from_mesh behavior w/ multiple calls

[Campbell Barton]

Commit: 2f8c8ec8fb5ff1c3c8164df6bef8dee31e6e6e8b
Author: Campbell Barton
Date:   Mon Aug 28 12:40:36 2017 +1000
Branches: blender2.8
https://developer.blender.org/rB2f8c8ec8fb5ff1c3c8164df6bef8dee31e6e6e8b

Docs: BMesh.from_mesh behavior w/ multiple calls

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

M	source/blender/python/bmesh/bmesh_py_types.c

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

diff --git a/source/blender/python/bmesh/bmesh_py_types.c b/source/blender/python/bmesh/bmesh_py_types.c
index 9b1cd93093b..caf836fa5b8 100644
--- a/source/blender/python/bmesh/bmesh_py_types.c
+++ b/source/blender/python/bmesh/bmesh_py_types.c
@@ -1041,6 +1041,13 @@ PyDoc_STRVAR(bpy_bmesh_from_mesh_doc,
 "   :type use_shape_key: boolean\n"
 "   :arg shape_key_index: The shape key index to use.\n"
 "   :type shape_key_index: int\n"
+"\n"
+"   .. note::\n"
+"\n"
+"      Multiple calls can be used to join multiple meshes.\n"
+"\n"
+"      Custom-data layers are only copied from ``mesh`` on initialization.\n"
+"      Further calls will copy custom-data to matching layers, layers missing on the target mesh wont be added.\n"
 );
 static PyObject *bpy_bmesh_from_mesh(BPy_BMesh *self, PyObject *args, PyObject *kw)
 {