Add comments about drawFeature being only for redrawing, not for initial

isualization.  


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

lib/OpenLayers/Layer/Vector.js

@@ -601,6 +601,13 @@ OpenLayers.Layer.Vector = OpenLayers.Class(OpenLayers.Layer, {
      * feature's style will be used.  If the feature doesn't have a style,
      * the layer's style will be used.
      * 
+     * This function is not designed to be used when adding features to 
+     * the layer (use addFeatures instead). It is meant to be used when
+     * the style of a feature has changed, or in some other way needs to 
+     * visually updated *after* it has already been added to a layer. You
+     * must add the feature to the layer for most layer-related events to 
+     * happen.
+     *
      * Parameters: 
      * feature - {<OpenLayers.Feature.Vector>} 
      * style - {Object} Symbolizer hash or {String} renderIntent