From 22df17c192271f6e9c4e5f8050d8d206df194182 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=BCrg=20Lehni?= <juerg@scratchdisk.com>
Date: Fri, 28 Jun 2013 06:41:36 -0700
Subject: [PATCH] Docs: Minor cleanups.

---
 src/basic/Point.js     |  2 +-
 src/basic/Rectangle.js |  4 ++--
 src/style/Gradient.js  | 24 +++++++++++++-----------
 3 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/src/basic/Point.js b/src/basic/Point.js
index 2dfc283f..7dbe3d24 100644
--- a/src/basic/Point.js
+++ b/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
diff --git a/src/basic/Rectangle.js b/src/basic/Rectangle.js
index de86b5f1..55fb81e6 100644
--- a/src/basic/Rectangle.js
+++ b/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({
diff --git a/src/style/Gradient.js b/src/style/Gradient.js
index 2dbcca19..af36bc45 100644
--- a/src/style/Gradient.js
+++ b/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,