diff --git a/lib/OpenLayers/Layer.js b/lib/OpenLayers/Layer.js
index df8032e001..70bbacd4d6 100644
--- a/lib/OpenLayers/Layer.js
+++ b/lib/OpenLayers/Layer.js
@@ -8,7 +8,8 @@ OpenLayers.Layer.prototype = {
     // DOMElement
     div: null,
 
-    // OpenLayers.Map
+    /** This variable is set in map.addLayer, not within the layer itself
+    * @type OpenLayers.Map */
     map: null,
 
     // str -- projection for use in WFS, WMS, etc.