Docs: Minor cleanups.

src/basic/Point.js

@@ -71,7 +71,7 @@ var Point = Base.extend(/** @lends Point# */{
 	 * Creates a Point object using the properties in the given object.
 	 *
 	 * @name Point#initialize
-	 * @param {object} object
+	 * @param {object} the object describing the point's properties
 	 *
 	 * @example
 	 * // Creating a point using an object literal with length and angle

src/basic/Rectangle.js

@@ -33,8 +33,8 @@ var Rectangle = Base.extend(/** @lends Rectangle# */{
 	 * Creates a Rectangle object.
 	 *
 	 * @name Rectangle#initialize
-	 * @param {Object} object An object literal containing properties to be
-	 * set on the rectangle.
+	 * @param {Object} object an object containing properties to be set on the
+	 *        rectangle.
 	 * 
 	 * @example // Create a rectangle between {x: 20, y: 20} and {x: 80, y:80}
 	 * var rectangle = new Rectangle({

src/style/Gradient.js

@@ -26,17 +26,19 @@
  * 
  * // Create a rectangle shaped path between
  * // the topLeft and bottomRight points:
- * var path = new Path.Rectangle(topLeft, bottomRight);
- * 
- * // Fill the path with a gradient of three evenly divided color stops
- * // that runs between the two points we defined earlier:
- * path.fillColor = {
- * 	gradient: {
- * 		stops: ['yellow', 'red', 'blue']
- * 	},
- * 	origin: topLeft,
- * 	destination: bottomRight
- * };
+ * var path = new Path.Rectangle({
+ * 	topLeft: topLeft,
+ * 	bottomRight: bottomRight,
+ * 	// Fill the path with a gradient of three color stops
+ * 	// that runs between the two points we defined earlier:
+ * 	fillColor: {
+ * 		gradient: {
+ * 			stops: ['yellow', 'red', 'blue']
+ * 		},
+ * 		origin: topLeft,
+ * 		destination: bottomRight
+ * 	}
+ * });
  * 
  * @classexample {@paperscript height=300}
  * // Create a circle shaped path at the center of the view,