Python API

----------
Perform better param checking on Curve bevel and taper objects so that an
curve can't use its own object.  Also stick a big warning in the docs for
Curve.setTotcol(), which seems to be an extremely dangerous method.

1 files changed, 7 insertions, 2 deletions

diff --git a/source/blender/python/api2_2x/doc/Curve.py b/source/blender/python/api2_2x/doc/Curve.py
index 00ef78ec0eb..5ea624b5886 100644
--- a/source/blender/python/api2_2x/doc/Curve.py
+++ b/source/blender/python/api2_2x/doc/Curve.py
@@ -105,7 +105,7 @@ class Curve:
   @type name: string
   @ivar pathlen: The Curve Data path length.
   @type pathlen: int
-  @ivar totcol: The Curve Data maximal number of linked materials.
+  @ivar totcol: The Curve Data maximal number of linked materials. Read-only.
   @type totcol: int
   @ivar flag: The Curve Data flag value; see L{getFlag()} for the semantics.
   @ivar bevresol: The Curve Data bevel resolution.
@@ -179,10 +179,15 @@ class Curve:
 
   def setTotcol(totcol):
     """
-    Set the number of materials linked to the Curve.
+    Set the number of materials linked to the Curve.  B{Note}: this method
+    will probably be deprecated in the future.
     @rtype: None
     @type totcol: int
     @param totcol: number of materials linked.
+    @warn: It is not advisable to use this method unless you know what you
+    are doing; it's possible to
+    corrupt a .blend file if you don't know what you're doing.  If you want
+    to change the number of materials, use the L{materials} attribute.
     """
 
   def getFlag():