dojo-rails 0.9.9 → 0.9.10

data/vendor/assets/javascripts/dojo/dojo.profile.js

@@ -15,7 +15,11 @@ var profile = (function(){
 				"dojo/tests/_base/loader/requirejs/relative/relative-tests":1,
 				"dojo/tests/_base/loader/requirejs/exports/exports-tests":1
 			};
-			return (mid in list) || /^dojo\/_base\/config\w+$/.test(mid) || (/^dojo\/resources\//.test(mid) && !/\.css$/.test(filename)) || /(png|jpg|jpeg|gif|tiff)$/.test(filename);
+			return (mid in list) ||
+				/^dojo\/_base\/config\w+$/.test(mid) ||
+				(/^dojo\/resources\//.test(mid) && !/\.css$/.test(filename)) ||
+				/(png|jpg|jpeg|gif|tiff)$/.test(filename) ||
+				/built\-i18n\-test\/152\-build/.test(mid);
 		};
 
 	return {
@@ -31,10 +35,6 @@ var profile = (function(){
 			amd: function(filename, mid){
 				return !testResourceRe.test(mid) && !copyOnly(filename, mid) && /\.js$/.test(filename);
 			}
-		},
-
-		trees:[
-			[".", ".", /(\/\.)|(~$)/]
-		]
+		}
 	};
 })();

data/vendor/assets/javascripts/dojo/dom-attr.js

@@ -5,7 +5,7 @@
 */
 
 //>>built
