fix for #787 - put clearArray() in its place ((marked as deprecated, throwing a console warning during use, all usage replaced in code))

git-svn-id: http://svn.openlayers.org/trunk/openlayers@3636 dc9f47b5-9b13-0410-9fdd-eb0c1a62fdaf

lib/OpenLayers/Util.js

@@ -71,8 +71,16 @@ OpenLayers.Util.removeItem = function(array, item) {
 
 /**
  * Function: clearArray
-*/
+ * *Deprecated*. This function will disappear in 3.0.
+ * Please use "array.length = 0" instead.
+ * 
+ * Parameters:
+ * array - {Array}
+ */
 OpenLayers.Util.clearArray = function(array) {
+    var msg = "OpenLayers.Util.clearArray() is Deprecated." +
+              " Please use 'array.length = 0' instead.";
+    OpenLayers.Console.warn(msg);
     array.length = 0;
 };