[ios, macos]revisions round 1

mapbox · Jun 13, 2017 · a2a4222 · a2a4222
1 parent f2c0add
commit a2a4222
Show file tree

Hide file tree

Showing 5 changed files with 11 additions and 6 deletions.
diff --git a/platform/darwin/src/MGLForegroundStyleLayer.h b/platform/darwin/src/MGLForegroundStyleLayer.h
@@ -13,6 +13,8 @@ NS_ASSUME_NONNULL_BEGIN
 
  Create instances of `MGLRasterStyleLayer` and the concrete subclasses of
  `MGLVectorStyleLayer` in order to use `MGLForegroundStyleLayer`'s methods.
+ Do not create instances of this class directly, and do not create your own
+ subclasses of this class.
  */
 MGL_EXPORT
 @interface MGLForegroundStyleLayer : MGLStyleLayer

diff --git a/platform/darwin/src/MGLMultiPoint.h b/platform/darwin/src/MGLMultiPoint.h
@@ -11,8 +11,9 @@ NS_ASSUME_NONNULL_BEGIN
  composed of multiple vertices.
 
  Create instances of `MGLPolyline` or `MGLPolygon` in order to use 
- properties of `MGLMultiPoint`. You can use the method and properties of this
- class to access information about the vertices of the line or polygon.
+ properties of `MGLMultiPoint`. Do not create instances of `MGLMultiPoint`
+ directly. You can use the method and properties of this class to access
+ information about the vertices of the line or polygon.
 
  Do not confuse `MGLMultiPoint` with `MGLPointCollection`, which represents a
  collection of related but disconnected points.

diff --git a/platform/darwin/src/MGLShape.h b/platform/darwin/src/MGLShape.h
@@ -12,8 +12,8 @@ NS_ASSUME_NONNULL_BEGIN
 
  Create instances of `MGLPointAnnotation`, `MGLPointCollection`, `MGLPolyline`,
  `MGLMultiPolyline`, `MGLPolygon`, `MGLMultiPolygon`, or `MGLShapeCollection` in
- order to use `MGLShape`'s methods. The shape classes correspond to the
- <a href="https://tools.ietf.org/html/rfc7946#section-3.1">Geometry</a> object
+ order to use `MGLShape`'s methods. Do not create instances of `MGLShape` directly.
+ The shape classes correspond to the <a href="https://tools.ietf.org/html/rfc7946#section-3.1">Geometry</a> object
  types in the GeoJSON standard, but some have nonstandard names for backwards
  compatibility.
 

diff --git a/platform/darwin/src/MGLStyleValue.h b/platform/darwin/src/MGLStyleValue.h
@@ -240,7 +240,8 @@ MGL_EXPORT
  `MGLCompositeStyleFunction` object.
  
  Create instances of `MGLCameraStyleFunction`, `MGLSourceStyleFunction`, and
- `MGLCompositeStyleFunction` in order to use `MGLStyleFunction`'s methods.
+ `MGLCompositeStyleFunction` in order to use `MGLStyleFunction`'s methods. Do
+ not create instances of `MGLStyleFunction` directly.
 
  The `MGLStyleFunction` class takes a generic parameter `T` that indicates the
  Foundation class being wrapped by this class.

diff --git a/platform/darwin/src/MGLVectorStyleLayer.h b/platform/darwin/src/MGLVectorStyleLayer.h
@@ -10,7 +10,8 @@ NS_ASSUME_NONNULL_BEGIN
  is defined by an `MGLShapeSource` or `MGLVectorSource` object.
 
  Create instances of `MGLCircleStyleLayer`, `MGLFillStyleLayer`, `MGLLineStyleLayer`,
- and `MGLSymbolStyleLayer` in order to use `MGLVectorStyleLayer`'s properties and methods.
+ and `MGLSymbolStyleLayer` in order to use `MGLVectorStyleLayer`'s properties and
+ methods. Do not create instances of `MGLVectorStyleLayer` directly.
  */
 MGL_EXPORT
 @interface MGLVectorStyleLayer : MGLForegroundStyleLayer