dojo-rails 0.9.9 → 0.9.10

data/vendor/assets/javascripts/dojo/_base/lang.js

@@ -5,7 +5,7 @@
 */
 
 //>>built
-define("dojo/_base/lang",["./kernel","../has","./sniff"],function(_1,_2){
+define("dojo/_base/lang",["./kernel","../has","../sniff"],function(_1,_2){
 _2.add("bug-for-in-skips-shadowed",function(){
 for(var i in {toString:1}){
 return 0;
@@ -13,134 +13,135 @@ return 0;
 return 1;
 });
 var _3=_2("bug-for-in-skips-shadowed")?"hasOwnProperty.valueOf.isPrototypeOf.propertyIsEnumerable.toLocaleString.toString.constructor".split("."):[],_4=_3.length,_5=function(_6,_7,_8){
-var _9,s,i,_a={};
-for(_9 in _7){
-s=_7[_9];
-if(!(_9 in _6)||(_6[_9]!==s&&(!(_9 in _a)||_a[_9]!==s))){
-_6[_9]=_8?_8(s):s;
+var p,i=0,_9=_1.global;
+if(!_8){
+if(!_6.length){
+return _9;
+}else{
+p=_6[i++];
+try{
+_8=_1.scopeMap[p]&&_1.scopeMap[p][1];
 }
+catch(e){
 }
-if(_2("bug-for-in-skips-shadowed")){
-if(_7){
-for(i=0;i<_4;++i){
-_9=_3[i];
-s=_7[_9];
-if(!(_9 in _6)||(_6[_9]!==s&&(!(_9 in _a)||_a[_9]!==s))){
-_6[_9]=_8?_8(s):s;
+_8=_8||(p in _9?_9[p]:(_7?_9[p]={}:undefined));
 }
 }
+while(_8&&(p=_6[i++])){
+_8=(p in _8?_8[p]:(_7?_8[p]={}:undefined));
 }
+return _8;
+},_a=Object.prototype.toString,_b=function(_c,_d,_e){
+return (_e||[]).concat(Array.prototype.slice.call(_c,_d||0));
+},_f=/\{([^\}]+)\}/g;
+var _10={_extraNames:_3,_mixin:function(_11,_12,_13){
+var _14,s,i,_15={};
+for(_14 in _12){
+s=_12[_14];
+if(!(_14 in _11)||(_11[_14]!==s&&(!(_14 in _15)||_15[_14]!==s))){
+_11[_14]=_13?_13(s):s;
 }
-return _6;
-},_b=function(_c,_d){
-if(!_c){
-_c={};
 }
-for(var i=1,l=arguments.length;i<l;i++){
-_e._mixin(_c,arguments[i]);
-}
-return _c;
-},_f=function(_10,_11,_12){
-var p,i=0,_13=_1.global;
-if(!_12){
-if(!_10.length){
-return _13;
-}else{
-p=_10[i++];
-try{
-_12=_1.scopeMap[p]&&_1.scopeMap[p][1];
+if(_2("bug-for-in-skips-shadowed")){
+if(_12){
+for(i=0;i<_4;++i){
+_14=_3[i];
+s=_12[_14];
+if(!(_14 in _11)||(_11[_14]!==s&&(!(_14 in _15)||_15[_14]!==s))){
+_11[_14]=_13?_13(s):s;
 }
-catch(e){
 }
-_12=_12||(p in _13?_13[p]:(_11?_13[p]={}:undefined));
 }
 }
-while(_12&&(p=_10[i++])){
-_12=(p in _12?_12[p]:(_11?_12[p]={}:undefined));
+return _11;
+},mixin:function(_16,_17){
+if(!_16){
+_16={};
 }
-return _12;
-},_14=function(_15,_16,_17){
-var _18=_15.split("."),p=_18.pop(),obj=_f(_18,true,_17);
-return obj&&p?(obj[p]=_16):undefined;
-},_19=function(_1a,_1b,_1c){
-return _f(_1a.split("."),_1b,_1c);
-},_1d=function(_1e,obj){
-return _e.getObject(_1e,false,obj)!==undefined;
-},_1f=Object.prototype.toString,_20=function(it){
+for(var i=1,l=arguments.length;i<l;i++){
+_10._mixin(_16,arguments[i]);
+}
+return _16;
+},setObject:function(_18,_19,_1a){
+var _1b=_18.split("."),p=_1b.pop(),obj=_5(_1b,true,_1a);
+return obj&&p?(obj[p]=_19):undefined;
+},getObject:function(_1c,_1d,_1e){
+return _5(_1c.split("."),_1d,_1e);
+},exists:function(_1f,obj){
+return _10.getObject(_1f,false,obj)!==undefined;
+},isString:function(it){
 return (typeof it=="string"||it instanceof String);
-},_21=function(it){
+},isArray:function(it){
 return it&&(it instanceof Array||typeof it=="array");
-},_22=function(it){
-return _1f.call(it)==="[object Function]";
-},_23=function(it){
-return it!==undefined&&(it===null||typeof it=="object"||_e.isArray(it)||_e.isFunction(it));
-},_24=function(it){
-return it&&it!==undefined&&!_e.isString(it)&&!_e.isFunction(it)&&!(it.tagName&&it.tagName.toLowerCase()=="form")&&(_e.isArray(it)||isFinite(it.length));
-},_25=function(it){
-return it&&!_e.isFunction(it)&&/\{\s*\[native code\]\s*\}/.test(String(it));
-},_26=function(_27,_28){
+},isFunction:function(it){
+return _a.call(it)==="[object Function]";
+},isObject:function(it){
+return it!==undefined&&(it===null||typeof it=="object"||_10.isArray(it)||_10.isFunction(it));
+},isArrayLike:function(it){
+return it&&it!==undefined&&!_10.isString(it)&&!_10.isFunction(it)&&!(it.tagName&&it.tagName.toLowerCase()=="form")&&(_10.isArray(it)||isFinite(it.length));
+},isAlien:function(it){
+return it&&!_10.isFunction(it)&&/\{\s*\[native code\]\s*\}/.test(String(it));
+},extend:function(_20,_21){
 for(var i=1,l=arguments.length;i<l;i++){
-_e._mixin(_27.prototype,arguments[i]);
+_10._mixin(_20.prototype,arguments[i]);
 }
-return _27;
-},_29=function(_2a,_2b){
-var pre=_2c(arguments,2);
-var _2d=_e.isString(_2b);
+return _20;
+},_hitchArgs:function(_22,_23){
+var pre=_10._toArray(arguments,2);
+var _24=_10.isString(_23);
 return function(){
-var _2e=_2c(arguments);
-var f=_2d?(_2a||_1.global)[_2b]:_2b;
-return f&&f.apply(_2a||this,pre.concat(_2e));
+var _25=_10._toArray(arguments);
+var f=_24?(_22||_1.global)[_23]:_23;
+return f&&f.apply(_22||this,pre.concat(_25));
 };
-},_2f=function(_30,_31){
+},hitch:function(_26,_27){
 if(arguments.length>2){
-return _e._hitchArgs.apply(_1,arguments);
+return _10._hitchArgs.apply(_1,arguments);
 }
-if(!_31){
-_31=_30;
-_30=null;
+if(!_27){
+_27=_26;
+_26=null;
 }
-if(_e.isString(_31)){
-_30=_30||_1.global;
-if(!_30[_31]){
-throw (["dojo.hitch: scope[\"",_31,"\"] is null (scope=\"",_30,"\")"].join(""));
+if(_10.isString(_27)){
+_26=_26||_1.global;
+if(!_26[_27]){
+throw (["lang.hitch: scope[\"",_27,"\"] is null (scope=\"",_26,"\")"].join(""));
 }
 return function(){
-return _30[_31].apply(_30,arguments||[]);
+return _26[_27].apply(_26,arguments||[]);
 };
 }
-return !_30?_31:function(){
-return _31.apply(_30,arguments||[]);
+return !_26?_27:function(){
+return _27.apply(_26,arguments||[]);
 };
-},_32=(function(){
+},delegate:(function(){
 function TMP(){
 };
-return function(obj,_33){
+return function(obj,_28){
 TMP.prototype=obj;
 var tmp=new TMP();
 TMP.prototype=null;
-if(_33){
-_e._mixin(tmp,_33);
+if(_28){
+_10._mixin(tmp,_28);
 }
 return tmp;
 };
-})(),_34=function(obj,_35,_36){
-return (_36||[]).concat(Array.prototype.slice.call(obj,_35||0));
-},_2c=_2("ie")?(function(){
-function _37(obj,_38,_39){
-var arr=_39||[];
-for(var x=_38||0;x<obj.length;x++){
+})(),_toArray:_2("ie")?(function(){
+function _29(obj,_2a,_2b){
+var arr=_2b||[];
+for(var x=_2a||0;x<obj.length;x++){
 arr.push(obj[x]);
 }
 return arr;
 };
 return function(obj){
-return ((obj.item)?_37:_34).apply(this,arguments);
+return ((obj.item)?_29:_b).apply(this,arguments);
 };
-})():_34,_3a=function(_3b){
+})():_b,partial:function(_2c){
 var arr=[null];
-return _e.hitch.apply(_1,arr.concat(_e._toArray(arguments)));
-},_3c=function(src){
-if(!src||typeof src!="object"||_e.isFunction(src)){
+return _10.hitch.apply(_1,arr.concat(_10._toArray(arguments)));
+},clone:function(src){
+if(!src||typeof src!="object"||_10.isFunction(src)){
 return src;
 }
 if(src.nodeType&&"cloneNode" in src){
@@ -153,26 +154,26 @@ if(src instanceof RegExp){
 return new RegExp(src);
 }
 var r,i,l;
-if(_e.isArray(src)){
+if(_10.isArray(src)){
 r=[];
 for(i=0,l=src.length;i<l;++i){
 if(i in src){
-r.push(_3c(src[i]));
+r.push(_10.clone(src[i]));
 }
 }
 }else{
 r=src.constructor?new src.constructor():{};
 }
-return _e._mixin(r,src,_3c);
-},_3d=String.prototype.trim?function(str){
+return _10._mixin(r,src,_10.clone);
+},trim:String.prototype.trim?function(str){
 return str.trim();
 }:function(str){
 return str.replace(/^\s\s*/,"").replace(/\s\s*$/,"");
-},_3e=/\{([^\}]+)\}/g,_3f=function(_40,map,_41){
-return _40.replace(_41||_3e,_e.isFunction(map)?map:function(_42,k){
-return _19(k,false,map);
+},replace:function(_2d,map,_2e){
+return _2d.replace(_2e||_f,_10.isFunction(map)?map:function(_2f,k){
+return _10.getObject(k,false,map);
 });
-},_e={_extraNames:_3,_mixin:_5,mixin:_b,setObject:_14,getObject:_19,exists:_1d,isString:_20,isArray:_21,isFunction:_22,isObject:_23,isArrayLike:_24,isAlien:_25,extend:_26,_hitchArgs:_29,hitch:_2f,delegate:_32,_toArray:_2c,partial:_3a,clone:_3c,trim:_3d,replace:_3f};
-1&&_b(_1,_e);
-return _e;
+}};
+1&&_10.mixin(_1,_10);
+return _10;
 });

data/vendor/assets/javascripts/dojo/_base/lang.js.uncompressed.js

@@ -1,24 +1,75 @@
-define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has){
-	//	module:
+define("dojo/_base/lang", ["./kernel", "../has", "../sniff"], function(dojo, has){
+	// module:
 	//		dojo/_base/lang
-	//	summary:
-	//		This module defines Javascript language extensions.
 
 	has.add("bug-for-in-skips-shadowed", function(){
-		// if true, the for-in interator skips object properties that exist in Object's prototype (IE 6 - ?)
+		// if true, the for-in iterator skips object properties that exist in Object's prototype (IE 6 - ?)
 		for(var i in {toString: 1}){
 			return 0;
 		}
 		return 1;
 	});
 
+	// Helper methods
 	var _extraNames =
 			has("bug-for-in-skips-shadowed") ?
 				"hasOwnProperty.valueOf.isPrototypeOf.propertyIsEnumerable.toLocaleString.toString.constructor".split(".") : [],
 
 		_extraLen = _extraNames.length,
 
-		_mixin = function(dest, source, copyFunc){
+		getProp = function(/*Array*/parts, /*Boolean*/create, /*Object*/context){
+			var p, i = 0, dojoGlobal = dojo.global;
+			if(!context){
+				if(!parts.length){
+					return dojoGlobal;
+				}else{
+					p = parts[i++];
+					try{
+						context = dojo.scopeMap[p] && dojo.scopeMap[p][1];
+					}catch(e){}
+					context = context || (p in dojoGlobal ? dojoGlobal[p] : (create ? dojoGlobal[p] = {} : undefined));
+				}
+			}
+			while(context && (p = parts[i++])){
+				context = (p in context ? context[p] : (create ? context[p] = {} : undefined));
+			}
+			return context; // mixed
+		},
+
+		opts = Object.prototype.toString,
+
+		efficient = function(obj, offset, startWith){
+			return (startWith||[]).concat(Array.prototype.slice.call(obj, offset||0));
+		},
+
+		_pattern = /\{([^\}]+)\}/g;
+
+	// Module export
+	var lang = {
+		// summary:
+		//		This module defines Javascript language extensions.
+
+		// _extraNames: String[]
+		//		Lists property names that must be explicitly processed during for-in iteration
+		//		in environments that have has("bug-for-in-skips-shadowed") true.
+		_extraNames:_extraNames,
+
+		_mixin: function(dest, source, copyFunc){
+			// summary:
+			//		Copies/adds all properties of source to dest; returns dest.
+			// dest: Object
+			//		The object to which to copy/add all properties contained in source.
+			// source: Object
+			//		The object from which to draw all properties to copy into dest.
+			// copyFunc: Function?
+			//		The process used to copy/add a property in source; defaults to the Javascript assignment operator.
+			// returns:
+			//		dest, as modified
+			// description:
+			//		All properties, including functions (sometimes termed "methods"), excluding any non-standard extensions
+			//		found in Object.prototype, are copied/added to dest. Copying/adding each particular property is
+			//		delegated to copyFunc (if any); copyFunc defaults to the Javascript assignment operator if not provided.
+			//		Notice that by default, _mixin executes a so-called "shallow copy" and aggregate types are copied/added by reference.
 			var name, s, i, empty = {};
 			for(name in source){
 				// the (!(name in empty) || empty[name] !== s) condition avoids copying properties in "source"
@@ -45,7 +96,61 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 			return dest; // Object
 		},
 
-		mixin = function(dest, sources){
+		mixin: function(dest, sources){
+			// summary:
+			//		Copies/adds all properties of one or more sources to dest; returns dest.
+			// dest: Object
+			//		The object to which to copy/add all properties contained in source. If dest is falsy, then
+			//		a new object is manufactured before copying/adding properties begins.
+			// sources: Object...
+			//		One of more objects from which to draw all properties to copy into dest. sources are processed
+			//		left-to-right and if more than one of these objects contain the same property name, the right-most
+			//		value "wins".
+			// returns: Object
+			//		dest, as modified
+			// description:
+			//		All properties, including functions (sometimes termed "methods"), excluding any non-standard extensions
+			//		found in Object.prototype, are copied/added from sources to dest. sources are processed left to right.
+			//		The Javascript assignment operator is used to copy/add each property; therefore, by default, mixin
+			//		executes a so-called "shallow copy" and aggregate types are copied/added by reference.
+			// example:
+			//		make a shallow copy of an object
+			//	|	var copy = lang.mixin({}, source);
+			// example:
+			//		many class constructors often take an object which specifies
+			//		values to be configured on the object. In this case, it is
+			//		often simplest to call `lang.mixin` on the `this` object:
+			//	|	declare("acme.Base", null, {
+			//	|		constructor: function(properties){
+			//	|			// property configuration:
+			//	|			lang.mixin(this, properties);
+			//	|
+			//	|			console.log(this.quip);
+			//	|			//	...
+			//	|		},
+			//	|		quip: "I wasn't born yesterday, you know - I've seen movies.",
+			//	|		// ...
+			//	|	});
+			//	|
+			//	|	// create an instance of the class and configure it
+			//	|	var b = new acme.Base({quip: "That's what it does!" });
+			// example:
+			//		copy in properties from multiple objects
+			//	|	var flattened = lang.mixin(
+			//	|		{
+			//	|			name: "Frylock",
+			//	|			braces: true
+			//	|		},
+			//	|		{
+			//	|			name: "Carl Brutanananadilewski"
+			//	|		}
+			//	|	);
+			//	|
+			//	|	// will print "Carl Brutanananadilewski"
+			//	|	console.log(flattened.name);
+			//	|	// will print "true"
+			//	|	console.log(flattened.braces);
+
 			if(!dest){ dest = {}; }
 			for(var i = 1, l = arguments.length; i < l; i++){
 				lang._mixin(dest, arguments[i]);
@@ -53,60 +158,133 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 			return dest; // Object
 		},
 
-		getProp = function(/*Array*/parts, /*Boolean*/create, /*Object*/context){
-			var p, i = 0, dojoGlobal = dojo.global;
-			if(!context){
-				if(!parts.length){
-					return dojoGlobal;
-				}else{
-					p = parts[i++];
-					try{
-						context = dojo.scopeMap[p] && dojo.scopeMap[p][1];
-					}catch(e){}
-					context = context || (p in dojoGlobal ? dojoGlobal[p] : (create ? dojoGlobal[p] = {} : undefined));
-				}
-			}
-			while(context && (p = parts[i++])){
-				context = (p in context ? context[p] : (create ? context[p] = {} : undefined));
-			}
-			return context; // mixed
-		},
+		setObject: function(name, value, context){
+			// summary:
+			//		Set a property from a dot-separated string, such as "A.B.C"
+			// description:
+			//		Useful for longer api chains where you have to test each object in
+			//		the chain, or when you have an object reference in string format.
+			//		Objects are created as needed along `path`. Returns the passed
+			//		value if setting is successful or `undefined` if not.
+			// name: String
+			//		Path to a property, in the form "A.B.C".
+			// value: anything
+			//		value or object to place at location given by name
+			// context: Object?
+			//		Optional. Object to use as root of path. Defaults to
+			//		`dojo.global`.
+			// example:
+			//		set the value of `foo.bar.baz`, regardless of whether
+			//		intermediate objects already exist:
+			//	| lang.setObject("foo.bar.baz", value);
+			// example:
+			//		without `lang.setObject`, we often see code like this:
+			//	| // ensure that intermediate objects are available
+			//	| if(!obj["parent"]){ obj.parent = {}; }
+			//	| if(!obj.parent["child"]){ obj.parent.child = {}; }
+			//	| // now we can safely set the property
+			//	| obj.parent.child.prop = "some value";
+			//		whereas with `lang.setObject`, we can shorten that to:
+			//	| lang.setObject("parent.child.prop", "some value", obj);
 
-		setObject = function(name, value, context){
 			var parts = name.split("."), p = parts.pop(), obj = getProp(parts, true, context);
 			return obj && p ? (obj[p] = value) : undefined; // Object
 		},
 
-		getObject = function(name, create, context){
+		getObject: function(name, create, context){
+			// summary:
+			//		Get a property from a dot-separated string, such as "A.B.C"
+			// description:
+			//		Useful for longer api chains where you have to test each object in
+			//		the chain, or when you have an object reference in string format.
+			// name: String
+			//		Path to an property, in the form "A.B.C".
+			// create: Boolean?
+			//		Optional. Defaults to `false`. If `true`, Objects will be
+			//		created at any point along the 'path' that is undefined.
+			// context: Object?
+			//		Optional. Object to use as root of path. Defaults to
+			//		'dojo.global'. Null may be passed.
 			return getProp(name.split("."), create, context); // Object
 		},
 
-		exists = function(name, obj){
+		exists: function(name, obj){
+			// summary:
+			//		determine if an object supports a given method
+			// description:
+			//		useful for longer api chains where you have to test each object in
+			//		the chain. Useful for object and method detection.
+			// name: String
+			//		Path to an object, in the form "A.B.C".
+			// obj: Object?
+			//		Object to use as root of path. Defaults to
+			//		'dojo.global'. Null may be passed.
+			// example:
+			//	| // define an object
+			//	| var foo = {
+			//	|		bar: { }
+			//	| };
+			//	|
+			//	| // search the global scope
+			//	| lang.exists("foo.bar"); // true
+			//	| lang.exists("foo.bar.baz"); // false
+			//	|
+			//	| // search from a particular scope
+			//	| lang.exists("bar", foo); // true
+			//	| lang.exists("bar.baz", foo); // false
 			return lang.getObject(name, false, obj) !== undefined; // Boolean
 		},
 
-		opts = Object.prototype.toString,
-
 		// Crockford (ish) functions
 
-		isString = function(it){
+		isString: function(it){
+			// summary:
+			//		Return true if it is a String
+			// it: anything
+			//		Item to test.
 			return (typeof it == "string" || it instanceof String); // Boolean
 		},
 
-		isArray = function(it){
+		isArray: function(it){
+			// summary:
+			//		Return true if it is an Array.
+			//		Does not work on Arrays created in other windows.
+			// it: anything
+			//		Item to test.
 			return it && (it instanceof Array || typeof it == "array"); // Boolean
 		},
 
-		isFunction = function(it){
+		isFunction: function(it){
+			// summary:
+			//		Return true if it is a Function
+			// it: anything
+			//		Item to test.
 			return opts.call(it) === "[object Function]";
 		},
 
-		isObject = function(it){
+		isObject: function(it){
+			// summary:
+			//		Returns true if it is a JavaScript object (or an Array, a Function
+			//		or null)
+			// it: anything
+			//		Item to test.
 			return it !== undefined &&
 				(it === null || typeof it == "object" || lang.isArray(it) || lang.isFunction(it)); // Boolean
 		},
 
-		isArrayLike = function(it){
+		isArrayLike: function(it){
+			// summary:
+			//		similar to isArray() but more permissive
+			// it: anything
+			//		Item to test.
+			// returns:
+			//		If it walks like a duck and quacks like a duck, return `true`
+			// description:
+			//		Doesn't strongly test for "arrayness".  Instead, settles for "isn't
+			//		a string or number and has a length property". Arguments objects
+			//		and DOM collections will return true when passed to
+			//		isArrayLike(), but will return false when passed to
+			//		isArray().
 			return it && it !== undefined && // Boolean
 				// keep out built-in constructors (Number, String, ...) which have length
 				// properties
@@ -115,23 +293,34 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 				(lang.isArray(it) || isFinite(it.length));
 		},
 
-		isAlien = function(it){
+		isAlien: function(it){
+			// summary:
+			//		Returns true if it is a built-in function or some other kind of
+			//		oddball that *should* report as a function but doesn't
 			return it && !lang.isFunction(it) && /\{\s*\[native code\]\s*\}/.test(String(it)); // Boolean
 		},
 
-		extend = function(constructor, props){
+		extend: function(ctor, props){
+			// summary:
+			//		Adds all properties and methods of props to constructor's
+			//		prototype, making them available to all instances created with
+			//		constructor.
+			// ctor: Object
+			//		Target constructor to extend.
+			// props: Object
+			//		One or more objects to mix into ctor.prototype
 			for(var i=1, l=arguments.length; i<l; i++){
-				lang._mixin(constructor.prototype, arguments[i]);
+				lang._mixin(ctor.prototype, arguments[i]);
 			}
-			return constructor; // Object
+			return ctor; // Object
 		},
 
-		_hitchArgs = function(scope, method){
-			var pre = _toArray(arguments, 2);
+		_hitchArgs: function(scope, method){
+			var pre = lang._toArray(arguments, 2);
 			var named = lang.isString(method);
 			return function(){
 				// arrayify arguments
-				var args = _toArray(arguments);
+				var args = lang._toArray(arguments);
 				// locate our method
 				var f = named ? (scope||dojo.global)[method] : method;
 				// invoke with collected args
@@ -139,7 +328,38 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 			}; // Function
 		},
 
-		hitch = function(scope, method){
+		hitch: function(scope, method){
+			// summary:
+			//		Returns a function that will only ever execute in the a given scope.
+			//		This allows for easy use of object member functions
+			//		in callbacks and other places in which the "this" keyword may
+			//		otherwise not reference the expected scope.
+			//		Any number of default positional arguments may be passed as parameters
+			//		beyond "method".
+			//		Each of these values will be used to "placehold" (similar to curry)
+			//		for the hitched function.
+			// scope: Object
+			//		The scope to use when method executes. If method is a string,
+			//		scope is also the object containing method.
+			// method: Function|String...
+			//		A function to be hitched to scope, or the name of the method in
+			//		scope to be hitched.
+			// example:
+			//	|	lang.hitch(foo, "bar")();
+			//		runs foo.bar() in the scope of foo
+			// example:
+			//	|	lang.hitch(foo, myFunction);
+			//		returns a function that runs myFunction in the scope of foo
+			// example:
+			//		Expansion on the default positional arguments passed along from
+			//		hitch. Passed args are mixed first, additional args after.
+			//	|	var foo = { bar: function(a, b, c){ console.log(a, b, c); } };
+			//	|	var fn = lang.hitch(foo, "bar", 1, 2);
+			//	|	fn(3); // logs "1, 2, 3"
+			// example:
+			//	|	var foo = { bar: 2 };
+			//	|	lang.hitch(foo, function(){ this.bar = 10; })();
+			//		execute an anonymous function in scope of foo
 			if(arguments.length > 2){
 				return lang._hitchArgs.apply(dojo, arguments); // Function
 			}
@@ -149,13 +369,13 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 			}
 			if(lang.isString(method)){
 				scope = scope || dojo.global;
-				if(!scope[method]){ throw(['dojo.hitch: scope["', method, '"] is null (scope="', scope, '")'].join('')); }
+				if(!scope[method]){ throw(['lang.hitch: scope["', method, '"] is null (scope="', scope, '")'].join('')); }
 				return function(){ return scope[method].apply(scope, arguments || []); }; // Function
 			}
 			return !scope ? method : function(){ return method.apply(scope, arguments || []); }; // Function
 		},
 
-		delegate = (function(){
+		delegate: (function(){
 			// boodman/crockford delegation w/ cornford optimization
 			function TMP(){}
 			return function(obj, props){
@@ -168,32 +388,88 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 				return tmp; // Object
 			};
 		})(),
-
-		efficient = function(obj, offset, startWith){
-			return (startWith||[]).concat(Array.prototype.slice.call(obj, offset||0));
+		/*=====
+		delegate: function(obj, props){
+			// summary:
+			//		Returns a new object which "looks" to obj for properties which it
+			//		does not have a value for. Optionally takes a bag of properties to
+			//		seed the returned object with initially.
+			// description:
+			//		This is a small implementation of the Boodman/Crockford delegation
+			//		pattern in JavaScript. An intermediate object constructor mediates
+			//		the prototype chain for the returned object, using it to delegate
+			//		down to obj for property lookup when object-local lookup fails.
+			//		This can be thought of similarly to ES4's "wrap", save that it does
+			//		not act on types but rather on pure objects.
+			// obj: Object
+			//		The object to delegate to for properties not found directly on the
+			//		return object or in props.
+			// props: Object...
+			//		an object containing properties to assign to the returned object
+			// returns:
+			//		an Object of anonymous type
+			// example:
+			//	|	var foo = { bar: "baz" };
+			//	|	var thinger = lang.delegate(foo, { thud: "xyzzy"});
+			//	|	thinger.bar == "baz"; // delegated to foo
+			//	|	foo.thud == undefined; // by definition
+			//	|	thinger.thud == "xyzzy"; // mixed in from props
+			//	|	foo.bar = "thonk";
+			//	|	thinger.bar == "thonk"; // still delegated to foo's bar
 		},
-
-		_toArray =
-			has("ie") ?
-				(function(){
-					function slow(obj, offset, startWith){
-						var arr = startWith||[];
-						for(var x = offset || 0; x < obj.length; x++){
-							arr.push(obj[x]);
-						}
-						return arr;
+		=====*/
+
+		_toArray: has("ie") ?
+			(function(){
+				function slow(obj, offset, startWith){
+					var arr = startWith||[];
+					for(var x = offset || 0; x < obj.length; x++){
+						arr.push(obj[x]);
 					}
-					return function(obj){
-						return ((obj.item) ? slow : efficient).apply(this, arguments);
-					};
-				})() : efficient,
-
-		partial = function(/*Function|String*/method /*, ...*/){
+					return arr;
+				}
+				return function(obj){
+					return ((obj.item) ? slow : efficient).apply(this, arguments);
+				};
+			})() : efficient,
+		/*=====
+		 _toArray: function(obj, offset, startWith){
+			 // summary:
+			 //		Converts an array-like object (i.e. arguments, DOMCollection) to an
+			 //		array. Returns a new Array with the elements of obj.
+			 // obj: Object
+			 //		the object to "arrayify". We expect the object to have, at a
+			 //		minimum, a length property which corresponds to integer-indexed
+			 //		properties.
+			 // offset: Number?
+			 //		the location in obj to start iterating from. Defaults to 0.
+			 //		Optional.
+			 // startWith: Array?
+			 //		An array to pack with the properties of obj. If provided,
+			 //		properties in obj are appended at the end of startWith and
+			 //		startWith is the returned array.
+		 },
+		 =====*/
+
+		partial: function(/*Function|String*/ method /*, ...*/){
+			// summary:
+			//		similar to hitch() except that the scope object is left to be
+			//		whatever the execution context eventually becomes.
+			// description:
+			//		Calling lang.partial is the functional equivalent of calling:
+			//		|	lang.hitch(null, funcName, ...);
+			// method:
+			//		The function to "wrap"
 			var arr = [ null ];
 			return lang.hitch.apply(dojo, arr.concat(lang._toArray(arguments))); // Function
 		},
 
-		clone = function(/*anything*/ src){
+		clone: function(/*anything*/ src){
+			// summary:
+			//		Clones objects (including DOM nodes) and all children.
+			//		Warning: do not clone cyclic structures.
+			// src:
+			//		The object to clone
 			if(!src || typeof src != "object" || lang.isFunction(src)){
 				// null, undefined, any non-object, or function
 				return src;	// anything
@@ -216,492 +492,114 @@ define("dojo/_base/lang", ["./kernel", "../has", "./sniff"], function(dojo, has)
 				r = [];
 				for(i = 0, l = src.length; i < l; ++i){
 					if(i in src){
-						r.push(clone(src[i]));
+						r.push(lang.clone(src[i]));
 					}
 				}
-	// we don't clone functions for performance reasons
-	//		}else if(d.isFunction(src)){
-	//			// function
-	//			r = function(){ return src.apply(this, arguments); };
+				// we don't clone functions for performance reasons
+				//		}else if(d.isFunction(src)){
+				//			// function
+				//			r = function(){ return src.apply(this, arguments); };
 			}else{
 				// generic objects
 				r = src.constructor ? new src.constructor() : {};
 			}
-			return lang._mixin(r, src, clone);
+			return lang._mixin(r, src, lang.clone);
 		},
 
 
-		trim = String.prototype.trim ?
+		trim: String.prototype.trim ?
 			function(str){ return str.trim(); } :
 			function(str){ return str.replace(/^\s\s*/, '').replace(/\s\s*$/, ''); },
+		/*=====
+		 trim: function(str){
+			 // summary:
+			 //		Trims whitespace from both sides of the string
+			 // str: String
+			 //		String to be trimmed
+			 // returns: String
+			 //		Returns the trimmed string
+			 // description:
+			 //		This version of trim() was selected for inclusion into the base due
+			 //		to its compact size and relatively good performance
+			 //		(see [Steven Levithan's blog](http://blog.stevenlevithan.com/archives/faster-trim-javascript)
+			 //		Uses String.prototype.trim instead, if available.
+			 //		The fastest but longest version of this function is located at
+			 //		lang.string.trim()
+		 },
+		 =====*/
+
+		replace: function(tmpl, map, pattern){
+			// summary:
+			//		Performs parameterized substitutions on a string. Throws an
+			//		exception if any parameter is unmatched.
+			// tmpl: String
+			//		String to be used as a template.
+			// map: Object|Function
+			//		If an object, it is used as a dictionary to look up substitutions.
+			//		If a function, it is called for every substitution with following parameters:
+			//		a whole match, a name, an offset, and the whole template
+			//		string (see https://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/String/replace
+			//		for more details).
+			// pattern: RegEx?
+			//		Optional regular expression objects that overrides the default pattern.
+			//		Must be global and match one item. The default is: /\{([^\}]+)\}/g,
+			//		which matches patterns like that: "{xxx}", where "xxx" is any sequence
+			//		of characters, which doesn't include "}".
+			// returns: String
+			//		Returns the substituted string.
+			// example:
+			//	|	// uses a dictionary for substitutions:
+			//	|	lang.replace("Hello, {name.first} {name.last} AKA {nick}!",
+			//	|		{
+			//	|			nick: "Bob",
+			//	|			name: {
+			//	|				first:	"Robert",
+			//	|				middle: "X",
+			//	|				last:		"Cringely"
+			//	|			}
+			//	|		});
+			//	|	// returns: Hello, Robert Cringely AKA Bob!
+			// example:
+			//	|	// uses an array for substitutions:
+			//	|	lang.replace("Hello, {0} {2}!",
+			//	|		["Robert", "X", "Cringely"]);
+			//	|	// returns: Hello, Robert Cringely!
+			// example:
+			//	|	// uses a function for substitutions:
+			//	|	function sum(a){
+			//	|		var t = 0;
+			//	|		arrayforEach(a, function(x){ t += x; });
+			//	|		return t;
+			//	|	}
+			//	|	lang.replace(
+			//	|		"{count} payments averaging {avg} USD per payment.",
+			//	|		lang.hitch(
+			//	|			{ payments: [11, 16, 12] },
+			//	|			function(_, key){
+			//	|				switch(key){
+			//	|					case "count": return this.payments.length;
+			//	|					case "min":		return Math.min.apply(Math, this.payments);
+			//	|					case "max":		return Math.max.apply(Math, this.payments);
+			//	|					case "sum":		return sum(this.payments);
+			//	|					case "avg":		return sum(this.payments) / this.payments.length;
+			//	|				}
+			//	|			}
+			//	|		)
+			//	|	);
+			//	|	// prints: 3 payments averaging 13 USD per payment.
+			// example:
+			//	|	// uses an alternative PHP-like pattern for substitutions:
+			//	|	lang.replace("Hello, ${0} ${2}!",
+			//	|		["Robert", "X", "Cringely"], /\$\{([^\}]+)\}/g);
+			//	|	// returns: Hello, Robert Cringely!
 
-
-		_pattern = /\{([^\}]+)\}/g,
-
-		replace = function(tmpl, map, pattern){
 			return tmpl.replace(pattern || _pattern, lang.isFunction(map) ?
-				map : function(_, k){ return getObject(k, false, map); });
-		},
+				map : function(_, k){ return lang.getObject(k, false, map); });
+		}
+	};
 
-		lang = {
-			_extraNames:_extraNames,
-			_mixin:_mixin,
-			mixin:mixin,
-			setObject:setObject,
-			getObject:getObject,
-			exists:exists,
-			isString:isString,
-			isArray:isArray,
-			isFunction:isFunction,
-			isObject:isObject,
-			isArrayLike:isArrayLike,
-			isAlien:isAlien,
-			extend:extend,
-			_hitchArgs:_hitchArgs,
-			hitch:hitch,
-			delegate:delegate,
-			_toArray:_toArray,
-			partial:partial,
-			clone:clone,
-			trim:trim,
-			replace:replace
-		};
-
-	1 && mixin(dojo, lang);
-	return lang;
+	 1  && lang.mixin(dojo, lang);
 
-	/*=====
-	dojo._extraNames
-	// summary:
-	//		Array of strings. Lists property names that must be explicitly processed during for-in interation
-	//		in environments that have has("bug-for-in-skips-shadowed") true.
-	=====*/
-
-	/*=====
-	dojo._mixin = function(dest, source, copyFunc){
-		//	summary:
-		//		Copies/adds all properties of source to dest; returns dest.
-		//	dest: Object:
-		//		The object to which to copy/add all properties contained in source.
-		//	source: Object:
-		//		The object from which to draw all properties to copy into dest.
-		//	copyFunc: Function?:
-		//		The process used to copy/add a property in source; defaults to the Javascript assignment operator.
-		//	returns:
-		//		dest, as modified
-		//	description:
-		//		All properties, including functions (sometimes termed "methods"), excluding any non-standard extensions
-		//		found in Object.prototype, are copied/added to dest. Copying/adding each particular property is
-		//		delegated to copyFunc (if any); copyFunc defaults to the Javascript assignment operator if not provided.
-		//		Notice that by default, _mixin executes a so-called "shallow copy" and aggregate types are copied/added by reference.
-	}
-	=====*/
-
-	/*=====
-	dojo.mixin = function(dest, sources){
-	//	summary:
-	//		Copies/adds all properties of one or more sources to dest; returns dest.
-	//	dest: Object
-	//		The object to which to copy/add all properties contained in source. If dest is falsy, then
-	//		a new object is manufactured before copying/adding properties begins.
-	//	sources: Object...
-	//		One of more objects from which to draw all properties to copy into dest. sources are processed
-	//		left-to-right and if more than one of these objects contain the same property name, the right-most
-	//		value "wins".
-	//	returns: Object
-	//		dest, as modified
-	//	description:
-	//		All properties, including functions (sometimes termed "methods"), excluding any non-standard extensions
-	//		found in Object.prototype, are copied/added from sources to dest. sources are processed left to right.
-	//		The Javascript assignment operator is used to copy/add each property; therefore, by default, mixin
-	//		executes a so-called "shallow copy" and aggregate types are copied/added by reference.
-	//	example:
-	//		make a shallow copy of an object
-	//	| var copy = lang.mixin({}, source);
-	//	example:
-	//		many class constructors often take an object which specifies
-	//		values to be configured on the object. In this case, it is
-	//		often simplest to call `lang.mixin` on the `this` object:
-	//	| dojo.declare("acme.Base", null, {
-	//	|		constructor: function(properties){
-	//	|			// property configuration:
-	//	|			lang.mixin(this, properties);
-	//	|
-	//	|			console.log(this.quip);
-	//	|			//	...
-	//	|		},
-	//	|		quip: "I wasn't born yesterday, you know - I've seen movies.",
-	//	|		// ...
-	//	| });
-	//	|
-	//	| // create an instance of the class and configure it
-	//	| var b = new acme.Base({quip: "That's what it does!" });
-	//	example:
-	//		copy in properties from multiple objects
-	//	| var flattened = lang.mixin(
-	//	|		{
-	//	|			name: "Frylock",
-	//	|			braces: true
-	//	|		},
-	//	|		{
-	//	|			name: "Carl Brutanananadilewski"
-	//	|		}
-	//	| );
-	//	|
-	//	| // will print "Carl Brutanananadilewski"
-	//	| console.log(flattened.name);
-	//	| // will print "true"
-	//	| console.log(flattened.braces);
-	}
-	=====*/
-
-	/*=====
-	dojo.setObject = function(name, value, context){
-	// summary:
-	//		Set a property from a dot-separated string, such as "A.B.C"
-	//	description:
-	//		Useful for longer api chains where you have to test each object in
-	//		the chain, or when you have an object reference in string format.
-	//		Objects are created as needed along `path`. Returns the passed
-	//		value if setting is successful or `undefined` if not.
-	//	name: String
-	//		Path to a property, in the form "A.B.C".
-	//	value: anything
-	//		value or object to place at location given by name
-	//	context: Object?
-	//		Optional. Object to use as root of path. Defaults to
-	//		`dojo.global`.
-	//	example:
-	//		set the value of `foo.bar.baz`, regardless of whether
-	//		intermediate objects already exist:
-	//	| lang.setObject("foo.bar.baz", value);
-	//	example:
-	//		without `lang.setObject`, we often see code like this:
-	//	| // ensure that intermediate objects are available
-	//	| if(!obj["parent"]){ obj.parent = {}; }
-	//	| if(!obj.parent["child"]){ obj.parent.child = {}; }
-	//	| // now we can safely set the property
-	//	| obj.parent.child.prop = "some value";
-	//		whereas with `lang.setObject`, we can shorten that to:
-	//	| lang.setObject("parent.child.prop", "some value", obj);
-	}
-	=====*/
-
-	/*=====
-	dojo.getObject = function(name, create, context){
-	// summary:
-	//		Get a property from a dot-separated string, such as "A.B.C"
-	//	description:
-	//		Useful for longer api chains where you have to test each object in
-	//		the chain, or when you have an object reference in string format.
-	//	name: String
-	//		Path to an property, in the form "A.B.C".
-	//	create: Boolean?
-	//		Optional. Defaults to `false`. If `true`, Objects will be
-	//		created at any point along the 'path' that is undefined.
-	//	context: Object?
-	//		Optional. Object to use as root of path. Defaults to
-	//		'dojo.global'. Null may be passed.
-	}
-	=====*/
-
-	/*=====
-	dojo.exists = function(name, obj){
-	//	summary:
-	//		determine if an object supports a given method
-	//	description:
-	//		useful for longer api chains where you have to test each object in
-	//		the chain. Useful for object and method detection.
-	//	name: String
-	//		Path to an object, in the form "A.B.C".
-	//	obj: Object?
-	//		Object to use as root of path. Defaults to
-	//		'dojo.global'. Null may be passed.
-	//	example:
-	//	| // define an object
-	//	| var foo = {
-	//	|		bar: { }
-	//	| };
-	//	|
-	//	| // search the global scope
-	//	| lang.exists("foo.bar"); // true
-	//	| lang.exists("foo.bar.baz"); // false
-	//	|
-	//	| // search from a particular scope
-	//	| lang.exists("bar", foo); // true
-	//	| lang.exists("bar.baz", foo); // false
-	}
-	=====*/
-
-	/*=====
-	dojo.isString = function(it){
-	//	summary:
-	//		Return true if it is a String
-	//	it: anything
-	//		Item to test.
-	}
-	=====*/
-
-	/*=====
-	dojo.isArray = function(it){
-	//	summary:
-	//		Return true if it is an Array.
-	//		Does not work on Arrays created in other windows.
-	//	it: anything
-	//		Item to test.
-	}
-	=====*/
-
-	/*=====
-	dojo.isFunction = function(it){
-	// summary:
-	//		Return true if it is a Function
-	//	it: anything
-	//		Item to test.
-	}
-	=====*/
-
-	/*=====
-	dojo.isObject = function(it){
-	// summary:
-	//		Returns true if it is a JavaScript object (or an Array, a Function
-	//		or null)
-	//	it: anything
-	//		Item to test.
-	}
-	=====*/
-
-	/*=====
-	dojo.isArrayLike = function(it){
-	//	summary:
-	//		similar to dojo.isArray() but more permissive
-	//	it: anything
-	//		Item to test.
-	//	returns:
-	//		If it walks like a duck and quacks like a duck, return `true`
-	//	description:
-	//		Doesn't strongly test for "arrayness".  Instead, settles for "isn't
-	//		a string or number and has a length property". Arguments objects
-	//		and DOM collections will return true when passed to
-	//		dojo.isArrayLike(), but will return false when passed to
-	//		dojo.isArray().
-	}
-	=====*/
-
-	/*=====
-	dojo.isAlien = function(it){
-	// summary:
-	//		Returns true if it is a built-in function or some other kind of
-	//		oddball that *should* report as a function but doesn't
-	}
-	=====*/
-
-	/*=====
-	dojo.extend = function(constructor, props){
-	// summary:
-	//		Adds all properties and methods of props to constructor's
-	//		prototype, making them available to all instances created with
-	//		constructor.
-	//	constructor: Object
-	//		Target constructor to extend.
-	//	props: Object...
-	//		One or more objects to mix into constructor.prototype
-	}
-	=====*/
-
-	/*=====
-	dojo.hitch = function(scope, method){
-	//	summary:
-	//		Returns a function that will only ever execute in the a given scope.
-	//		This allows for easy use of object member functions
-	//		in callbacks and other places in which the "this" keyword may
-	//		otherwise not reference the expected scope.
-	//		Any number of default positional arguments may be passed as parameters
-	//		beyond "method".
-	//		Each of these values will be used to "placehold" (similar to curry)
-	//		for the hitched function.
-	//	scope: Object
-	//		The scope to use when method executes. If method is a string,
-	//		scope is also the object containing method.
-	//	method: Function|String...
-	//		A function to be hitched to scope, or the name of the method in
-	//		scope to be hitched.
-	//	example:
-	//	|	dojo.hitch(foo, "bar")();
-	//		runs foo.bar() in the scope of foo
-	//	example:
-	//	|	dojo.hitch(foo, myFunction);
-	//		returns a function that runs myFunction in the scope of foo
-	//	example:
-	//		Expansion on the default positional arguments passed along from
-	//		hitch. Passed args are mixed first, additional args after.
-	//	|	var foo = { bar: function(a, b, c){ console.log(a, b, c); } };
-	//	|	var fn = dojo.hitch(foo, "bar", 1, 2);
-	//	|	fn(3); // logs "1, 2, 3"
-	//	example:
-	//	|	var foo = { bar: 2 };
-	//	|	dojo.hitch(foo, function(){ this.bar = 10; })();
-	//		execute an anonymous function in scope of foo
-	}
-	=====*/
-
-	/*=====
-	dojo.delegate = function(obj, props){
-		//	summary:
-		//		Returns a new object which "looks" to obj for properties which it
-		//		does not have a value for. Optionally takes a bag of properties to
-		//		seed the returned object with initially.
-		//	description:
-		//		This is a small implementaton of the Boodman/Crockford delegation
-		//		pattern in JavaScript. An intermediate object constructor mediates
-		//		the prototype chain for the returned object, using it to delegate
-		//		down to obj for property lookup when object-local lookup fails.
-		//		This can be thought of similarly to ES4's "wrap", save that it does
-		//		not act on types but rather on pure objects.
-		//	obj: Object
-		//		The object to delegate to for properties not found directly on the
-		//		return object or in props.
-		//	props: Object...
-		//		an object containing properties to assign to the returned object
-		//	returns:
-		//		an Object of anonymous type
-		//	example:
-		//	|	var foo = { bar: "baz" };
-		//	|	var thinger = dojo.delegate(foo, { thud: "xyzzy"});
-		//	|	thinger.bar == "baz"; // delegated to foo
-		//	|	foo.thud == undefined; // by definition
-		//	|	thinger.thud == "xyzzy"; // mixed in from props
-		//	|	foo.bar = "thonk";
-		//	|	thinger.bar == "thonk"; // still delegated to foo's bar
-	}
-	=====*/
-
-	/*=====
-	dojo.partial = function(method){
-	//	summary:
-	//		similar to hitch() except that the scope object is left to be
-	//		whatever the execution context eventually becomes.
-	//	method: Function|String
-	//	description:
-	//		Calling dojo.partial is the functional equivalent of calling:
-	//		|	dojo.hitch(null, funcName, ...);
-	}
-	=====*/
-
-	/*=====
-	dojo.trim = function(str){
-		//	summary:
-		//		Trims whitespace from both sides of the string
-		//	str: String
-		//		String to be trimmed
-		//	returns: String
-		//		Returns the trimmed string
-		//	description:
-		//		This version of trim() was selected for inclusion into the base due
-		//		to its compact size and relatively good performance
-		//		(see [Steven Levithan's blog](http://blog.stevenlevithan.com/archives/faster-trim-javascript)
-		//		Uses String.prototype.trim instead, if available.
-		//		The fastest but longest version of this function is located at
-		//		dojo.string.trim()
-	}
-	=====*/
-
-	/*=====
-	dojo.clone = function(src){
-	// summary:
-	//		Clones objects (including DOM nodes) and all children.
-	//		Warning: do not clone cyclic structures.
-	//	src:
-	//		The object to clone
-	}
-	=====*/
-
-	/*=====
-	dojo._toArray = function(obj, offset, startWith){
-		//	summary:
-		//		Converts an array-like object (i.e. arguments, DOMCollection) to an
-		//		array. Returns a new Array with the elements of obj.
-		//	obj: Object
-		//		the object to "arrayify". We expect the object to have, at a
-		//		minimum, a length property which corresponds to integer-indexed
-		//		properties.
-		//	offset: Number?
-		//		the location in obj to start iterating from. Defaults to 0.
-		//		Optional.
-		//	startWith: Array?
-		//		An array to pack with the properties of obj. If provided,
-		//		properties in obj are appended at the end of startWith and
-		//		startWith is the returned array.
-	}
-	=====*/
-
-	/*=====
-	dojo.replace = function(tmpl, map, pattern){
-		//	summary:
-		//		Performs parameterized substitutions on a string. Throws an
-		//		exception if any parameter is unmatched.
-		//	tmpl: String
-		//		String to be used as a template.
-		//	map: Object|Function
-		//		If an object, it is used as a dictionary to look up substitutions.
-		//		If a function, it is called for every substitution with following
-		//		parameters: a whole match, a name, an offset, and the whole template
-		//		string (see https://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/String/replace
-		//		for more details).
-		//	pattern: RegEx?
-		//		Optional regular expression objects that overrides the default pattern.
-		//		Must be global and match one item. The default is: /\{([^\}]+)\}/g,
-		//		which matches patterns like that: "{xxx}", where "xxx" is any sequence
-		//		of characters, which doesn't include "}".
-		//	returns: String
-		//		Returns the substituted string.
-		//	example:
-		//	|	// uses a dictionary for substitutions:
-		//	|	dojo.replace("Hello, {name.first} {name.last} AKA {nick}!",
-		//	|		{
-		//	|			nick: "Bob",
-		//	|			name: {
-		//	|				first:	"Robert",
-		//	|				middle: "X",
-		//	|				last:		"Cringely"
-		//	|			}
-		//	|		});
-		//	|	// returns: Hello, Robert Cringely AKA Bob!
-		//	example:
-		//	|	// uses an array for substitutions:
-		//	|	dojo.replace("Hello, {0} {2}!",
-		//	|		["Robert", "X", "Cringely"]);
-		//	|	// returns: Hello, Robert Cringely!
-		//	example:
-		//	|	// uses a function for substitutions:
-		//	|	function sum(a){
-		//	|		var t = 0;
-		//	|		dojo.forEach(a, function(x){ t += x; });
-		//	|		return t;
-		//	|	}
-		//	|	dojo.replace(
-		//	|		"{count} payments averaging {avg} USD per payment.",
-		//	|		dojo.hitch(
-		//	|			{ payments: [11, 16, 12] },
-		//	|			function(_, key){
-		//	|				switch(key){
-		//	|					case "count": return this.payments.length;
-		//	|					case "min":		return Math.min.apply(Math, this.payments);
-		//	|					case "max":		return Math.max.apply(Math, this.payments);
-		//	|					case "sum":		return sum(this.payments);
-		//	|					case "avg":		return sum(this.payments) / this.payments.length;
-		//	|				}
-		//	|			}
-		//	|		)
-		//	|	);
-		//	|	// prints: 3 payments averaging 13 USD per payment.
-		//	example:
-		//	|	// uses an alternative PHP-like pattern for substitutions:
-		//	|	dojo.replace("Hello, ${0} ${2}!",
-		//	|		["Robert", "X", "Cringely"], /\$\{([^\}]+)\}/g);
-		//	|	// returns: Hello, Robert Cringely!
-		return "";	// String
-	}
-	=====*/
+	return lang;
 });