added documentation

Author: Allen Kim

services/ng-map-pool.js

@@ -1,5 +1,15 @@
+/**
+ * @ngdoc factory
+ * @name NgMapPool
+ * @description
+ *   Provide map instance to avoid memory leak
+ */
 (function() {
   'use strict';
+  /**
+   * @memberof NgMapPool
+   * @desc map instance pool
+   */
   var mapInstances = [];
   var $window, $document;
 
@@ -27,6 +37,12 @@
     return notInUseMap;
   };
 
+  /**
+   * @memberof NgMapPool
+   * @function getMapInstance
+   * @param {HtmlElement} el map container element
+   * @return map instance for the given element
+   */
   var getMapInstance = function(el) {
     var map = find(el);
     if (!map) {
@@ -36,6 +52,13 @@
     return map;
   };
 
+  /**
+   * @memberof NgMapPool
+   * @function returnMapInstance
+   * @param {Map} an instance of google.maps.Map
+   * @desc sets the flag inUse of the given map instance to false, so that it 
+   * can be reused later
+   */
   var returnMapInstance = function(map) {
     map.inUse = false;
   };

services/ng-map.js

@@ -156,9 +156,9 @@
 
   /**
    * @memberof NgMap
-   * @function getMap
-   * @param {Hash} options optional, e.g., {id: 'foo, timeout: 5000}
-   * @returns promise
+   * @function setStyle
+   * @param {HtmlElement} map contriner element
+   * @desc set display, width, height of map container element
    */
   var setStyle = function(el) {
     //if style is not given to the map element, set display and height