updated stage docs

src/Node.js

@@ -735,10 +735,13 @@
          * @name toDataURL
          * @methodOf Kinetic.Node.prototype
          * @param {Object} config
-         * @param {String} [config.mimeType] mime type.  can be "image/png" or "image/jpeg".
+         * @param {Function} config.callback function executed when the composite has completed
+         * @param {String} [config.mimeType] can be "image/png" or "image/jpeg".
          *  "image/png" is the default
-         * @param {Number} [config.width] data url image width
+         * @param {Number} [config.x] x position of canvas section
-         * @param {Number} [config.height] data url image height
+         * @param {Number} [config.y] y position of canvas section
+         * @param {Number} [config.width] width of canvas section
+         * @param {Number} [config.height] height of canvas section
          * @param {Number} [config.quality] jpeg quality.  If using an "image/jpeg" mimeType,
          *  you can specify the quality from 0 to 1, where 0 is very poor quality and 1
          *  is very high quality
@@ -772,11 +775,13 @@
          * @name toImage
          * @methodOf Kinetic.Node.prototype
          * @param {Object} config
-         * @param {Function} config.callback function that is passed the image object
+         * @param {Function} config.callback function executed when the composite has completed
-         * @param {String} [config.mimeType] mime type.  can be "image/png" or "image/jpeg".
+         * @param {String} [config.mimeType] can be "image/png" or "image/jpeg".
          *  "image/png" is the default
-         * @param {Number} [config.width] data url image width
+         * @param {Number} [config.x] x position of canvas section
-         * @param {Number} [config.height] data url image height
+         * @param {Number} [config.y] y position of canvas section
+         * @param {Number} [config.width] width of canvas section
+         * @param {Number} [config.height] height of canvas section
          * @param {Number} [config.quality] jpeg quality.  If using an "image/jpeg" mimeType,
          *  you can specify the quality from 0 to 1, where 0 is very poor quality and 1
          *  is very high quality

src/Stage.js

@@ -50,6 +50,12 @@
             this._addName(this);
 
         },
+        /**
+         * set container dom element which contains the stage wrapper div element
+         * @name setContainer
+         * @methodOf Kinetic.Stage.prototype
+         * @param {DomElement} container can pass in a dom element or id string
+         */
         setContainer: function(container) {
             /*
              * if container is a string, assume it's an id for
@@ -61,13 +67,13 @@
             this.setAttr('container', container);
         },
         /**
-         * draw layer scenes
+         * draw layer scene graphs
          * @name draw
          * @methodOf Kinetic.Stage.prototype
          */
 
         /**
-         * draw layer hits
+         * draw layer hit graphs
          * @name drawHit
          * @methodOf Kinetic.Stage.prototype
          */
@@ -120,27 +126,24 @@
          * get mouse position for desktop apps
          * @name getMousePosition
          * @methodOf Kinetic.Stage.prototype
-         * @param {Event} evt
          */
-        getMousePosition: function(evt) {
+        getMousePosition: function() {
             return this.mousePos;
         },
         /**
          * get touch position for mobile apps
          * @name getTouchPosition
          * @methodOf Kinetic.Stage.prototype
-         * @param {Event} evt
          */
-        getTouchPosition: function(evt) {
+        getTouchPosition: function() {
             return this.touchPos;
         },
         /**
-         * get user position (mouse position or touch position)
+         * get user position which can be a touc position or mouse position
          * @name getUserPosition
          * @methodOf Kinetic.Stage.prototype
-         * @param {Event} evt
          */
-        getUserPosition: function(evt) {
+        getUserPosition: function() {
             return this.getTouchPosition() || this.getMousePosition();
         },
         /**
@@ -152,7 +155,7 @@
             return this;
         },
         /**
-         * get stage DOM node, which is a div element
+         * get stage DOM node which is a div element
          *  with the class name "kineticjs-content"
          * @name getDOM
          * @methodOf Kinetic.Stage.prototype
@@ -161,22 +164,17 @@
             return this.content;
         },
         /**
-         * Creates a composite data URL and requires a callback because the stage
+         * Creates a composite data URL and requires a callback because the composite is generated asynchronously.
-         *  toDataURL method is asynchronous. If MIME type is not
-         *  specified, then "image/png" will result. For "image/jpeg", specify a quality
-         *  level as quality (range 0.0 - 1.0).  Note that this method works
-         *  differently from toDataURL() for other nodes because it generates an absolute dataURL
-         *  based on what's draw onto the canvases for each layer, rather than drawing
-         *  the current state of each node
          * @name toDataURL
          * @methodOf Kinetic.Stage.prototype
          * @param {Object} config
-         * @param {Function} config.callback since the stage toDataURL() method is asynchronous,
+         * @param {Function} config.callback function executed when the composite has completed
-         *  the data url string will be passed into the callback
+         * @param {String} [config.mimeType] can be "image/png" or "image/jpeg".
-         * @param {String} [config.mimeType] mime type.  can be "image/png" or "image/jpeg".
          *  "image/png" is the default
-         * @param {Number} [config.width] data url image width
+         * @param {Number} [config.x] x position of canvas section
-         * @param {Number} [config.height] data url image height
+         * @param {Number} [config.y] y position of canvas section
+         * @param {Number} [config.width] width of canvas section
+         * @param {Number} [config.height] height of canvas section
          * @param {Number} [config.quality] jpeg quality.  If using an "image/jpeg" mimeType,
          *  you can specify the quality from 0 to 1, where 0 is very poor quality and 1
          *  is very high quality
@@ -208,17 +206,17 @@
             drawLayer(0);
         },
         /**
-         * converts stage into an image.  Since the stage toImage() method
+         * converts stage into an image. 
-         *  is asynchronous, a callback function is required
          * @name toImage
          * @methodOf Kinetic.Stage.prototype
          * @param {Object} config
-         * @param {Function} callback since the toImage() method is asynchonrous, the
+         * @param {Function} config.callback function executed when the composite has completed
-         *  resulting image object is passed into the callback function
+         * @param {String} [config.mimeType] can be "image/png" or "image/jpeg".
-         * @param {String} [config.mimeType] mime type.  can be "image/png" or "image/jpeg".
          *  "image/png" is the default
-         * @param {Number} [config.width] data url image width
+         * @param {Number} [config.x] x position of canvas section
-         * @param {Number} [config.height] data url image height
+         * @param {Number} [config.y] y position of canvas section
+         * @param {Number} [config.width] width of canvas section
+         * @param {Number} [config.height] height of canvas section
          * @param {Number} [config.quality] jpeg quality.  If using an "image/jpeg" mimeType,
          *  you can specify the quality from 0 to 1, where 0 is very poor quality and 1
          *  is very high quality
@@ -300,7 +298,7 @@
         },
         /**
          * add layer to stage
-         * @param {Layer} layer
+         * @param {Kinetic.Layer} layer
          */
         add: function(layer) {
             Kinetic.Container.prototype.add.call(this, layer);