BPython bug fixes:

- bug #2033 reported by Ken Hughes: Vertices of mesh parented to lattice is scaled incorrectly:
https://projects.blender.org/tracker/?func=detail&aid=2033&group_id=9&atid=125

- bug #2211 reported by German Alonso Tamayo (servivo): Add a vertex to a mesh with groups using a script and then edit that mesh hangs blender:
https://projects.blender.org/tracker/index.php?func=detail&aid=2211&group_id=9&atid=125

(#2211's hang was already fixed with previous commit, but this way should work better)

- doc updates (Ken reported missing info about Render slinks, thanks).

1 files changed, 13 insertions, 1 deletions

diff --git a/source/blender/python/api2_2x/doc/Lattice.py b/source/blender/python/api2_2x/doc/Lattice.py
index 56f4ee71150..9f8bf76c336 100644
--- a/source/blender/python/api2_2x/doc/Lattice.py
+++ b/source/blender/python/api2_2x/doc/Lattice.py
@@ -171,10 +171,22 @@ class Lattice:
     @param position: The x,y,z coordinates that you want the point to be: [x,y,z]
     """
 
-  def applyDeform():
+  def applyDeform(force = False):
     """
+    @type force: bool
+    @param force: if True, meshes are not ignored.
     Applies the current Lattice deformation to any child objects that have this 
     Lattice as the parent.
+    @note: simply parenting to a Lattice and redrawing the screen is enough to
+      get the deformation done, this applyDeform method is useful when the
+      script won't call a redraw, like in command line background (GUI-less)
+      mode.
+    @note: by default, this method doesn't apply deformations to meshes.  This
+      is because unlike other kinds of objects, meshes store lattice
+      deformation directly in their vertices and calling this applyDeform
+      method will apply the deformation a second time, giving double
+      deformation, which can be a feature (set force = True if you want it) or
+      much probably an undesired effect.
     """
 
   def insertKey(frame):