Add more content for the API doc

Involves additions to (there will be subsequent pull requests for other
classes):
- ol.Attribution
- ol.Collection
- ol.Expression
- ol.Feature
- ol.Geolocation
- ol.Map
- ol.Object
- ol.Overlay
- ol.Projection
- ol.View2D
- ol.control.Attribution
- ol.control.Control
- ol.control.FullScreen
- ol.control.Logo
- ol.control.MousePosition
- ol.control.ScaleLine
- ol.control.Zoom
- ol.control.ZoomSlider
- ol.dom.Input
- ol.filter.Filter
- ol.filter.Geometry
- ol.filter.Logical

src/ol/attribution.js

@@ -5,9 +5,23 @@ goog.require('ol.TileRange');
 
 
 /**
+ * Create a new attribution to be associated with a layer source.
+ *
+ * Example:
+ *
+ *     source: new ol.source.OSM({
+ *       attributions: [
+ *       new ol.Attribution(
+ *         'All maps © ' +
+ *         '<a href="http://www.opencyclemap.org/">OpenCycleMap</a>'),
+ *       ol.source.OSM.DATA_ATTRIBUTION
+ *     ],
+ *     ..
+ *
  * @constructor
- * @param {string} html HTML.
- * @param {Object.<string, Array.<ol.TileRange>>=} opt_tileRanges Tile ranges.
+ * @param {string} html The markup to use for display of the attribution.
+ * @param {Object.<string, Array.<ol.TileRange>>=} opt_tileRanges Tile ranges
+ *     (FOR INTERNAL USE ONLY).
  */
 ol.Attribution = function(html, opt_tileRanges) {