Added brilliant clarifications from @alteredq & @zz85 to Spline docum…

…entation :-)

docs/api/core/Spline.html

@@ -21,7 +21,7 @@ <h3>[name]( [page:Array points] )</h3>
 
 		<h2>Properties</h2>
 
-		<h3>.[page:Vector3 todo]</h3>
+		<h3>.[page:Array points]</h3>
 
 
 		<h2>Methods</h2>
@@ -51,9 +51,10 @@ <h3>.getLength( [page:Integer nSubDivisions] )</h3>
 
 		<h3>.reparametrizeByArcLength( [page:Float samplingCoef] )</h3>
 		<div>
-		samplingCoef — TODO
+		samplingCoef — how many intermediate values to use between spline points
 		</div>
-		<div>TODO ???</div>
+		<div>Modifies the spline so that it looks similar to the original but has its points distributed in such way that moving along the spline it's done at a more or less constant speed. The points should also appear more uniformly spread along the curve.</div>
+		<div>This is done by resampling the original spline, with the density of sampling controlled by *samplingCoef*. Here it's interesting to note that denser sampling is not necessarily better: if sampling is too high, you may get weird kinks in curvature.</div>
 
 		<h2>Source</h2>