Comment cleanup. Enyo-DCO-1.0-Signed-off-by: Jim Tang <jim.tang@palm.…

…com>
enyojs · Aug 15, 2012 · 36132b3 · 36132b3
1 parent 017ca95
commit 36132b3
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 21 deletions.
diff --git a/source/ajax/WebService.js b/source/ajax/WebService.js
@@ -21,7 +21,7 @@ enyo.kind({
 	name: "enyo.WebService",
 	kind: enyo._AjaxComponent,
 	published: {
-		//* Set to true to use JSONP protocol.
+		//* Set to true to use JSONP protocol
 		jsonp: false,
 		/**
 			When using JSONP, the name of the callback parameter.
@@ -30,20 +30,27 @@ enyo.kind({
 			internal callback function as necessary.
 		*/
 		callbackName: "callback",
-		//* When using JSONP, optional character set to use to interpret the return data
+		/**
+			When using JSONP, optional character set to use to interpret the
+			return data
+		*/
 		charset: null
 	},
 	events: {
 		/**
-			Fires when a response is received. The _ajax_ property contains the
-			associated Async instance, while the _data_ property contains the
-			response data.
+			Fires when a response is received.
+			
+			_inEvent.ajax_ contains the Async instance associated with the request.
+			
+			_inEvent.data_ contains the response data.
 		*/
 		onResponse: "",
 		/**
-			Fires when an error is received. The _ajax_ property contains the
-			associated Async instance, while the _data_ property contains the
-			error data.
+			Fires when an error is received.
+			
+			_inEvent.ajax_ contains the	Async instance associated with the request.
+			
+			_inEvent.data_ contains the error data.
 		*/
 		onError: ""
 	},

diff --git a/source/ui/Repeater.js b/source/ui/Repeater.js
@@ -34,9 +34,11 @@ enyo.kind({
 	},
 	events: {
 		/**
-			Fires when each item is created. The _index_ property contains the
-			item index, and the _item_ property contains the item control, for
-			decoration.
+			Fires when each item is created.
+			
+			_inEvent.index_ contains the item's index.
+			
+			_inEvent.item_ contains the item control, for decoration.
 		*/
 		onSetupItem: ""
 	},

diff --git a/source/ui/Selection.js b/source/ui/Selection.js
@@ -28,7 +28,7 @@ enyo.kind({
 	name: "enyo.Selection",
 	kind: enyo.Component,
 	published: {
-		//* If true, multiple selections are allowed.
+		//* If true, multiple selections are allowed
 		multi: false
 	},
 	events: {
@@ -40,10 +40,11 @@ enyo.kind({
 				selectRow: function(inSender, inEvent) {
 					...
 
-			The event's _key_ property is whatever key was used to register the
-			selection (usually a row index), while the _data_ property
-			references data registered with this key by the	code that made the
-			original selection.
+			_inEvent.key_ is whatever key was used to register the selection
+			(usually a row index).
+			
+			_inEvent.data_ references data registered with this key by the code
+			that made the original selection.
 		*/
 		onSelect: "",
 		/**
@@ -54,13 +55,14 @@ enyo.kind({
 				deselectRow: function(inSender, inEvent)
 					...
 
-			The event's _key_ property is whatever key was used to request the
-			deselection (usually a row index), while the _data_ property
-			references data registered with this key by the	code that made the
-			selection.
+			_inEvent.key_ is whatever key was used to request the deselection
+			(usually a row index).
+			
+			_inEvent.data_ references data registered with this key by the code
+			that made the selection.
 		*/
 		onDeselect: "",
-		//* Sent when selection changes (but not when the selection is cleared).
+		//* Fires when selection changes (but not when selection is cleared).
 		onChange: ""
 	},
 	//* @protected