First pass at adding redone maps

packages/turf-along/index.js

@@ -11,7 +11,6 @@ var destination = require('@turf/destination');
  * @param {number} distance distance along the line
  * @param {string} [units=kilometers] can be degrees, radians, miles, or kilometers
  * @returns {Feature<Point>} Point `distance` `units` along the line
- * @addToMap along, line
  * @example
  * var line = {
  *   "type": "Feature",
@@ -30,7 +29,8 @@ var destination = require('@turf/destination');
  * };
  *
  * var along = turf.along(line, 1, 'miles');
- * //=along
+ * //addToMap
+ * var addToMap = [along, line]
  */
 module.exports = function (line, distance, units) {
     var coords;

packages/turf-area/index.js

@@ -7,7 +7,6 @@ var geomReduce = require('@turf/meta').geomReduce;
  * @name area
  * @param {FeatureCollection|Feature<any>} geojson input GeoJSON feature(s)
  * @returns {number} area in square meters
- * @addToMap polygon
  * @example
  * var polygon = {
  *   "type": "Feature",
@@ -29,8 +28,9 @@ var geomReduce = require('@turf/meta').geomReduce;
  *   }
  * }
  * var area = turf.area(polygon);
- * //=area => square meters
- * //=polygon
+ * //addToMap
+ * polygon.properties.area = area
+ * var addToMap = [polygon]
  */
 module.exports = function (geojson) {
     return geomReduce(geojson, function (value, geometry) {

packages/turf-bbox-clip/index.js

@@ -10,7 +10,7 @@ var multiPolygon = helpers.multiPolygon;
  * Takes a {@link Feature} and a bbox and clips the feature to the bbox using [lineclip](https://github.com/mapbox/lineclip).
  * May result in degenerate edges when clipping Polygons.
  *
- * @name bbox-clip
+ * @name bboxClip
  * @param {Feature<LineString|MultiLineString|Polygon|MultiPolygon>} feature feature to clip to the bbox
  * @param {Array<number>} bbox extent in [minX, minY, maxX, maxY] order
  * @returns {Feature<LineString|MultiLineString|Polygon|MultiPolygon>} clipped Feature
@@ -26,8 +26,8 @@ var multiPolygon = helpers.multiPolygon;
  * }
  *
  * var clipped = turf.bboxClip(poly, bbox);
- *
- * //=clipped
+ * //addToMap
+ * var addToMap = [bbox, poly, clipped]
  */
 module.exports = function (feature, bbox) {
     var geom = getGeom(feature);

packages/turf-bbox-polygon/index.js

@@ -11,8 +11,8 @@ var polygon = require('@turf/helpers').polygon;
  * var bbox = [0, 0, 10, 10];
  *
  * var poly = turf.bboxPolygon(bbox);
- *
- * //=poly
+ * //addToMap
+ * var addToMap = [poly]
  */
 
 module.exports = function (bbox) {

packages/turf-bbox/index.js

@@ -6,7 +6,6 @@ var each = require('@turf/meta').coordEach;
  * @name bbox
  * @param {(Feature|FeatureCollection)} geojson input features
  * @returns {Array<number>} bbox extent in [minX, minY, maxX, maxY] order
- * @addToMap features, bboxPolygon
  * @example
  * var pt1 = turf.point([114.175329, 22.2524])
  * var pt2 = turf.point([114.170007, 22.267969])
@@ -18,10 +17,8 @@ var each = require('@turf/meta').coordEach;
  * var bbox = turf.bbox(features);
  *
  * var bboxPolygon = turf.bboxPolygon(bbox);
- *
- * //=bbox
- *
- * //=bboxPolygon
+ * //addToMap
+ * var addToMap = [features, bboxPolygon]
  */
 module.exports = function (geojson) {
     var bbox = [Infinity, Infinity, -Infinity, -Infinity];

packages/turf-bearing/index.js

@@ -11,33 +11,32 @@ var getCoord = require('@turf/invariant').getCoord;
  * @param {Feature<Point>} end ending Point
  * @param {boolean} [final=false] calculates the final bearing if true
  * @returns {number} bearing in decimal degrees, between -180 and 180 degrees (positive clockwise)
- * @addToMap point1, point2
  * @example
  * var point1 = {
  *   "type": "Feature",
- *   "properties": {
- *     "marker-color": '#f00'
- *   },
+ *   "properties": {},
  *   "geometry": {
  *     "type": "Point",
  *     "coordinates": [-75.343, 39.984]
  *   }
  * };
  * var point2 = {
  *   "type": "Feature",
- *   "properties": {
- *     "marker-color": '#0f0'
- *   },
+ *   "properties": {},
  *   "geometry": {
  *     "type": "Point",
  *     "coordinates": [-75.534, 39.123]
  *   }
  * };
  *
  * var bearing = turf.bearing(point1, point2);
+ * //addToMap
+ * var addToMap = [point1, point2]
+ * point1.properties['marker-color'] = '#f00'
+ * point2.properties['marker-color'] = '#0f0'
  * point1.properties.bearing = bearing
- * //=bearing
  */
+
 function bearing(start, end, final) {
     if (final === true) return calculateFinalBearing(start, end);
 

packages/turf-bezier/index.js

@@ -13,7 +13,6 @@ var Spline = require('./spline.js');
  * @param {number} [resolution=10000] time in milliseconds between points
  * @param {number} [sharpness=0.85] a measure of how curvy the path should be between splines
  * @returns {Feature<LineString>} curved line
- * @addToMap line, curved
  * @example
  * var line = {
  *   "type": "Feature",
@@ -34,9 +33,9 @@ var Spline = require('./spline.js');
  * };
  *
  * var curved = turf.bezier(line);
+ * //addToMap
  * curved.properties = { stroke: '#0f0' };
- *
- * //=curved
+ * var addToMap = [line, curved]
  */
 module.exports = function (line, resolution, sharpness) {
     var lineOut = linestring([]);

packages/turf-buffer/index.js

@@ -15,7 +15,6 @@ var normalize = require('@mapbox/geojson-normalize');
  * @param {number} radius distance to draw the buffer
  * @param {string} units any of the options supported by turf units
  * @return {FeatureCollection<Polygon>|FeatureCollection<MultiPolygon>|Polygon|MultiPolygon} buffered features
- * @addToMap pt, buffered
  * @example
  * var pt = {
  *   "type": "Feature",
@@ -28,8 +27,8 @@ var normalize = require('@mapbox/geojson-normalize');
  * var unit = 'miles';
  *
  * var buffered = turf.buffer(pt, 500, unit);
- *
- * //=buffered
+ * //addToMap
+ * var addToMap = [pt, buffered]
  */
 
 module.exports = function (feature, radius, units) {