Pullup changes to trunk for RC2. Includes drag-fires click changes

(Closes #982), comment/documentation/requires changes (Closes #983, #993, #988),
Fixing post support in proxy.cgi (Closes #991), baseLayer zoom level change 
(Closes #990), typo in Layer.Image.setURL (Closes #985), and a fix or the
Layer.Google bug caused by Google's changing internals (#994). RC2, here we 
come.


git-svn-id: http://svn.openlayers.org/branches/openlayers/2.5@4390 dc9f47b5-9b13-0410-9fdd-eb0c1a62fdaf

lib/OpenLayers/Control/PanZoom.js

@@ -15,13 +15,13 @@ OpenLayers.Control.PanZoom = OpenLayers.Class(OpenLayers.Control, {
 
     /** 
      * APIProperty: slideFactor
-     * {Float}
+     * {Integer}
      */
     slideFactor: 50,
 
     /** 
      * Property: buttons
-     * Array of Button Divs 
+     * {Array(DOMElement)} Array of Button Divs 
      */
     buttons: null,
 
@@ -32,9 +32,12 @@ OpenLayers.Control.PanZoom = OpenLayers.Class(OpenLayers.Control, {
     position: null,
 
     /**
-     * Constructor: OpenLayers.PanZoom
+     * Constructor: OpenLayers.Control.PanZoom
+     * 
+     * Parameters:
+     * options - {Object}
      */
-    initialize: function() {
+    initialize: function(options) {
         this.position = new OpenLayers.Pixel(OpenLayers.Control.PanZoom.X,
                                              OpenLayers.Control.PanZoom.Y);
         OpenLayers.Control.prototype.initialize.apply(this, arguments);
@@ -61,7 +64,7 @@ OpenLayers.Control.PanZoom = OpenLayers.Class(OpenLayers.Control, {
      * px - {<OpenLayers.Pixel>} 
      * 
      * Returns:
-     * {DOMElement} A reference to the container div for the PanZoom control
+     * {DOMElement} A reference to the container div for the PanZoom control.
      */
     draw: function(px) {
         // initialize our internal div
@@ -100,7 +103,7 @@ OpenLayers.Control.PanZoom = OpenLayers.Class(OpenLayers.Control, {
      * 
      * Returns:
      * {DOMElement} A Div (an alphaImageDiv, to be precise) that contains the
-     * image of the button, and has all the proper event handlers set.
+     *     image of the button, and has all the proper event handlers set.
      */
     _addButton:function(id, img, xy, sz) {
         var imgLocation = OpenLayers.Util.getImagesLocation() + img;
@@ -179,5 +182,14 @@ OpenLayers.Control.PanZoom = OpenLayers.Class(OpenLayers.Control, {
     CLASS_NAME: "OpenLayers.Control.PanZoom"
 });
 
+/**
+ * Constant: X
+ * {Integer}
+ */
 OpenLayers.Control.PanZoom.X = 4;
+
+/**
+ * Constant: Y
+ * {Integer}
+ */
 OpenLayers.Control.PanZoom.Y = 4;