Better document which events are fired

The map does not fire ol.render.Event#render. Change events are
now only listed for classes that fire them, and a description
about when they are fired is added.

src/ol/deviceorientation.js

@@ -68,6 +68,7 @@ ol.DeviceOrientationProperty = {
  *
  * @constructor
  * @extends {ol.Object}
+ * @fires change Triggered when the device orientation changes.
  * @param {olx.DeviceOrientationOptions=} opt_options Options.
  * @todo api
  */

src/ol/feature.js

@@ -18,6 +18,7 @@ goog.require('ol.style.Style');
 /**
  * @constructor
  * @extends {ol.Object}
+ * @fires change Triggered when the geometry or style of the feature changes.
  * @param {ol.geom.Geometry|Object.<string, *>=} opt_geometryOrValues
  *     Values or geometry.
  * @todo api

src/ol/geolocation.js

@@ -51,6 +51,7 @@ ol.GeolocationProperty = {
  *
  * @constructor
  * @extends {ol.Object}
+ * @fires change Triggered when the position changes.
  * @param {olx.GeolocationOptions=} opt_options Options.
  * @todo api
  */

src/ol/geom/geometry.js

@@ -46,6 +46,7 @@ ol.geom.GeometryLayout = {
 /**
  * @constructor
  * @extends {ol.Observable}
+ * @fires change Triggered when the geometry changes.
  * @todo api
  */
 ol.geom.Geometry = function() {

src/ol/layer/layer.js

@@ -13,6 +13,7 @@ goog.require('ol.source.Source');
  * @constructor
  * @extends {ol.layer.Base}
  * @fires ol.render.Event
+ * @fires change Triggered when the state of the source changes.
  * @param {olx.layer.LayerOptions} options Layer options.
  * @todo api
  */

src/ol/layer/layergroup.js

@@ -27,6 +27,8 @@ ol.layer.GroupProperty = {
 /**
  * @constructor
  * @extends {ol.layer.Base}
+ * @fires change Triggered when the state of the source of any of the layers of
+ *     this group changes
  * @param {olx.layer.GroupOptions=} opt_options Layer options.
  * @todo api
  */

src/ol/map.js

@@ -158,7 +158,8 @@ ol.MapProperty = {
  * @param {olx.MapOptions} options Map options.
  * @fires ol.MapBrowserEvent
  * @fires ol.MapEvent
- * @fires ol.render.Event
+ * @fires ol.render.Event#postcompose
+ * @fires ol.render.Event#precompose
  * @todo api
  */
 ol.Map = function(options) {

src/ol/observable.js

@@ -31,8 +31,7 @@ goog.inherits(ol.Observable, goog.events.EventTarget);
 
 
 /**
- * Dispatches a `change` event. Register a listener for this event to get
- * notified of changes.
+ * Dispatches a `change` event.
  * @fires change
  * @todo api
  */

src/ol/source/source.js

@@ -35,6 +35,7 @@ ol.source.SourceOptions;
 /**
  * @constructor
  * @extends {ol.Observable}
+ * @fires change Triggered when the state of the source changes.
  * @param {ol.source.SourceOptions} options Source options.
  */
 ol.source.Source = function(options) {