diff --git a/src/ol/interaction/Draw.js b/src/ol/interaction/Draw.js index 17a541131b..016c9ddff4 100644 --- a/src/ol/interaction/Draw.js +++ b/src/ol/interaction/Draw.js @@ -903,9 +903,9 @@ class Draw extends PointerInteraction { } /** - * Extend the geometry that is being drawn, by appending the linear coordinates - * given as the parameter to the coordinate array of currently drawn feature.. - * This can be used when drawing LineStrings or Polygons. Extending supports + * Append the geometry that is currently being drawn with a copy of the + * linear coordinates given as the parameter. + * This can be used when drawing LineStrings or Polygons. Appending supports * only linear coordinates, such as the coordinates from a LineString * or a LinearRing of a Polygon. * @param {!LineCoordType} coordinateExtension Linear coordinates to be appended into @@ -949,6 +949,11 @@ class Draw extends PointerInteraction { * Extend an existing geometry by adding additional points. This only works * on features with `LineString` geometries, where the interaction will * extend lines by adding points to the end of the coordinates array. + * This will change the original feature, instead of drawing a copy. + * + * Extend can be used without having triggered the startDrawing_ function. + * The function will dispatch a DRAWSTART event. + * * @param {!Feature} feature Feature to be extended. * @api */