Remove references to "ref" property

mapbox · Sep 19, 2017 · b64011f · b64011f
1 parent cac927f
commit b64011f
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 10 deletions.
diff --git a/docs/style-spec/_generate/index.html b/docs/style-spec/_generate/index.html
@@ -693,14 +693,13 @@ <h2><a href='#layers' title='link to layers'>Layers</a></h2>
         <code>paint</code> properties.
       </p>
       <p>
-        <em>Layout properties</em> appear in the layer's <code>"layout"</code> object. They are applied early in the rendering process and
-        define how data for that layer is passed to the GPU. For efficiency, a layer can share layout properties with
-        another layer via the <code>"ref"</code> layer property, and should do so where possible. This will decrease
-        processing time and allow the two layers will share GPU memory and other resources associated with the layer.
+        <em>Layout properties</em> appear in the layer's <code>"layout"</code> object. They are applied early in the
+          rendering process and define how data for that layer is passed to the GPU. Changes to a layout property
+          require an asynchronous "layout" step.
       </p>
       <p>
-        <em>Paint properties</em> are applied later in the rendering process. A layer that shares layout properties with another
-        layer can have independent paint properties. Paint properties appear in the layer's <code>"paint"</code> object.
+        <em>Paint properties</em> are applied later in the rendering process. Paint properties appear in the layer's
+          <code>"paint"</code> object. Changes to a paint property are cheap and happen synchronously.
       </p>
       <p class='space-bottom4 quiet small'>Key:
         <a class='icon smooth-ramp quiet micro space-right inline' href='#types-function' title='Supports interpolated functions'>supports interpolated functions</a>

diff --git a/src/style-spec/reference/v8.json b/src/style-spec/reference/v8.json
@@ -416,10 +416,6 @@
       "type": "*",
       "doc": "Arbitrary properties useful to track with the layer, but do not influence rendering. Properties should be prefixed to avoid collisions, like 'mapbox:'."
     },
-    "ref": {
-      "type": "string",
-      "doc": "References another layer to copy `type`, `source`, `source-layer`, `minzoom`, `maxzoom`, `filter`, and `layout` properties from. This allows the layers to share processing and be more efficient."
-    },
     "source": {
       "type": "string",
       "doc": "Name of a source description to be used for this layer."