From b3967731832ffd18f35d2286d99e5715d22445d1 Mon Sep 17 00:00:00 2001
From: Peter Robins <github@peterrobins.co.uk>
Date: Sun, 6 Jul 2014 06:55:11 -0400
Subject: [PATCH] Improve docs for tilegrid

---
 externs/olx.js | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/externs/olx.js b/externs/olx.js
index 4dc7e75a87..a080d1c126 100644
--- a/externs/olx.js
+++ b/externs/olx.js
@@ -4022,7 +4022,11 @@ olx.source.TileWMSOptions.prototype.logo;
 
 
 /**
- * Tile grid.
+ * Tile grid. Base this on the resolutions, tilesize and extent supported by the
+ * server.
+ * If this is not defined, a default grid will be used: if there is a projection
+ * extent, the grid will be based on that; if not, a grid based on a global
+ * extent with origin at 0,0 will be used.
  * @type {ol.tilegrid.TileGrid|undefined}
  */
 olx.source.TileWMSOptions.prototype.tileGrid;
@@ -4930,21 +4934,22 @@ olx.tilegrid.TileGridOptions;
 
 
 /**
- * Minimum zoom.
+ * Minimum zoom. Default is 0.
  * @type {number|undefined}
  */
 olx.tilegrid.TileGridOptions.prototype.minZoom;
 
 
 /**
- * Origin.
+ * Origin. Default is null.
  * @type {ol.Coordinate|undefined}
  */
 olx.tilegrid.TileGridOptions.prototype.origin;
 
 
 /**
- * Origins.
+ * Origins. If given, the array should match the `resolutions` array, i.e.
+ * each resolution can have a different origin.
  * @type {Array.<ol.Coordinate>|undefined}
  */
 olx.tilegrid.TileGridOptions.prototype.origins;
@@ -4958,14 +4963,15 @@ olx.tilegrid.TileGridOptions.prototype.resolutions;
 
 
 /**
- * Tile size.
+ * Tile size. Default is 256. (Only square tiles are supported.)
  * @type {number|undefined}
  */
 olx.tilegrid.TileGridOptions.prototype.tileSize;
 
 
 /**
- * Tile sizes.
+ * Tile sizes. If given, the array should match the `resolutions` array, i.e.
+ * each resolution can have a different tile size.
  * @type {Array.<number>|undefined}
  */
 olx.tilegrid.TileGridOptions.prototype.tileSizes;