[Bf-committers] Re: [Bf-blender-cvs] CVS commit: blender/source/blender/include BIF_space.h blender/source/blender/python/api2_2x Object.c blender/source/blender/python/api2_2x/doc Object.py blender/source/blender/src editarmature.c editcurve.c header_view3d.c meshtools.c space.c

[Stephen Swaney]

On Mon, Jan 02, 2006 at 11:27:10PM +1100, Campbell Barton wrote:
> How about join takes a list of BPython pbjects and joins those? would 
> that be acceptable?

Martin raises some very good points.  As is, this really does
not fit into an object oriented API.

I would rather see an Object.Join() that takes a list of
objects to be joined and returns the newly created object.
This way the scripter has some explicit idea as to what is
going on.  The method signature would look like this:

  newly_created_obj Object.Join(  list-of-objs-to-be-joined )

The documentation needs to make explicit the fact that the
objs-to-be-joined are gone after this operation.

In the future, can we have the discussion before we make
drastic changes to the API?  Preferably on the bpy list.

-- 
Stephen Swaney			
sswaney at centurytel.net