Merge pull request #2043 from ahocevar/nicer-api-docs

Nicer API docs

src/ol/source/geojsonsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.StaticVector');
 /**
  * @constructor
  * @extends {ol.source.StaticVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.GeoJSONOptions=} opt_options Options.
  * @todo api
  */

src/ol/source/gpxsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.StaticVector');
 /**
  * @constructor
  * @extends {ol.source.StaticVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.GPXOptions=} opt_options Options.
  * @todo api
  */

src/ol/source/igcsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.StaticVector');
 /**
  * @constructor
  * @extends {ol.source.StaticVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.IGCOptions=} opt_options Options.
  * @todo api
  */

src/ol/source/kmlsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.StaticVector');
 /**
  * @constructor
  * @extends {ol.source.StaticVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.KMLOptions=} opt_options Options.
  * @todo api
  */

src/ol/source/osmxmlsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.StaticVector');
 /**
  * @constructor
  * @extends {ol.source.StaticVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.OSMXMLOptions=} opt_options Options.
  * @todo api
  */

src/ol/source/source.js

@@ -9,7 +9,10 @@ goog.require('ol.proj');
 
 
 /**
+ * State of the source. `0` means 'loading', `1` means 'ready', and `2` means
+ * 'error'.
  * @enum {number}
+ * @todo api
  */
 ol.source.State = {
   LOADING: 0,

src/ol/source/staticvectorsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.State');
 /**
  * @constructor
  * @extends {ol.source.FormatVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.StaticVectorOptions} options Options.
  * @todo api
  */

src/ol/source/topojsonsource.js

@@ -8,7 +8,7 @@ goog.require('ol.source.StaticVector');
 /**
  * @constructor
  * @extends {ol.source.StaticVector}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.TopoJSONOptions=} opt_options Options.
  * @todo api
  */

src/ol/source/vectorsource.js

@@ -41,7 +41,7 @@ ol.source.VectorEventType = {
 /**
  * @constructor
  * @extends {ol.source.Source}
- * @fires {@link ol.source.VectorEvent} ol.source.VectorEvent
+ * @fires ol.source.VectorEvent
  * @param {olx.source.VectorOptions=} opt_options Vector source options.
  * @todo api
  */