-define("dojo/dom-attr",["exports","./_base/sniff","./_base/lang","./dom","./dom-style","./dom-prop"],function(_1,_2,_3,_4,_5,_6){
+define("dojo/dom-attr",["exports","./sniff","./_base/lang","./dom","./dom-style","./dom-prop"],function(_1,_2,_3,_4,_5,_6){
 var _7={innerHTML:1,className:1,htmlFor:_2("ie"),value:1},_8={classname:"class",htmlfor:"for",tabindex:"tabIndex",readonly:"readOnly"};
 function _9(_a,_b){
 var _c=_a.getAttributeNode&&_a.getAttributeNode(_b);
@@ -17,46 +17,45 @@ return _7[_6.names[lc]||_e]||_9(_4.byId(_d),_8[lc]||_e);
 };
 _1.get=function getAttr(_f,_10){
 _f=_4.byId(_f);
-var lc=_10.toLowerCase(),_11=_6.names[lc]||_10,_12=_7[_11];
-value=_f[_11];
-if(_12&&typeof value!="undefined"){
-return value;
+var lc=_10.toLowerCase(),_11=_6.names[lc]||_10,_12=_7[_11],_13=_f[_11];
+if(_12&&typeof _13!="undefined"){
+return _13;
 }
-if(_11!="href"&&(typeof value=="boolean"||_3.isFunction(value))){
-return value;
+if(_11!="href"&&(typeof _13=="boolean"||_3.isFunction(_13))){
+return _13;
 }
-var _13=_8[lc]||_10;
-return _9(_f,_13)?_f.getAttribute(_13):null;
+var _14=_8[lc]||_10;
+return _9(_f,_14)?_f.getAttribute(_14):null;
 };
-_1.set=function setAttr(_14,_15,_16){
-_14=_4.byId(_14);
+_1.set=function setAttr(_15,_16,_17){
+_15=_4.byId(_15);
 if(arguments.length==2){
-for(var x in _15){
-_1.set(_14,x,_15[x]);
+for(var x in _16){
+_1.set(_15,x,_16[x]);
 }
-return _14;
+return _15;
 }
-var lc=_15.toLowerCase(),_17=_6.names[lc]||_15,_18=_7[_17];
-if(_17=="style"&&typeof _16!="string"){
-_5.set(_14,_16);
-return _14;
+var lc=_16.toLowerCase(),_18=_6.names[lc]||_16,_19=_7[_18];
+if(_18=="style"&&typeof _17!="string"){
+_5.set(_15,_17);
+return _15;
 }
-if(_18||typeof _16=="boolean"||_3.isFunction(_16)){
-return _6.set(_14,_15,_16);
+if(_19||typeof _17=="boolean"||_3.isFunction(_17)){
+return _6.set(_15,_16,_17);
 }
-_14.setAttribute(_8[lc]||_15,_16);
-return _14;
+_15.setAttribute(_8[lc]||_16,_17);
+return _15;
 };
-_1.remove=function removeAttr(_19,_1a){
-_4.byId(_19).removeAttribute(_8[_1a.toLowerCase()]||_1a);
+_1.remove=function removeAttr(_1a,_1b){
+_4.byId(_1a).removeAttribute(_8[_1b.toLowerCase()]||_1b);
 };
-_1.getNodeProp=function getNodeProp(_1b,_1c){
-_1b=_4.byId(_1b);
-var lc=_1c.toLowerCase(),_1d=_6.names[lc]||_1c;
-if((_1d in _1b)&&_1d!="href"){
-return _1b[_1d];
+_1.getNodeProp=function getNodeProp(_1c,_1d){
+_1c=_4.byId(_1c);
+var lc=_1d.toLowerCase(),_1e=_6.names[lc]||_1d;
+if((_1e in _1c)&&_1e!="href"){
+return _1c[_1e];
 }
-var _1e=_8[lc]||_1c;
-return _9(_1b,_1e)?_1b.getAttribute(_1e):null;
+var _1f=_8[lc]||_1d;
+return _9(_1c,_1f)?_1c.getAttribute(_1f):null;
 };
 });

data/vendor/assets/javascripts/dojo/dom-attr.js.uncompressed.js

@@ -1,22 +1,48 @@
-define("dojo/dom-attr", ["exports", "./_base/sniff", "./_base/lang", "./dom", "./dom-style", "./dom-prop"],
+define("dojo/dom-attr", ["exports", "./sniff", "./_base/lang", "./dom", "./dom-style", "./dom-prop"],
 		function(exports, has, lang, dom, style, prop){
 	// module:
 	//		dojo/dom-attr
 	// summary:
 	//		This module defines the core dojo DOM attributes API.
 
+	// TODOC: summary not showing up in output see https://github.com/csnover/js-doc-parse/issues/42
+
 	// =============================
 	// Element attribute Functions
 	// =============================
 
-	// This module will be obsolete soon. Use dojo.prop instead.
+	// This module will be obsolete soon. Use dojo/prop instead.
 
 	// dojo.attr() should conform to http://www.w3.org/TR/DOM-Level-2-Core/
 
 	// attribute-related functions (to be obsolete soon)
 
-	/*=====
-	dojo.hasAttr = function(node, name){
+	var forcePropNames = {
+			innerHTML:	1,
+			className:	1,
+			htmlFor:	has("ie"),
+			value:		1
+		},
+		attrNames = {
+			// original attribute names
+			classname: "class",
+			htmlfor: "for",
+			// for IE
+			tabindex: "tabIndex",
+			readonly: "readOnly"
+		};
+
+	function _hasAttr(node, name){
+		var attr = node.getAttributeNode && node.getAttributeNode(name);
+		return attr && attr.specified; // Boolean
+	}
+
+	// There is a difference in the presence of certain properties and their default values
+	// between browsers. For example, on IE "disabled" is present on all elements,
+	// but it is value is "false"; "tabIndex" of <div> returns 0 by default on IE, yet other browsers
+	// can return -1.
+
+	exports.has = function hasAttr(/*DOMNode|String*/ node, /*String*/ name){
 		// summary:
 		//		Returns true if the requested attribute is specified on the
 		//		given element, and false otherwise.
@@ -27,11 +53,12 @@ define("dojo/dom-attr", ["exports", "./_base/sniff", "./_base/lang", "./dom", ".
 		// returns: Boolean
 		//		true if the requested attribute is specified on the
 		//		given element, and false otherwise
+
+		var lc = name.toLowerCase();
+		return forcePropNames[prop.names[lc] || name] || _hasAttr(dom.byId(node), attrNames[lc] || name);	// Boolean
 	};
-	=====*/
 
-	/*=====
-	dojo.getAttr = function(node, name){
+	exports.get = function getAttr(/*DOMNode|String*/ node, /*String*/ name){
 		// summary:
 		//		Gets an attribute on an HTML element.
 		// description:
@@ -49,11 +76,28 @@ define("dojo/dom-attr", ["exports", "./_base/sniff", "./_base/lang", "./dom", ".
 		//	|	dojo.getAttr(dojo.byId("nodeId"), "foo");
 		//	|	// or we can just pass the id:
 		//	|	dojo.getAttr("nodeId", "foo");
+
+		node = dom.byId(node);
+		var lc = name.toLowerCase(),
+			propName = prop.names[lc] || name,
+			forceProp = forcePropNames[propName],
+			value = node[propName];		// should we access this attribute via a property or via getAttribute()?
+
+		if(forceProp && typeof value != "undefined"){
+			// node's property
+			return value;	// Anything
+		}
+		if(propName != "href" && (typeof value == "boolean" || lang.isFunction(value))){
+			// node's property
+			return value;	// Anything
+		}
+		// node's attribute
+		// we need _hasAttr() here to guard against IE returning a default value
+		var attrName = attrNames[lc] || name;
+		return _hasAttr(node, attrName) ? node.getAttribute(attrName) : null; // Anything
 	};
-	=====*/
 
-	/*=====
-	dojo.setAttr = function(node, name, value){
+	exports.set = function setAttr(/*DOMNode|String*/ node, /*String|Object*/ name, /*String?*/ value){
 		// summary:
 		//		Sets an attribute on an HTML element.
 		// description:
@@ -117,85 +161,7 @@ define("dojo/dom-attr", ["exports", "./_base/sniff", "./_base/lang", "./dom", ".
 		//	|
 		//	|	// though shorter to use `dojo.style()` in this case:
 		//	|	dojo.setStyle("someNode", obj);
-	};
-	=====*/
-
-	/*=====
-	dojo.removeAttr = function(node, name){
-		// summary:
-		//		Removes an attribute from an HTML element.
-		// node: DOMNode|String
-		//		id or reference to the element to remove the attribute from
-		// name: String
-		//		the name of the attribute to remove
-	};
-	=====*/
-
-	/*=====
-	dojo.getNodeProp = function(node, name){
-		// summary:
-		//		Returns an effective value of a property or an attribute.
-		// node: DOMNode|String
-		//		id or reference to the element to remove the attribute from
-		// name: String
-		//		the name of the attribute
-		// returns:
-		//      the value of the attribute
-	};
-	=====*/
-
-	var forcePropNames = {
-			innerHTML:	1,
-			className:	1,
-			htmlFor:	has("ie"),
-			value:		1
-		},
-		attrNames = {
-			// original attribute names
-			classname: "class",
-			htmlfor: "for",
-			// for IE
-			tabindex: "tabIndex",
-			readonly: "readOnly"
-		};
 
-	function _hasAttr(node, name){
-		var attr = node.getAttributeNode && node.getAttributeNode(name);
-		return attr && attr.specified; // Boolean
-	}
-
-	// There is a difference in the presence of certain properties and their default values
-	// between browsers. For example, on IE "disabled" is present on all elements,
-	// but it is value is "false"; "tabIndex" of <div> returns 0 by default on IE, yet other browsers
-	// can return -1.
-
-	exports.has = function hasAttr(/*DOMNode|String*/node, /*String*/name){
-		var lc = name.toLowerCase();
-		return forcePropNames[prop.names[lc] || name] || _hasAttr(dom.byId(node), attrNames[lc] || name);	// Boolean
-	};
-
-	exports.get = function getAttr(/*DOMNode|String*/node, /*String*/name){
-		node = dom.byId(node);
-		var lc = name.toLowerCase(),
-			propName = prop.names[lc] || name,
-			forceProp = forcePropNames[propName];
-		// should we access this attribute via a property or via getAttribute()?
-		value = node[propName];
-		if(forceProp && typeof value != "undefined"){
-			// node's property
-			return value;	// Anything
-		}
-		if(propName != "href" && (typeof value == "boolean" || lang.isFunction(value))){
-			// node's property
-			return value;	// Anything
-		}
-		// node's attribute
-		// we need _hasAttr() here to guard against IE returning a default value
-		var attrName = attrNames[lc] || name;
-		return _hasAttr(node, attrName) ? node.getAttribute(attrName) : null; // Anything
-	};
-
-	exports.set = function setAttr(/*DOMNode|String*/node, /*String|Object*/name, /*String?*/value){
 		node = dom.byId(node);
 		if(arguments.length == 2){ // inline'd type check
 			// the object form of setter: the 2nd argument is a dictionary
@@ -213,7 +179,7 @@ define("dojo/dom-attr", ["exports", "./_base/sniff", "./_base/lang", "./dom", ".
 			return node; // DomNode
 		}
 		if(forceProp || typeof value == "boolean" || lang.isFunction(value)){
-			return prop.set(node, name, value)
+			return prop.set(node, name, value);
 		}
 		// node's attribute
 		node.setAttribute(attrNames[lc] || name, value);
@@ -221,10 +187,26 @@ define("dojo/dom-attr", ["exports", "./_base/sniff", "./_base/lang", "./dom", ".
 	};
 
 	exports.remove = function removeAttr(/*DOMNode|String*/ node, /*String*/ name){
+		// summary:
+		//		Removes an attribute from an HTML element.
+		// node: DOMNode|String
+		//		id or reference to the element to remove the attribute from
+		// name: String
+		//		the name of the attribute to remove
+
 		dom.byId(node).removeAttribute(attrNames[name.toLowerCase()] || name);
 	};
 
 	exports.getNodeProp = function getNodeProp(/*DomNode|String*/ node, /*String*/ name){
+		// summary:
+		//		Returns an effective value of a property or an attribute.
+		// node: DOMNode|String
+		//		id or reference to the element to remove the attribute from
+		// name: String
+		//		the name of the attribute
+		// returns:
+		//		the value of the attribute
+
 		node = dom.byId(node);
 		var lc = name.toLowerCase(), propName = prop.names[lc] || name;
 		if((propName in node) && propName != "href"){

data/vendor/assets/javascripts/dojo/dom-class.js.uncompressed.js

@@ -1,8 +1,6 @@
 define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(lang, array, dom){
 	// module:
 	//		dojo/dom-class
-	// summary:
-	//		This module defines the core dojo DOM class API.
 
 	var className = "className";
 
@@ -17,154 +15,6 @@ define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(la
 	// (CSS) Class Functions
 	// =============================
 
-	/*=====
-	dojo.hasClass = function(node, classStr){
-		// summary:
-		//		Returns whether or not the specified classes are a portion of the
-		//		class list currently applied to the node.
-		//
-		// node: String|DOMNode
-		//		String ID or DomNode reference to check the class for.
-		//
-		// classStr: String
-		//		A string class name to look for.
-		//
-		// returns: Boolean
-		//
-		// example:
-		//		Do something if a node with id="someNode" has class="aSillyClassName" present
-		//	|	if(dojo.hasClass("someNode","aSillyClassName")){ ... }
-	};
-	=====*/
-
-	/*=====
-	dojo.addClass = function(node, classStr){
-		// summary:
-		//		Adds the specified classes to the end of the class list on the
-		//		passed node. Will not re-apply duplicate classes.
-		//
-		// node: String|DOMNode
-		//		String ID or DomNode reference to add a class string too
-		//
-		// classStr: String|Array
-		//		A String class name to add, or several space-separated class names,
-		//		or an array of class names.
-		//
-		// example:
-		//		Add a class to some node:
-		//	|	dojo.addClass("someNode", "anewClass");
-		//
-		// example:
-		//		Add two classes at once:
-		//	|	dojo.addClass("someNode", "firstClass secondClass");
-		//
-		// example:
-		//		Add two classes at once (using array):
-		//	|	dojo.addClass("someNode", ["firstClass", "secondClass"]);
-		//
-		// example:
-		//		Available in `dojo.NodeList` for multiple additions
-		//	|	dojo.query("ul > li").addClass("firstLevel");
-	};
-	=====*/
-
-	/*=====
-	dojo.removeClass = function(node, classStr){
-		// summary:
-		//		Removes the specified classes from node. No `dojo.hasClass`
-		//		check is required.
-		//
-		// node: String|DOMNode
-		//		String ID or DomNode reference to remove the class from.
-		//
-		// classStr: String|Array
-		//		An optional String class name to remove, or several space-separated
-		//		class names, or an array of class names. If omitted, all class names
-		//		will be deleted.
-		//
-		// example:
-		//		Remove a class from some node:
-		//	|	dojo.removeClass("someNode", "firstClass");
-		//
-		// example:
-		//		Remove two classes from some node:
-		//	|	dojo.removeClass("someNode", "firstClass secondClass");
-		//
-		// example:
-		//		Remove two classes from some node (using array):
-		//	|	dojo.removeClass("someNode", ["firstClass", "secondClass"]);
-		//
-		// example:
-		//		Remove all classes from some node:
-		//	|	dojo.removeClass("someNode");
-		//
-		// example:
-		//		Available in `dojo.NodeList()` for multiple removal
-		//	|	dojo.query(".foo").removeClass("foo");
-	};
-	=====*/
-
-	/*=====
-	dojo.replaceClass = function(node, addClassStr, removeClassStr){
-		// summary:
-		//		Replaces one or more classes on a node if not present.
-		//		Operates more quickly than calling dojo.removeClass and dojo.addClass
-		//
-		// node: String|DOMNode
-		//		String ID or DomNode reference to remove the class from.
-		//
-		// addClassStr: String|Array
-		//		A String class name to add, or several space-separated class names,
-		//		or an array of class names.
-		//
-		// removeClassStr: String|Array?
-		//		A String class name to remove, or several space-separated class names,
-		//		or an array of class names.
-		//
-		// example:
-		//	|	dojo.replaceClass("someNode", "add1 add2", "remove1 remove2");
-		//
-		// example:
-		//	Replace all classes with addMe
-		//	|	dojo.replaceClass("someNode", "addMe");
-		//
-		// example:
-		//	Available in `dojo.NodeList()` for multiple toggles
-		//	|	dojo.query(".findMe").replaceClass("addMe", "removeMe");
-	};
-	=====*/
-
-	/*=====
-	dojo.toggleClass = function(node, classStr, condition){
-		// summary:
-		//		Adds a class to node if not present, or removes if present.
-		//		Pass a boolean condition if you want to explicitly add or remove.
-		//      Returns the condition that was specified directly or indirectly.
-		//
-		// node: String|DOMNode
-		//		String ID or DomNode reference to toggle a class string
-		//
-		// classStr: String|Array
-		//		A String class name to toggle, or several space-separated class names,
-		//		or an array of class names.
-		//
-		// condition:
-		//		If passed, true means to add the class, false means to remove.
-		//      Otherwise dojo.hasClass(node, classStr) is used to detect the class presence.
-		//
-		// example:
-		//	|	dojo.toggleClass("someNode", "hovered");
-		//
-		// example:
-		//		Forcefully add a class
-		//	|	dojo.toggleClass("someNode", "hovered", true);
-		//
-		// example:
-		//		Available in `dojo.NodeList()` for multiple toggles
-		//	|	dojo.query(".toggleMe").toggleClass("toggleMe");
-	};
-	=====*/
-
 	var cls, // exports object
 		spaces = /\s+/, a1 = [""];
 
@@ -254,11 +104,60 @@ define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(la
 	// regular DOM version
 	var fakeNode = {};  // for effective replacement
 	cls = {
-		contains: function containsClass(/*DomNode|String*/node, /*String*/classStr){
+		// summary:
+		//		This module defines the core dojo DOM class API.
+
+		contains: function containsClass(/*DomNode|String*/ node, /*String*/ classStr){
+			// summary:
+			//		Returns whether or not the specified classes are a portion of the
+			//		class list currently applied to the node.
+			// node: String|DOMNode
+			//		String ID or DomNode reference to check the class for.
+			// classStr: String
+			//		A string class name to look for.
+			// example:
+			//		Do something if a node with id="someNode" has class="aSillyClassName" present
+			//	|	if(dojo.hasClass("someNode","aSillyClassName")){ ... }
+
 			return ((" " + dom.byId(node)[className] + " ").indexOf(" " + classStr + " ") >= 0); // Boolean
 		},
 
-		add: function addClass(/*DomNode|String*/node, /*String|Array*/classStr){
+		add: function addClass(/*DomNode|String*/ node, /*String|Array*/ classStr){
+			// summary:
+			//		Adds the specified classes to the end of the class list on the
+			//		passed node. Will not re-apply duplicate classes.
+			//
+			// node: String|DOMNode
+			//		String ID or DomNode reference to add a class string too
+			//
+			// classStr: String|Array
+			//		A String class name to add, or several space-separated class names,
+			//		or an array of class names.
+			//
+			// example:
+			//		Add a class to some node:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.add("someNode", "anewClass");
+			//	|	});
+			//
+			// example:
+			//		Add two classes at once:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.add("someNode", "firstClass secondClass");
+			//	|	});
+			//
+			// example:
+			//		Add two classes at once (using array):
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.add("someNode", ["firstClass", "secondClass"]);
+			//	|	});
+			//
+			// example:
+			//		Available in `dojo/NodeList` for multiple additions
+			//	|	require(["dojo/query"], function(query){
+			//	|		query("ul > li").addClass("firstLevel");
+			//	|	});
+
 			node = dom.byId(node);
 			classStr = str2array(classStr);
 			var cls = node[className], oldLen;
@@ -275,7 +174,49 @@ define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(la
 			}
 		},
 
-		remove: function removeClass(/*DomNode|String*/node, /*String|Array?*/classStr){
+		remove: function removeClass(/*DomNode|String*/ node, /*String|Array?*/ classStr){
+			// summary:
+			//		Removes the specified classes from node. No `contains()`
+			//		check is required.
+			//
+			// node: String|DOMNode
+			//		String ID or DomNode reference to remove the class from.
+			//
+			// classStr: String|Array
+			//		An optional String class name to remove, or several space-separated
+			//		class names, or an array of class names. If omitted, all class names
+			//		will be deleted.
+			//
+			// example:
+			//		Remove a class from some node:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.remove("someNode", "firstClass");
+			//	|	});
+			//
+			// example:
+			//		Remove two classes from some node:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.remove("someNode", "firstClass secondClass");
+			//	|	});
+			//
+			// example:
+			//		Remove two classes from some node (using array):
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.remove("someNode", ["firstClass", "secondClass"]);
+			//	|	});
+			//
+			// example:
+			//		Remove all classes from some node:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.remove("someNode");
+			//	|	});
+			//
+			// example:
+			//		Available in `dojo/NodeList` for multiple removal
+			//	|	require(["dojo/query"], function(query){
+			//	|		query("ul > li").removeClass("foo");
+			//	|	});
+
 			node = dom.byId(node);
 			var cls;
 			if(classStr !== undefined){
@@ -291,7 +232,39 @@ define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(la
 			if(node[className] != cls){ node[className] = cls; }
 		},
 
-		replace: function replaceClass(/*DomNode|String*/node, /*String|Array*/addClassStr, /*String|Array?*/removeClassStr){
+		replace: function replaceClass(/*DomNode|String*/ node, /*String|Array*/ addClassStr, /*String|Array?*/ removeClassStr){
+			// summary:
+			//		Replaces one or more classes on a node if not present.
+			//		Operates more quickly than calling dojo.removeClass and dojo.addClass
+			//
+			// node: String|DOMNode
+			//		String ID or DomNode reference to remove the class from.
+			//
+			// addClassStr: String|Array
+			//		A String class name to add, or several space-separated class names,
+			//		or an array of class names.
+			//
+			// removeClassStr: String|Array?
+			//		A String class name to remove, or several space-separated class names,
+			//		or an array of class names.
+			//
+			// example:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.replace("someNode", "add1 add2", "remove1 remove2");
+			//	|	});
+			//
+			// example:
+			//	Replace all classes with addMe
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.replace("someNode", "addMe");
+			//	|	});
+			//
+			// example:
+			//	Available in `dojo/NodeList` for multiple toggles
+			//	|	require(["dojo/query"], function(query){
+			//	|		query(".findMe").replaceClass("addMe", "removeMe");
+			//	|	});
+
 			node = dom.byId(node);
 			fakeNode[className] = node[className];
 			cls.remove(fakeNode, removeClassStr);
@@ -301,7 +274,40 @@ define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(la
 			}
 		},
 
-		toggle: function toggleClass(/*DomNode|String*/node, /*String|Array*/classStr, /*Boolean?*/condition){
+		toggle: function toggleClass(/*DomNode|String*/ node, /*String|Array*/ classStr, /*Boolean?*/ condition){
+			// summary:
+			//		Adds a class to node if not present, or removes if present.
+			//		Pass a boolean condition if you want to explicitly add or remove.
+			//		Returns the condition that was specified directly or indirectly.
+			//
+			// node: String|DOMNode
+			//		String ID or DomNode reference to toggle a class string
+			//
+			// classStr: String|Array
+			//		A String class name to toggle, or several space-separated class names,
+			//		or an array of class names.
+			//
+			// condition:
+			//		If passed, true means to add the class, false means to remove.
+			//		Otherwise dojo.hasClass(node, classStr) is used to detect the class presence.
+			//
+			// example:
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.toggle("someNode", "hovered");
+			//	|	});
+			//
+			// example:
+			//		Forcefully add a class
+			//	|	require(["dojo/dom-class"], function(domClass){
+			//	|		domClass.toggle("someNode", "hovered", true);
+			//	|	});
+			//
+			// example:
+			//		Available in `dojo/NodeList` for multiple toggles
+			//	|	require(["dojo/query"], function(query){
+			//	|		query(".toggleMe").toggleClass("toggleMe");
+			//	|	});
+
 			node = dom.byId(node);
 			if(condition === undefined){
 				classStr = str2array(classStr);