Added some notes on mesh materials and object getData(mesh=1)

2 files changed, 6 insertions, 2 deletions

diff --git a/source/blender/python/api2_2x/doc/Mesh.py b/source/blender/python/api2_2x/doc/Mesh.py
index 6afa73c2377..9ec9052d22f 100644
--- a/source/blender/python/api2_2x/doc/Mesh.py
+++ b/source/blender/python/api2_2x/doc/Mesh.py
@@ -681,6 +681,9 @@ class Mesh:
     the object's materials.
     B{Note}: Making the material list shorter does not change the faces material indicies,
     take care when using the faces material indices to reference a material in the materials list.
+    B{Note}: The the list thats returned is not linked to the original mesh.
+    mesh.materials.append(material) wont do anything.
+    Use mesh.materials += [material] instead.
   @type materials: list of Materials
   @ivar degr: The max angle for auto smoothing in [1,80].  
   @type degr: int
diff --git a/source/blender/python/api2_2x/doc/Object.py b/source/blender/python/api2_2x/doc/Object.py
index 566de1bab38..6eb36972ae7 100644
--- a/source/blender/python/api2_2x/doc/Object.py
+++ b/source/blender/python/api2_2x/doc/Object.py
@@ -393,8 +393,9 @@ class Object:
     Object.
     If the keyword parameter 'name_only' is True, only the Datablock
     name is returned as a string.  It the object is of type Mesh, then the
-    'mesh' keyword can also be used; the data return is a Mesh object if
-    True, otherwise it is an NMesh object (the default).
+    'mesh' keyword can also be used; if True the data return is a Mesh object,
+    otherwise it is an NMesh object (the default).
+    Using the mesh keyword is ignored for non mesh objects.
     @type name_only: bool
     @param name_only: This is a keyword parameter.  If True (or nonzero),
     only the name of the data object is returned.