dojo-rails 0.9.9 → 0.9.10

data/vendor/assets/javascripts/dojo/data/api/Item.js

@@ -0,0 +1,10 @@
+/*
+	Copyright (c) 2004-2011, The Dojo Foundation All Rights Reserved.
+	Available via Academic Free License >= 2.1 OR the modified BSD license.
+	see: http://dojotoolkit.org/license for details
+*/
+
+//>>built
+define("dojo/data/api/Item",["../../_base/declare"],function(_1){
+return _1(null,{});
+});

data/vendor/assets/javascripts/dojo/data/api/Item.js.uncompressed.js

@@ -0,0 +1,13 @@
+define("dojo/data/api/Item", ["../../_base/declare"], function(declare){
+
+	// module:
+	//		dojo/data/api/Item
+
+	return declare(null, {
+		// summary:
+		//		An item in a dojo/data store
+		//		Class for documentation purposes only. An item can take any form, so no 
+		// 		properties or methods are defined here.
+	});
+
+});

data/vendor/assets/javascripts/dojo/data/api/Notification.js

@@ -5,15 +5,14 @@
 */
 
 //>>built
-define("dojo/data/api/Notification",["../..","./Read"],function(_1){
-_1.declare("dojo.data.api.Notification",_1.data.api.Read,{getFeatures:function(){
+define("dojo/data/api/Notification",["../../_base/declare","./Read"],function(_1,_2){
+return _1("dojo.data.api.Notification",_2,{getFeatures:function(){
 return {"dojo.data.api.Read":true,"dojo.data.api.Notification":true};
-},onSet:function(_2,_3,_4,_5){
+},onSet:function(_3,_4,_5,_6){
 throw new Error("Unimplemented API: dojo.data.api.Notification.onSet");
-},onNew:function(_6,_7){
+},onNew:function(_7,_8){
 throw new Error("Unimplemented API: dojo.data.api.Notification.onNew");
-},onDelete:function(_8){
+},onDelete:function(_9){
 throw new Error("Unimplemented API: dojo.data.api.Notification.onDelete");
 }});
-return _1.data.api.Notification;
 });

data/vendor/assets/javascripts/dojo/data/api/Notification.js.uncompressed.js

@@ -1,17 +1,14 @@
-define("dojo/data/api/Notification", ["../..", "./Read"], function(dojo) {
-	// module:
-	//		dojo/data/api/Notification
-	// summary:
-	//		TODOC
+define("dojo/data/api/Notification", ["../../_base/declare", "./Read"], function(declare, Read){
 
+// module:
+//		dojo/data/api/Notification
 
-dojo.declare("dojo.data.api.Notification", dojo.data.api.Read, {
-	//	summary:
+return declare("dojo.data.api.Notification", Read, {
+	// summary:
 	//		This is an abstract API that data provider implementations conform to.
 	//		This file defines functions signatures and intentionally leaves all the
 	//		functions unimplemented.
-	//
-	//	description:
+	// description:
 	//		This API defines a set of APIs that all datastores that conform to the
 	//		Notifications API must implement.  In general, most stores will implement
 	//		these APIs as no-op functions for users who wish to monitor them to be able
@@ -21,102 +18,93 @@ dojo.declare("dojo.data.api.Notification", dojo.data.api.Read, {
 	//		this feature.  In the case of a read-only store, this feature makes sense if
 	//		the store itself does internal polling to a back-end server and periodically updates
 	//		its cache of items (deletes, adds, and updates).
-	//
-	//	example:
-	//
-	//	|	function onSet(item, attribute, oldValue, newValue) {
+	// example:
+	//	|	function onSet(item, attribute, oldValue, newValue){
 	//	|		//Do something with the information...
 	//	|	};
 	//	|	var store = new some.newStore();
 	//	|	dojo.connect(store, "onSet", onSet);
 
 	getFeatures: function(){
-		//	summary:
-		//		See dojo.data.api.Read.getFeatures()
+		// summary:
+		//		See dojo/data/api/Read.getFeatures()
 		return {
 			'dojo.data.api.Read': true,
 			'dojo.data.api.Notification': true
 		};
 	},
 
-	onSet: function(/* item */ item,
+	onSet: function(/* dojo/data/api/Item */ item,
 					/* attribute-name-string */ attribute,
 					/* object|array */ oldValue,
 					/* object|array */ newValue){
-		//	summary:
+		// summary:
 		//		This function is called any time an item is modified via setValue, setValues, unsetAttribute, etc.
-		//	description:
+		// description:
 		//		This function is called any time an item is modified via setValue, setValues, unsetAttribute, etc.
 		//		Its purpose is to provide a hook point for those who wish to monitor actions on items in the store
 		//		in a simple manner.  The general expected usage is to dojo.connect() to the store's
 		//		implementation and be called after the store function is called.
-		//
-		//	item:
+		// item:
 		//		The item being modified.
-		//	attribute:
+		// attribute:
 		//		The attribute being changed represented as a string name.
-		//	oldValue:
+		// oldValue:
 		//		The old value of the attribute.  In the case of single value calls, such as setValue, unsetAttribute, etc,
 		//		this value will be generally be an atomic value of some sort (string, int, etc, object).  In the case of
 		//		multi-valued attributes, it will be an array.
-		//	newValue:
+		// newValue:
 		//		The new value of the attribute.  In the case of single value calls, such as setValue, this value will be
 		//		generally be an atomic value of some sort (string, int, etc, object).  In the case of multi-valued attributes,
 		//		it will be an array.  In the case of unsetAttribute, the new value will be 'undefined'.
-		//
-		//	returns:
+		// returns:
 		//		Nothing.
 		throw new Error('Unimplemented API: dojo.data.api.Notification.onSet');
 	},
 
-	onNew: function(/* item */ newItem, /*object?*/ parentInfo){
-		//	summary:
+	onNew: function(/* dojo/data/api/Item */ newItem, /*object?*/ parentInfo){
+		// summary:
 		//		This function is called any time a new item is created in the store.
 		//		It is called immediately after the store newItem processing has completed.
-		//	description:
+		// description:
 		//		This function is called any time a new item is created in the store.
 		//		It is called immediately after the store newItem processing has completed.
-		//
-		//	newItem:
+		// newItem:
 		//		The item created.
-		//	parentInfo:
+		// parentInfo:
 		//		An optional javascript object that is passed when the item created was placed in the store
 		//		hierarchy as a value f another item's attribute, instead of a root level item.  Note that if this
 		//		function is invoked with a value for parentInfo, then onSet is not invoked stating the attribute of
 		//		the parent item was modified.  This is to avoid getting two notification  events occurring when a new item
 		//		with a parent is created.  The structure passed in is as follows:
-		//		{
-		//			item: someItem,							//The parent item
-		//			attribute:	"attribute-name-string",	//The attribute the new item was assigned to.
-		//			oldValue: something	//Whatever was the previous value for the attribute.
-		//						//If it is a single-value attribute only, then this value will be a single value.
-		//						//If it was a multi-valued attribute, then this will be an array of all the values minues the new one.
-		//			newValue: something	//The new value of the attribute.  In the case of single value calls, such as setValue, this value will be
-		//						//generally be an atomic value of some sort (string, int, etc, object).  In the case of multi-valued attributes,
-		//						//it will be an array.
-		//		}
-		//
-		//	returns:
+		// |	{
+		// |		item: someItem,							//The parent item
+		// |		attribute:	"attribute-name-string",	//The attribute the new item was assigned to.
+		// |		oldValue: something	//Whatever was the previous value for the attribute.
+		// |					//If it is a single-value attribute only, then this value will be a single value.
+		// |					//If it was a multi-valued attribute, then this will be an array of all the values minus the new one.
+		// |		newValue: something	//The new value of the attribute.  In the case of single value calls, such as setValue, this value will be
+		// |					//generally be an atomic value of some sort (string, int, etc, object).  In the case of multi-valued attributes,
+		// |					//it will be an array.
+		// |	}
+		// returns:
 		//		Nothing.
 		throw new Error('Unimplemented API: dojo.data.api.Notification.onNew');
 	},
 
-	onDelete: function(/* item */ deletedItem){
-		//	summary:
+	onDelete: function(/* dojo/data/api/Item */ deletedItem){
+		// summary:
 		//		This function is called any time an item is deleted from the store.
 		//		It is called immediately after the store deleteItem processing has completed.
-		//	description:
+		// description:
 		//		This function is called any time an item is deleted from the store.
 		//		It is called immediately after the store deleteItem processing has completed.
-		//
-		//	deletedItem:
+		// deletedItem:
 		//		The item deleted.
-		//
-		//	returns:
+		// returns:
 		//		Nothing.
 		throw new Error('Unimplemented API: dojo.data.api.Notification.onDelete');
 	}
 });
 
-return dojo.data.api.Notification;
 });

data/vendor/assets/javascripts/dojo/data/api/Read.js

@@ -5,8 +5,8 @@
 */
 
 //>>built
-define("dojo/data/api/Read",["../..","./Request"],function(_1){
-_1.declare("dojo.data.api.Read",null,{getValue:function(_2,_3,_4){
+define("dojo/data/api/Read",["../../_base/declare"],function(_1){
+return _1("dojo.data.api.Read",null,{getValue:function(_2,_3,_4){
 throw new Error("Unimplemented API: dojo.data.api.Read.getValue");
 },getValues:function(_5,_6){
 throw new Error("Unimplemented API: dojo.data.api.Read.getValues");
@@ -35,5 +35,4 @@ throw new Error("Unimplemented API: dojo.data.api.Read.getLabel");
 },getLabelAttributes:function(_13){
 throw new Error("Unimplemented API: dojo.data.api.Read.getLabelAttributes");
 }});
-return _1.data.api.Read;
 });

data/vendor/assets/javascripts/dojo/data/api/Read.js.uncompressed.js

@@ -1,18 +1,16 @@
-define("dojo/data/api/Read", ["../..", "./Request"], function(dojo) {
-	// module:
-	//		dojo/data/api/Read
-	// summary:
-	//		TODOC
+define("dojo/data/api/Read", ["../../_base/declare"], function(declare){
 
+// module:
+//		dojo/data/api/Read
 
-dojo.declare("dojo.data.api.Read", null, {
+return declare("dojo.data.api.Read", null, {
 	// summary:
 	//		This is an abstract API that data provider implementations conform to.
 	//		This file defines methods signatures and intentionally leaves all the
 	//		methods unimplemented.  For more information on the dojo.data APIs,
 	//		please visit: http://www.dojotoolkit.org/node/98
 
-	getValue: function(	/* item */ item,
+	getValue: function(	/* dojo/data/api/Item */ item,
 						/* attribute-name-string */ attribute,
 						/* value? */ defaultValue){
 		// summary:
@@ -43,10 +41,10 @@ dojo.declare("dojo.data.api.Read", null, {
 		throw new Error('Unimplemented API: dojo.data.api.Read.getValue');
 	},
 
-	getValues: function(/* item */ item,
+	getValues: function(/* dojo/data/api/Item */ item,
 						/* attribute-name-string */ attribute){
 		// summary:
-		// 		This getValues() method works just like the getValue() method, but getValues()
+		//		This getValues() method works just like the getValue() method, but getValues()
 		//		always returns an array rather than a single attribute value.  The array
 		//		may be empty, may contain a single attribute value, or may contain
 		//		many attribute values.
@@ -66,7 +64,7 @@ dojo.declare("dojo.data.api.Read", null, {
 		throw new Error('Unimplemented API: dojo.data.api.Read.getValues');
 	},
 
-	getAttributes: function(/* item */ item){
+	getAttributes: function(/* dojo/data/api/Item */ item){
 		// summary:
 		//		Returns an array with all the attributes that this item has.  This
 		//		method will always return an array; if the item has no attributes
@@ -80,7 +78,7 @@ dojo.declare("dojo.data.api.Read", null, {
 		throw new Error('Unimplemented API: dojo.data.api.Read.getAttributes');
 	},
 
-	hasAttribute: function(	/* item */ item,
+	hasAttribute: function(	/* dojo/data/api/Item */ item,
 							/* attribute-name-string */ attribute){
 		// summary:
 		//		Returns true if the given *item* has a value for the given *attribute*.
@@ -95,7 +93,7 @@ dojo.declare("dojo.data.api.Read", null, {
 		throw new Error('Unimplemented API: dojo.data.api.Read.hasAttribute');
 	},
 
-	containsValue: function(/* item */ item,
+	containsValue: function(/* dojo/data/api/Item */ item,
 							/* attribute-name-string */ attribute,
 							/* anything */ value){
 		// summary:
@@ -141,7 +139,7 @@ dojo.declare("dojo.data.api.Read", null, {
 		throw new Error('Unimplemented API: dojo.data.api.Read.isItemLoaded');
 	},
 
-	loadItem: function(/* object */ keywordArgs){
+	loadItem: function(/* Object */ keywordArgs){
 		// summary:
 		//		Given an item, this method loads the item so that a subsequent call
 		//		to store.isItemLoaded(item) will return true.  If a call to
@@ -149,30 +147,35 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		then loadItem() need not do any work at all and will not even invoke
 		//		the callback handlers.  So, before invoking this method, check that
 		//		the item has not already been loaded.
-		// 	keywordArgs:
+		// keywordArgs:
 		//		An anonymous object that defines the item to load and callbacks to invoke when the
 		//		load has completed.  The format of the object is as follows:
-		//		{
-		//			item: object,
-		//			onItem: Function,
-		//			onError: Function,
-		//			scope: object
-		//		}
-		//	The *item* parameter.
+		// |	{
+		// |		item: object,
+		// |		onItem: Function,
+		// |		onError: Function,
+		// |		scope: object
+		// |	}
+		//
+		//		####The *item* parameter
+		//
 		//		The item parameter is an object that represents the item in question that should be
 		//		contained by the store.  This attribute is required.
 		//
-		//	The *onItem* parameter.
+		//		####The *onItem* parameter
+		//
 		//		Function(item)
 		//		The onItem parameter is the callback to invoke when the item has been loaded.  It takes only one
 		//		parameter, the fully loaded item.
 		//
-		//	The *onError* parameter.
+		//		####The *onError* parameter
+		//
 		//		Function(error)
 		//		The onError parameter is the callback to invoke when the item load encountered an error.  It takes only one
 		//		parameter, the error object
 		//
-		//	The *scope* parameter.
+		//		####The *scope* parameter
+		//
 		//		If a scope object is provided, all of the callback functions (onItem,
 		//		onError, etc) will be invoked in the context of the scope object.
 		//		In the body of the callback function, the value of the "this"
@@ -191,7 +194,6 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		this method executes the query and makes the results available as data items.
 		//		The format and expectations of stores is that they operate in a generally asynchronous
 		//		manner, therefore callbacks are always used to return items located by the fetch parameters.
-		//
 		// description:
 		//		A Request object will always be returned and is returned immediately.
 		//		The basic request is nothing more than the keyword args passed to fetch and
@@ -201,33 +203,33 @@ dojo.declare("dojo.data.api.Read", null, {
 		//
 		//		This does not mean that custom stores can not add methods and properties to the request object
 		//		returned, only that the API does not require it.  For more info about the Request API,
-		//		see dojo.data.api.Request
-		//
+		//		see dojo/data/api/Request
 		// keywordArgs:
 		//		The keywordArgs parameter may either be an instance of
-		//		conforming to dojo.data.api.Request or may be a simple anonymous object
+		//		conforming to dojo/data/api/Request or may be a simple anonymous object
 		//		that may contain any of the following:
-		//		{
-		//			query: query-object or query-string,
-		//			queryOptions: object,
-		//			onBegin: Function,
-		//			onItem: Function,
-		//			onComplete: Function,
-		//			onError: Function,
-		//			scope: object,
-		//			start: int
-		//			count: int
-		//			sort: array
-		//		}
+		// |	{
+		// |		query: query-object or query-string,
+		// |		queryOptions: object,
+		// |		onBegin: Function,
+		// |		onItem: Function,
+		// |		onComplete: Function,
+		// |		onError: Function,
+		// |		scope: object,
+		// |		start: int
+		// |		count: int
+		// |		sort: array
+		// |	}
 		//		All implementations should accept keywordArgs objects with any of
 		//		the 9 standard properties: query, onBegin, onItem, onComplete, onError
 		//		scope, sort, start, and count.  Some implementations may accept additional
 		//		properties in the keywordArgs object as valid parameters, such as
 		//		{includeOutliers:true}.
 		//
-		//	The *query* parameter.
+		//		####The *query* parameter
+		//
 		//		The query may be optional in some data store implementations.
-		//		The dojo.data.api.Read API does not specify the syntax or semantics
+		//		The dojo/data/api/Read API does not specify the syntax or semantics
 		//		of the query itself -- each different data store implementation
 		//		may have its own notion of what a query should look like.
 		//		However, as of dojo 0.9, 1.0, and 1.1, all the provided datastores in dojo.data
@@ -237,26 +239,29 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		when they dynamically update the query.  Therefore, for maximum compatibility with dijit
 		//		widgets the recommended query parameter is a key/value object.  That does not mean that the
 		//		the datastore may not take alternative query forms, such as a simple string, a Date, a number,
-		//		or a mix of such.  Ultimately, The dojo.data.api.Read API is agnostic about what the query
+		//		or a mix of such.  Ultimately, The dojo/data/api/Read API is agnostic about what the query
 		//		format.
+		//
 		//		Further note:  In general for query objects that accept strings as attribute
 		//		value matches, the store should also support basic filtering capability, such as *
 		//		(match any character) and ? (match single character).  An example query that is a query object
 		//		would be like: { attrFoo: "value*"}.  Which generally means match all items where they have
 		//		an attribute named attrFoo, with a value that starts with 'value'.
 		//
-		//	The *queryOptions* parameter
-		//		The queryOptions parameter is an optional parameter used to specify optiosn that may modify
+		//		####The *queryOptions* parameter
+		//
+		//		The queryOptions parameter is an optional parameter used to specify options that may modify
 		//		the query in some fashion, such as doing a case insensitive search, or doing a deep search
 		//		where all items in a hierarchical representation of data are scanned instead of just the root
 		//		items.  It currently defines two options that all datastores should attempt to honor if possible:
-		//		{
-		//			ignoreCase: boolean, //Whether or not the query should match case sensitively or not.  Default behaviour is false.
-		//			deep: boolean 	//Whether or not a fetch should do a deep search of items and all child
-		//							//items instead of just root-level items in a datastore.  Default is false.
-		//		}
+		// |	{
+		// |		ignoreCase: boolean, // Whether or not the query should match case sensitively or not.  Default behaviour is false.
+		// |		deep: boolean 	// Whether or not a fetch should do a deep search of items and all child
+		// |						// items instead of just root-level items in a datastore.  Default is false.
+		// |	}
+		//
+		//		####The *onBegin* parameter.
 		//
-		//	The *onBegin* parameter.
 		//		function(size, request);
 		//		If an onBegin callback function is provided, the callback function
 		//		will be called just once, before the first onItem callback is called.
@@ -266,14 +271,17 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		collection of items returned from the query, as the request may have specified to return only a
 		//		subset of the total set of items through the use of the start and count parameters.
 		//
-		//	The *onItem* parameter.
+		//		####The *onItem* parameter.
+		//
 		//		function(item, request);
+		//
 		//		If an onItem callback function is provided, the callback function
 		//		will be called as each item in the result is received. The callback
 		//		function will be passed two arguments: the item itself, and the
 		//		Request object.
 		//
-		//	The *onComplete* parameter.
+		//		####The *onComplete* parameter.
+		//
 		//		function(items, request);
 		//
 		//		If an onComplete callback function is provided, the callback function
@@ -283,15 +291,18 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		If the onItem callback is present, then onComplete is called as:
 		//		onComplete(null, request).
 		//
-		//	The *onError* parameter.
+		//		####The *onError* parameter.
+		//
 		//		function(errorData, request);
+		//
 		//		If an onError callback function is provided, the callback function
 		//		will be called if there is any sort of error while attempting to
 		//		execute the query.
 		//		The onError callback function will be passed two arguments:
 		//		an Error object and the Request object.
 		//
-		//	The *scope* parameter.
+		//		####The *scope* parameter.
+		//
 		//		If a scope object is provided, all of the callback functions (onItem,
 		//		onComplete, onError, etc) will be invoked in the context of the scope
 		//		object.  In the body of the callback function, the value of the "this"
@@ -300,34 +311,36 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		For example, onItem.call(scope, item, request) vs.
 		//		onItem.call(dojo.global(), item, request)
 		//
-		//	The *start* parameter.
+		//		####The *start* parameter.
+		//
 		//		If a start parameter is specified, this is a indication to the datastore to
 		//		only start returning items once the start number of items have been located and
 		//		skipped.  When this parameter is paired with 'count', the store should be able
 		//		to page across queries with millions of hits by only returning subsets of the
 		//		hits for each query
 		//
-		//	The *count* parameter.
+		//		####The *count* parameter.
+		//
 		//		If a count parameter is specified, this is a indication to the datastore to
 		//		only return up to that many items.  This allows a fetch call that may have
 		//		millions of item matches to be paired down to something reasonable.
 		//
-		//	The *sort* parameter.
+		//		####The *sort* parameter.
+		//
 		//		If a sort parameter is specified, this is a indication to the datastore to
 		//		sort the items in some manner before returning the items.  The array is an array of
 		//		javascript objects that must conform to the following format to be applied to the
 		//		fetching of items:
-		//		{
-		//			attribute: attribute || attribute-name-string,
-		//			descending: true|false;   // Optional.  Default is false.
-		//		}
+		// |	{
+		// |		attribute: attribute || attribute-name-string,
+		// |		descending: true|false;   // Optional.  Default is false.
+		// |	}
 		//		Note that when comparing attributes, if an item contains no value for the attribute
 		//		(undefined), then it the default ascending sort logic should push it to the bottom
 		//		of the list.  In the descending order case, it such items should appear at the top of the list.
-		//
 		// returns:
 		//		The fetch() method will return a javascript object conforming to the API
-		//		defined in dojo.data.api.Request.  In general, it will be the keywordArgs
+		//		defined in dojo/data/api/Request.  In general, it will be the keywordArgs
 		//		object returned with the required functions in Request.js attached.
 		//		Its general purpose is to provide a convenient way for a caller to abort an
 		//		ongoing fetch.
@@ -335,11 +348,9 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		The Request object may also have additional properties when it is returned
 		//		such as request.store property, which is a pointer to the datastore object that
 		//		fetch() is a method of.
-		//
 		// exceptions:
 		//		Throws an exception if the query is not valid, or if the query
 		//		is required but was not supplied.
-		//
 		// example:
 		//		Fetch all books identified by the query and call 'showBooks' when complete
 		//		|	var request = store.fetch({query:"all books", onComplete: showBooks});
@@ -370,7 +381,7 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		|	var request = store.fetch({query:{author:"King"}, queryOptions:(ignoreCase: true}, start: 0, count:100, onComplete: showKing});
 		// example:
 		//		Paging
-		//		|	var store = new dojo.data.LargeRdbmsStore({url:"jdbc:odbc:foobar"});
+		//		|	var store = new LargeRdbmsStore({url:"jdbc:odbc:foobar"});
 		//		|	var fetchArgs = {
 		//		|		query: {type:"employees", name:"Hillary *"}, // string matching
 		//		|		sort: [{attribute:"department", descending:true}],
@@ -395,37 +406,34 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		The getFeatures() method returns an simple keyword values object
 		//		that specifies what interface features the datastore implements.
 		//		A simple CsvStore may be read-only, and the only feature it
-		//		implements will be the 'dojo.data.api.Read' interface, so the
+		//		implements will be the 'dojo/data/api/Read' interface, so the
 		//		getFeatures() method will return an object like this one:
 		//		{'dojo.data.api.Read': true}.
 		//		A more sophisticated datastore might implement a variety of
-		//		interface features, like 'dojo.data.api.Read', 'dojo.data.api.Write',
-		//		'dojo.data.api.Identity', and 'dojo.data.api.Attribution'.
+		//		interface features, like 'dojo.data.api.Read', 'dojo/data/api/Write',
+		//		'dojo.data.api.Identity', and 'dojo/data/api/Attribution'.
 		return {
 			'dojo.data.api.Read': true
 		};
 	},
 
-	close: function(/*dojo.data.api.Request || keywordArgs || null */ request){
+	close: function(/*dojo/data/api/Request|Object?*/ request){
 		// summary:
 		//		The close() method is intended for instructing the store to 'close' out
 		//		any information associated with a particular request.
-		//
 		// description:
 		//		The close() method is intended for instructing the store to 'close' out
 		//		any information associated with a particular request.  In general, this API
-		//		expects to recieve as a parameter a request object returned from a fetch.
+		//		expects to receive as a parameter a request object returned from a fetch.
 		//		It will then close out anything associated with that request, such as
 		//		clearing any internal datastore caches and closing any 'open' connections.
 		//		For some store implementations, this call may be a no-op.
-		//
 		// request:
 		//		An instance of a request for the store to use to identify what to close out.
 		//		If no request is passed, then the store should clear all internal caches (if any)
 		//		and close out all 'open' connections.  It does not render the store unusable from
 		//		there on, it merely cleans out any current data and resets the store to initial
 		//		state.
-		//
 		// example:
 		//	|	var request = store.fetch({onComplete: doSomething});
 		//	|	...
@@ -433,11 +441,10 @@ dojo.declare("dojo.data.api.Read", null, {
 		throw new Error('Unimplemented API: dojo.data.api.Read.close');
 	},
 
-	getLabel: function(/* item */ item){
+	getLabel: function(/* dojo/data/api/Item */ item){
 		// summary:
 		//		Method to inspect the item and return a user-readable 'label' for the item
 		//		that provides a general/adequate description of what the item is.
-		//
 		// description:
 		//		Method to inspect the item and return a user-readable 'label' for the item
 		//		that provides a general/adequate description of what the item is.  In general
@@ -449,31 +456,26 @@ dojo.declare("dojo.data.api.Read", null, {
 		//		to customize how a store instance labels items should replace the getLabel() function on
 		//		their instance of the store, or extend the store and replace the function in
 		//		the extension class.
-		//
 		// item:
 		//		The item to return the label for.
-		//
 		// returns:
 		//		A user-readable string representing the item or undefined if no user-readable label can
 		//		be generated.
 		throw new Error('Unimplemented API: dojo.data.api.Read.getLabel');
 	},
 
-	getLabelAttributes: function(/* item */ item){
+	getLabelAttributes: function(/* dojo/data/api/Item */ item){
 		// summary:
 		//		Method to inspect the item and return an array of what attributes of the item were used
 		//		to generate its label, if any.
-		//
 		// description:
 		//		Method to inspect the item and return an array of what attributes of the item were used
 		//		to generate its label, if any.  This function is to assist UI developers in knowing what
 		//		attributes can be ignored out of the attributes an item has when displaying it, in cases
 		//		where the UI is using the label as an overall identifer should they wish to hide
 		//		redundant information.
-		//
 		// item:
 		//		The item to return the list of label attributes for.
-		//
 		// returns:
 		//		An array of attribute names that were used to generate the label, or null if public attributes
 		//		were not used to generate the label.
@@ -481,5 +483,4 @@ dojo.declare("dojo.data.api.Read", null, {
 	}
 });
 
-return dojo.data.api.Read;
 });