leStretchShape( ) not stretching correct edges

The documentation is very confusing. Here is what is says about the stretch edge:

"Boolean list indicating whether each point in the figure is free to be moved or not. The list must match the number and order of points in the figure"

But then the example says this:

"leStretchFig( shapeA list( 0 2 ) list(nil t t nil) t )
Stretches the right edge of figure shapeA 2 units in the Y direction." (How does that know what the right edge is since the point list order is not shown?

I assumed that meant the stretch edges are the right and left edges of the shape as shown in the layout window but that is not the case

It seems to be the actual start and end points of the path, which is what I am stretching.

For a test I created a horizontal path then copied it in the layout window then flipped it in the horizontal axis.

I then applied this function to each path :

leStretchShape( car(geGetSelectedSet()) list( .08 0 ) list(nil t) t )

It ended up stretching the endPoint of the path in both cases.

The documentation needs to be updated to remove the "right" from the example and the "l_freePoints" argument needs to be detailed better.