[Bf-python] Error in mathutils docs

[Joe Eagar]

Ken Hughes wrote:
> Joe Eagar wrote:
>> Hi.  In the cvs epydocs, the Mathutils.Vector page says that the 
>> Vector methods return a copy of the source vector.  After looking at 
>> the code in vector.c, this is clearly not the case; the functions 
>> simply return the original vector.
>
> Don't think anyone answered this, and Joseph would be the best to 
> explain, but IIRC this is true but perhaps misleading.  Perhaps it 
> should say returns a new reference to the object.  This was for users 
> who wanted to concatenate operations, such as
There's a big difference between a new *reference* and a full copy. :)  
Why not just say "Returns: itself" or "Returns: reference to itself"?  
"Returns: A copy of itself" it not misleading, it's wrong.

Joe