diff --git a/lib/OpenLayers/Layer/Markers.js b/lib/OpenLayers/Layer/Markers.js
index b2f58a63ac..886c99df0b 100644
--- a/lib/OpenLayers/Layer/Markers.js
+++ b/lib/OpenLayers/Layer/Markers.js
@@ -109,6 +109,8 @@ OpenLayers.Layer.Markers.prototype =
 
     /**
      * Method: clearMarkers
+     * This method removes all markers from a layer. The markers are not
+     * destroyed by this function, but are removed from the list of markers.
      */
     clearMarkers: function() {
         if (this.markers != null) {