updated more docs in reference to intersects(), getIntersections(), and getAllIntersections()

src/Container.js

@@ -155,7 +155,10 @@
             return node;
         },
         /**
-         * get all shapes that intersect a point
+         * get all shapes that intersect a point.  Note: because this method must clear a temporary
+         * canvas and redraw every shape inside the container, it should only be used for special sitations 
+         * because it performs very poorly.  Please use the {@link Kinetic.Stage#getIntersection} method if at all possible
+         * because it performs much better
          * @method
          * @memberof Kinetic.Container.prototype
          * @param {Object} pos

src/Shape.js

@@ -76,7 +76,8 @@
         /**
          * determines if point is in the shape, regardless if other shapes are on top of it.  Note: because
          * this method clears a temp hit canvas, and redraws the shape, it performs very poorly if executed many times
-         * consecutively.  If possible, it's better to use the stage.getIntersection() method instead
+         * consecutively.  Please use the {@link Kinetic.Stage#getIntersection} method if at all possible
+         * because it performs much better
          * @method
          * @memberof Kinetic.Shape.prototype
          * @param {Object} point point can be an object containing