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).

6 files changed, 26 insertions, 11 deletions

diff --git a/source/blender/python/api2_2x/doc/Camera.py b/source/blender/python/api2_2x/doc/Camera.py
index 9dc382a2ba8..ac0319f8fff 100644
--- a/source/blender/python/api2_2x/doc/Camera.py
+++ b/source/blender/python/api2_2x/doc/Camera.py
@@ -205,7 +205,7 @@ class Camera:
     """
     Get a list with this Camera's script links of type 'event'.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     @rtype: list
     @return: a list with Blender L{Text} names (the script links of the given
         'event' type) or None if there are no script links at all.
@@ -225,7 +225,7 @@ class Camera:
     @type text: string
     @param text: the name of an existing Blender L{Text}.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     """
 
   def insertIpoKey(keytype):
diff --git a/source/blender/python/api2_2x/doc/Lamp.py b/source/blender/python/api2_2x/doc/Lamp.py
index 824e43eaad2..7c8aa9dedc7 100644
--- a/source/blender/python/api2_2x/doc/Lamp.py
+++ b/source/blender/python/api2_2x/doc/Lamp.py
@@ -329,7 +329,7 @@ class Lamp:
     """
     Get a list with this Lamp's script links of type 'event'.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     @rtype: list
     @return: a list with Blender L{Text} names (the script links of the given
         'event' type) or None if there are no script links at all.
@@ -349,7 +349,7 @@ class Lamp:
     @type text: string
     @param text: the name of an existing Blender L{Text}.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     """
 
   def getIpo():
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):
diff --git a/source/blender/python/api2_2x/doc/Object.py b/source/blender/python/api2_2x/doc/Object.py
index e75c2cc4234..ef8e31aa415 100644
--- a/source/blender/python/api2_2x/doc/Object.py
+++ b/source/blender/python/api2_2x/doc/Object.py
@@ -443,6 +443,9 @@ class Object:
         0 - update scene hierarchy automatically
         1 - don't update scene hierarchy (faster). In this case, you must
         explicitely update the Scene hierarchy.
+    @warn: objects must first be linked to a scene before they can become
+        parents of other objects.  Calling this makeParent method for an
+        unlinked object will result in an error.
     """
 
   def setDeltaLocation(delta_location):
@@ -595,7 +598,7 @@ class Object:
     """
     Get a list with this Object's script links of type 'event'.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     @rtype: list
     @return: a list with Blender L{Text} names (the script links of the given
         'event' type) or None if there are no script links at all.
@@ -615,7 +618,7 @@ class Object:
     @type text: string
     @param text: the name of an existing Blender L{Text}.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     """
 
   def makeTrack (tracked, fast = 0):
diff --git a/source/blender/python/api2_2x/doc/Scene.py b/source/blender/python/api2_2x/doc/Scene.py
index f722b772184..d9846086317 100644
--- a/source/blender/python/api2_2x/doc/Scene.py
+++ b/source/blender/python/api2_2x/doc/Scene.py
@@ -236,7 +236,7 @@ class Scene:
     """
     Get a list with this Scene's script links of type 'event'.
     @type event: string
-    @param event: "FrameChanged", "OnLoad", "OnSave" or "Redraw".
+    @param event: "FrameChanged", "OnLoad", "OnSave", "Redraw" or "Render".
     @rtype: list
     @return: a list with Blender L{Text} names (the script links of the given
         'event' type) or None if there are no script links at all.
@@ -256,7 +256,7 @@ class Scene:
     @type text: string
     @param text: the name of an existing Blender L{Text}.
     @type event: string
-    @param event: "FrameChanged", "OnLoad", "OnSave" or "Redraw".
+    @param event: "FrameChanged", "OnLoad", "OnSave", "Redraw" or "Render".
     """
 
   def play (mode = 0, win = '<VIEW3D>'):
diff --git a/source/blender/python/api2_2x/doc/World.py b/source/blender/python/api2_2x/doc/World.py
index 2aa333b6610..8dbf8dfb951 100644
--- a/source/blender/python/api2_2x/doc/World.py
+++ b/source/blender/python/api2_2x/doc/World.py
@@ -293,7 +293,7 @@ class World:
     """
     Get a list with this World's script links of type 'event'.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw", "Render".
     @rtype: list
     @return: a list with Blender L{Text} names (the script links of the given
         'event' type) or None if there are no script links at all.
@@ -313,7 +313,7 @@ class World:
     @type text: string
     @param text: the name of an existing Blender L{Text}.
     @type event: string
-    @param event: "FrameChanged" or "Redraw".
+    @param event: "FrameChanged", "Redraw" or "Render".
     """
   
   def setCurrent ():