Expand docs for color options

externs/olx.js

@@ -4652,8 +4652,8 @@ olx.style.FillOptions;
 
 
 /**
- * Color. Default null; if null, the Canvas/renderer default black will be
+ * Color. See {@link ol.color} for possible formats. Default null; if null,
- * used.
+ * the Canvas/renderer default black will be used.
  * @type {ol.Color|string|undefined}
  */
 olx.style.FillOptions.prototype.color;
@@ -4805,8 +4805,8 @@ olx.style.StrokeOptions;
 
 
 /**
- * Color. Default null; if null, the Canvas/renderer default black will be
+ * Color. See {@link ol.color} for possible formats. Default null; if null,
- * used.
+ * the Canvas/renderer default black will be used.
  * @type {ol.Color|string|undefined}
  */
 olx.style.StrokeOptions.prototype.color;

src/ol/color/color.js

@@ -110,7 +110,7 @@ ol.color.asArray = function(color) {
 
 /**
  * @param {ol.Color|string} color Color.
- * @return {string} String.
+ * @return {string} Rgba string.
  * @api
  */
 ol.color.asString = function(color) {

src/ol/color/color.jsdoc

@@ -1,3 +1,8 @@
 /**
+ * Colors can be defined as a {@link ol.Color} array, or as strings in
+ * `rgb(r,g,b)` or `rgba(r,g,b,a)` format, or in hex `#rrggbb` or `#rgb` format.
+ * Color names, like 'red', 'blue' or 'green', may also be used with the
+ * Canvas renderer.
+ *
  * @namespace ol.color
  */

src/ol/ol.js

@@ -104,9 +104,11 @@ ol.ENABLE_IMAGE = true;
 
 
 /**
- * @define {boolean} Enable named colors.  Enabling named colors adds about 3KB
+ * @define {boolean} Enable Closure named colors (`goog.color.names`).
- *     uncompressed / 1.5KB compressed to the final build size.  Default is
+ *     Enabling these colors adds about 3KB uncompressed / 1.5KB compressed to
- *     `false`.
+ *     the final build size.  Default is `false`. This setting has no effect
+ *     with Canvas renderer, which uses its own names, whether this is true or
+ *     false.
  */
 ol.ENABLE_NAMED_COLORS = false;