From 6eea0a1fc646ce71ab498e05156832902bfc47fb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=89ric=20Lemoine?= <eric.lemoine@gmail.com>
Date: Fri, 31 Oct 2014 17:16:04 +0100
Subject: [PATCH] Improved docs for icon options

---
 externs/olx.js | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/externs/olx.js b/externs/olx.js
index fd48e2b7f0..db910184af 100644
--- a/externs/olx.js
+++ b/externs/olx.js
@@ -5524,7 +5524,8 @@ olx.style.IconOptions.prototype.crossOrigin;
 
 /**
  * Image object for the icon. If the `src` option is not provided then the
- * provided image must already be loaded.
+ * provided image must already be loaded. And in that case, it is required
+ * to provide the size of the image, with the `size` option.
  * @type {Image|undefined}
  * @api
  */
@@ -5589,7 +5590,9 @@ olx.style.IconOptions.prototype.rotation;
 
 
 /**
- * Icon size in pixel.
+ * Icon size in pixel. Can be used together with `offset` to define the
+ * sub-rectangle to use from the origin (sprite) icon image. Also, setting
+ * the `size` is required if `img` is set and `src` is not.
  * @type {ol.Size|undefined}
  * @api
  */