diff --git a/lib/OpenLayers/Feature.js b/lib/OpenLayers/Feature.js
index 66f9a1090e..1164a5bfc8 100644
--- a/lib/OpenLayers/Feature.js
+++ b/lib/OpenLayers/Feature.js
@@ -153,9 +153,9 @@ OpenLayers.Feature = OpenLayers.Class({
 
     /**
      * Method: createPopup
-     *  Creates a popup object created from the 'lonlat', 'popupSize',
-     *  and 'popupContentHTML' properties set in this.data. It uses
-     *  this.marker.icon as default anchor. 
+     * Creates a popup object created from the 'lonlat', 'popupSize',
+     *     and 'popupContentHTML' properties set in this.data. It uses
+     *     this.marker.icon as default anchor. 
      *  
      *  If no 'lonlat' is set, returns null. 
      *  If no this.marker has been created, no anchor is sent.
@@ -166,7 +166,10 @@ OpenLayers.Feature = OpenLayers.Class({
      * closeBox - {Boolean} create popup with closebox or not
      * 
      * Returns:
-     * {<OpenLayers.Popup.AnchoredBubble>} 
+     * {<OpenLayers.Popup>} Returns the created popup, which is also set
+     *     as 'popup' property of this feature. Will be of whatever type
+     *     specified by this feature's 'popupClass' property, but must be
+     *     of type <OpenLayers.Popup>.
      * 
      */
     createPopup: function(closeBox) {