[Bf-blender-cvs] [8a254b62710] blender-v2.79-release: Docs: BMesh.from_mesh behavior w/ multiple calls

[Campbell Barton]

Commit: 8a254b62710ac2efde76716ccf064287777b6905
Author: Campbell Barton
Date:   Mon Aug 28 12:40:36 2017 +1000
Branches: blender-v2.79-release
https://developer.blender.org/rB8a254b62710ac2efde76716ccf064287777b6905

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 b20c03bee28..b31d22f2d69 100644
--- a/source/blender/python/bmesh/bmesh_py_types.c
+++ b/source/blender/python/bmesh/bmesh_py_types.c
@@ -1049,6 +1049,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)
 {