diff --git a/lib/OpenLayers/Marker.js b/lib/OpenLayers/Marker.js
index b0ef31ee9d..cb5cc41a05 100644
--- a/lib/OpenLayers/Marker.js
+++ b/lib/OpenLayers/Marker.js
@@ -23,8 +23,14 @@
  * var offset = new OpenLayers.Pixel(-(size.w/2), -size.h);
  * var icon = new OpenLayers.Icon('http://boston.openguides.org/markers/AQUA.png',size,offset);
  * markers.addMarker(new OpenLayers.Marker(new OpenLayers.LonLat(0,0),icon));
+ * markers.addMarker(new OpenLayers.Marker(new OpenLayers.LonLat(0,0),icon.clone()));
  *
  * (end)
+ *
+ * Note that if you pass an icon into the Marker constructor, it will take
+ * that icon and use it. This means that you should not share icons between
+ * markers -- you use them once, but you should clone() for any additional
+ * markers using that same icon.
  */
 OpenLayers.Marker = OpenLayers.Class({