API doc improvements

src/objectliterals.jsdoc

@@ -16,7 +16,8 @@
  *     passed `layers` array or in the layer collection as returned from
  *     `ol.Map#getLayers()` if no `layers` were provided.
  * @property {function(Object)|undefined} error Callback for unsuccessful
- *     queries.
+ *     queries. Note that queries with no matching features trigger the success
+ *     callback, not the error callback.
  */
 
 /**
@@ -30,7 +31,8 @@
  *     array or in the layer collection as returned from `ol.Map#getLayers()` if
  *     no layers were provided.
  * @property {function(Object)|undefined} error Callback for unsuccessful
- *     queries.
+ *     queries. Note that queries with no matching features trigger the success
+ *     callback, not the error callback.
  */
 
 /**
@@ -302,9 +304,9 @@
 /**
  * @typedef {Object} ol.layer.VectorLayerOptions
  * @property {function(Array.<ol.Feature>):string|
- *     undefined} transformFeatureInfo Function to render an array of features
+ *     undefined} getTransformFeatureInfo Function to render an array of
- *     into feature info markup. If not provided, a comma separated list the
+ *     features into feature info markup. If not provided, a comma separated
- *     unique ids of the resulting features will be returned.
+ *     list of the unique ids of the resulting features will be returned.
  * @property {number|undefined} opacity Opacity. 0-1. Default is 1.
  * @property {ol.source.Source} source Source for this layer.
  * @property {ol.style.Style|undefined} style Style.