diff --git a/lib/OpenLayers/Icon.js b/lib/OpenLayers/Icon.js
index 016121e480..708eb8623f 100644
--- a/lib/OpenLayers/Icon.js
+++ b/lib/OpenLayers/Icon.js
@@ -29,13 +29,16 @@ OpenLayers.Icon = OpenLayers.Class({
     
     /** 
      * Property: size 
-     * {<OpenLayers.Size>} 
+     * {<OpenLayers.Size>|Object} An OpenLayers.Size or
+     * an object with a 'w' and 'h' properties.
      */
     size: null,
 
     /** 
      * Property: offset 
-     * {<OpenLayers.Pixel>} distance in pixels to offset the image when being rendered
+     * {<OpenLayers.Pixel>|Object} distance in pixels to offset the
+     * image when being rendered. An OpenLayers.Pixel or an object
+     * with a 'x' and 'y' properties.
      */
     offset: null,    
     
@@ -62,8 +65,12 @@ OpenLayers.Icon = OpenLayers.Class({
      * Creates an icon, which is an image tag in a div.  
      *
      * url - {String} 
-     * size - {<OpenLayers.Size>} 
-     * offset - {<OpenLayers.Pixel>}
+     * size - {<OpenLayers.Size>|Object} An OpenLayers.Size or an
+     *                                   object with a 'w' and 'h'
+     *                                   properties.
+     * offset - {<OpenLayers.Pixel>|Object} An OpenLayers.Pixel or an
+     *                                      object with a 'x' and 'y'
+     *                                      properties.
      * calculateOffset - {Function} 
      */
     initialize: function(url, size, offset, calculateOffset) {