Tweaking union types (mainly removing spaces) so the doc parser understands them, refs #13101 !strict

Author: wkeese

charting/DataSeries.js

@@ -9,7 +9,7 @@ define(["dojo/_base/lang", "dojo/_base/declare", "dojo/_base/array", "dojo/_base
 			//		A dojo.data store object.
 			// kwArgs: Object
 			//		A store-specific keyword parameters used for fetching items.
-			//		See dojo.data.api.Read.fetch().
+			//		See dojo/data/api/Read.fetch().
 			// value: Function|Object|String
 			//		Function, which takes a store, and an object handle, and
 			//		produces an output possibly inspecting the store's item. Or
@@ -108,7 +108,7 @@ define(["dojo/_base/lang", "dojo/_base/declare", "dojo/_base/array", "dojo/_base
 		onFetchError: function(errorData, request){
 			// summary:
 			//		As stub to process fetch errors. Provide so user can attach to
-			//		it with dojo.connect(). See dojo.data.api.Read fetch() for
+			//		it with dojo.connect(). See dojo/data/api/Read fetch() for
 			//		details: onError property.
 			this._inFlight = false;
 		},

drawing/plugins/_Plugin.js

@@ -30,7 +30,7 @@ return oo.declare(
 		connect: function(){
 			this._cons.push(dojo.connect.apply(dojo, arguments));
 		},
-		disconnect: function(/*handle | Array*/handles){
+		disconnect: function(/*Handle|Array*/ handles){
 			// summary:
 			//		Removes connections based on passed
 			//		handles arguments

drawing/plugins/tools/Pan.js

@@ -79,7 +79,7 @@ var Pan = oo.declare(
 			},evt), this.interval);
 		},
 
-		onSetPan: function(/*Boolean | Event*/ bool){
+		onSetPan: function(/*Boolean|Event*/ bool){
 			if(bool === true || bool === false){
 				this.selected = !bool;
 			}

drawing/stencil/_Base.js

@@ -478,7 +478,7 @@ var Base = oo.declare(
 			}), ms);
 		},
 
-		attr: function(/*String | Object*/key, /* ? String | Number */value){
+		attr: function(/*String|Object*/ key, /*String|Number?*/value){
 			// summary:
 			//		Changes properties in the style or disabled styles,
 			//		depending on whether the object is enabled.
@@ -1133,7 +1133,7 @@ var Base = oo.declare(
 			return c;
 		},
 
-		disconnect: function(/*handle | Array*/handles){
+		disconnect: function(/*Handle|Array*/handles){
 			// summary:
 			//		Removes connections based on passed
 			//		handles arguments

drawing/ui/Toolbar.js

@@ -94,16 +94,16 @@ return dojo.declare("dojox.drawing.ui.Toolbar", [], {
 	//		The distance between the tool buttons and plug buttons
 	toolPlugGap:20,
 
-	// strSelected | selected: String
+	// strSelected: String
 	//		The button that should be selected at startup.
 	strSelected:"",
 
-	// strTools | tools: String
+	// strTools: String
 	//		A comma delineated list of the Stencil-tools to include in the Toolbar.
 	//		If "all" is used, all registered tools are included.
 	strTools:"",
 
-	// strPlugs | plugs: String
+	// strPlugs: String
 	//		A comma delineated list of the plugins to include in the Toolbar.
 	//		If "all" is used, all registered plugins are included.
 	strPlugs:"",
@@ -267,7 +267,7 @@ return dojo.declare("dojox.drawing.ui.Toolbar", [], {
 		//		Plugin click event. May be connected to.
 	},
 
-	_mixprops: function(/*Array*/props, /*Object | Node*/objNode){
+	_mixprops: function(/*Array*/ props, /*Object|Node*/ objNode){
 		// summary:
 		//		Internally used for mixing in props from an object or
 		//		from a dom node.

drawing/ui/dom/Pan.js

@@ -59,7 +59,7 @@ var Pan = oo.declare(
 			}
 		},
 
-		onSetPan: function(/*Boolean | Event*/ bool){
+		onSetPan: function(/*Boolean|Event*/ bool){
 			if(bool === true || bool === false){
 				this.selected = !bool;
 			}

geo/openlayers/Geometry.js

@@ -14,8 +14,8 @@ define([
 		//		an array of {x, y} objects
 		//		- A collection geometry of type dojox.geo.openlayers.Collection. Coordinates are an array of geometries.
 
-		// coordinates: {x, y} | Array 
-		//		The coordinates of the geometry.
+		// coordinates: Object|Array
+		//		The coordinates of the geometry, Object like {x, y} or Array.
 		coordinates : null,
 
 		// shape: [private] dojox/gfx/shape.Shape

geo/openlayers/_base.js

@@ -53,7 +53,7 @@ define(["dojo/_base/lang"], function(lang){
 		// toDecimal: Boolean
 		//		Specifies if the result should be returned in decimal degrees or in an array
 		//		containing the degrees, minutes, seconds values.
-		// returns: Float | Array
+		// returns: Float|Array
 		//		the parsed value in decimal degrees or an array containing the degrees, minutes, seconds values.
 
 		var res = re.exec(v);

gfx3d/object.js

@@ -973,7 +973,7 @@ declare("dojox.gfx3d.Viewport", gfx.Group, {
 		return this.applyCameraRightTransform(matrix); // self
 	},
 
-	setLights: function(/* Array || Object */lights, /* Color? */ ambient,
+	setLights: function(/* Array|Object */lights, /* Color? */ ambient,
 		/* Color? */ specular){
 		// summary:
 		//		set the lights
@@ -998,7 +998,7 @@ declare("dojox.gfx3d.Viewport", gfx.Group, {
 	addLights: function(lights){
 		// summary:
 		//		add new light/lights to the viewport.
-		// lights: Array || light object
+		// lights: Array|Object
 		//		light object(s)
 		return this.setLights(this.lights.sources.concat(lights));
 	},

grid/LazyTreeGrid.js

@@ -342,15 +342,19 @@ var LazyTreeGrid = declare("dojox.grid.LazyTreeGrid", TreeGrid, {
 	//		and dojox.grid.TreeGrid also apply here
 	//
 	//		LazyTreeGrid does not support summary row/items aggregate due to the lazy-loading rationale.
+
 	_layoutClass: _LazyTreeLayout,
 	_size: 0,
-	// treeModel: dijit.tree.ForestStoreModel | dojox.grid.LazyTreeGridStoreModel
+
+	// treeModel: dijit/tree/.ForestStoreModel|dojox/grid/LazyTreeGridStoreModel
 	//		A tree store model object.
 	treeModel: null,
+
 	// defaultState: Object
 	//		Used to restore the state of LazyTreeGrid.
 	//		This object should ONLY be obtained from `LazyTreeGrid.getState()`.
 	defaultState: null,
+
 	// colSpans: Object
 	//		A json object that defines column span of each level rows.  Attributes:
 	//

grid/enhanced/_PluginManager.js

@@ -215,7 +215,7 @@ var _PluginManager = declare("dojox.grid.enhanced._PluginManager", null, {
 	getPluginClazz: function(clazz){
 		// summary:
 		//		Load target plugin which must be already required (require(..))
-		// clazz: class | String
+		// clazz: Class|String
 		//		Plugin class
 		if(lang.isFunction(clazz)){
 			return clazz;//return if it's already a clazz

grid/enhanced/plugins/CellMerge.js

@@ -60,7 +60,7 @@ var CellMerge = declare("dojox.grid.enhanced.plugins.CellMerge", _Plugin, {
 		//		The column index of the cell whose content should be used as the content of the merged cell.
 		//		It must be larger than or equal to the startColumnIndex, and less than or equal to the endColumnIndex.
 		//		If it is omitted, the content of the leading edge (left-most for ltr, right most for rtl) cell will be used.
-		// returns: Object | null
+		// returns: Object|null
 		//		A handler for the merged cells created by a call of this function.
 		//		This handler can be used later to unmerge cells using the function unmergeCells
 		//		If the merge is not valid, returns null;
@@ -73,7 +73,7 @@ var CellMerge = declare("dojox.grid.enhanced.plugins.CellMerge", _Plugin, {
 		if(item){
 			this._updateRows(item);
 		}
-		return item;
+		return item; // Object|null
 	},
 	unmergeCells: function(mergeHandler){
 		// summary:

grid/enhanced/plugins/Menu.js

@@ -41,7 +41,7 @@ var Menu = declare("dojox.grid.enhanced.plugins.Menu", _Plugin, {
 			}
 		}
 	},
-	_initMenu: function(/*String*/menuType, /*String | Widget(dijit.Menu)*/menu){
+	_initMenu: function(/*String*/ menuType, /*String|dijit/Menu*/ menu){
 		var g = this.grid;
 		if(!g[menuType]){//in case already created in _Grid.postCreate()
 			var m = this._getMenuWidget(menu);

grid/enhanced/plugins/Pagination.js

@@ -778,9 +778,9 @@ var Pagination = declare("dojox.grid.enhanced.plugins.Pagination", _Plugin, {
 	currentPageSize: function(size){
 		// summary:
 		//		Change the size of current page or return the current page size.
-		// size: Integer || null
+		// size: Integer|null
 		//		An integer identifying the number of rows per page. If the size
-		//		is an Infinity, all rows will be displayed; if an invalid value pssed
+		//		is an Infinity, all rows will be displayed; if an invalid value passed
 		//		in, the current page size will be returned.
 		// returns:
 		//		Current size of items per page.  

grid/enhanced/plugins/Printer.js

@@ -29,7 +29,7 @@ var Printer = declare("dojox.grid.enhanced.plugins.Printer", _Plugin, {
 		// title: String
 		//		A title of the printed page can be specified. Optional.
 		//		If given, it's shown in an <h1> tag at the top of the page.
-		// cssFiles: Array | String
+		// cssFiles: Array|String
 		//		CSS file paths. Optional.
 		//		Every row and column is given CSS classes, including:
 		//
@@ -39,8 +39,8 @@ var Printer = declare("dojox.grid.enhanced.plugins.Printer", _Plugin, {
 		//		- Row classes are for <thead> and <tbody> tags.
 		//		- Column classes are for <th> and <td> tags.
 		//		- Users can use these classes in the CSS files, but cannot define their own.
-		// writerArgs: Object (Association Array)
-		//		Arguments for TableWriter.
+		// writerArgs: Object
+		//		 Associative Array, arguments for TableWriter.
 		// fetchArgs: object?
 		//		Any arguments for store.fetch
 	},

grid/enhanced/plugins/Selector.js

@@ -280,10 +280,10 @@ var Selector = declare("dojox.grid.enhanced.plugins.Selector", _Plugin, {
 		//		public
 		// type: String
 		//		"row" or "col" or "cell"
-		// start: Integer | Object
+		// start: Integer|Object
 		//		If type is "row" or "col", this is the index of the starting row or column.
 		//		If type if "cell", this is the left-top cell of the range.
-		// end: Integer | Object
+		// end: Integer|Object
 		//		If type is "row" or "col", this is the index of the ending row or column.
 		//		If type if "cell", this is the right-bottom cell of the range.
 		this.grid._selectingRange = true;
@@ -324,8 +324,8 @@ var Selector = declare("dojox.grid.enhanced.plugins.Selector", _Plugin, {
 		// tag:
 		//		public
 		// toEnable: Boolean?
-		//		To enable or not. Optional.
-		// returns: Boolean | undefined
+		//		To enable or not.
+		// returns: Boolean|undefined
 		//		Enabled or not.
 		if(typeof toEnable != "undefined" && !this.isSelecting()){
 			this._enabled = !!toEnable;

grid/enhanced/plugins/_StoreLayer.js

@@ -5,7 +5,7 @@ define([
 	"dojo/_base/xhr"
 ], function(declare, array, lang, xhr){
 	// summary:
-	//		The dojo.data.api.Read API is powerful, but it's difficult to give the store some special commands before
+	//		The dojo/data/api/Read API is powerful, but it's difficult to give the store some special commands before
 	//		fetch, so that the store content can be temporarily modified or transformed, and acts as another store. The
 	//		parameter *query* or *queryOptions* in keywordArgs for *fetch* is not enough because:
 	//
@@ -340,7 +340,7 @@ define([
 				this.onCommandLoad("", userRequest);
 				this.originFetch(userRequest);
 			}
-			return userRequest;	//dojo.data.api.Request
+			return userRequest;	// dojo/data/api/Request
 		},
 		command: function(/* string */cmdName,/* (string|number|bool|...)? */cmdContent){
 			// summary:
@@ -368,7 +368,7 @@ define([
 			//		callback extension
 			// response: string
 			//		server response
-			// userRequest: [in|out] dojo.data.api.Request
+			// userRequest: [in|out] dojo/data/api/Request
 			//		The request object for *fetch*. You can modify this object according to the *response*
 			//		so as to change the behavior of *fetch*
 			this._onUserCommandLoad(this.__cmds, userRequest, response);

grid/enhanced/plugins/filter/FilterLayer.js

@@ -220,7 +220,7 @@ define([
 			//		Implement _StoreLayer._fetch
 			// tags:
 			//		private callback
-			// filterRequest: dojo.data.api.Request
+			// filterRequest: dojo/data/api/Request
 			//		The actual request used in store.fetch.
 			//		This function is called recursively to fill the result store items
 			//		until the user specified item count is reached. Only in recursive calls,

grid/enhanced/plugins/filter/_ConditionExpr.js

@@ -135,7 +135,7 @@ var _OperatorExpr = declare("dojox.grid.enhanced.plugins.filter._OperatorExpr",
 	//		An operator expression is a _ConditionExpr that represents an operation.
 	_name: "operator",
 
-	constructor: function(/* Array | operand1,operand2,... */){
+	constructor: function(/* Array|operand1,operand2,... */){
 		// summary:
 		//		The arguments are operands (or an array of operands, if the first argument
 		//		is an Array) of this operator, ordering from left to right.

image/Gallery.js

@@ -117,10 +117,10 @@ dojo.declare("dojox.image.Gallery",
 		// summary:
 		//		Sets the data store and request objects to read data from.
 		// dataStore:
-		//		An implementation of the dojo.data.api.Read API. This accesses the image
+		//		An implementation of the dojo/data/api/Read API. This accesses the image
 		//		data.
 		// request:
-		//		An implementation of the dojo.data.api.Request API. This specifies the
+		//		An implementation of the dojo/data/api/Request API. This specifies the
 		//		query and paging information to be used by the data store
 		// paramNames:
 		//		An object defining the names of the item attributes to fetch from the

image/SlideShow.js

@@ -73,7 +73,7 @@ dojo.declare("dojox.image.SlideShow",
 	fixedHeight: false,
 
 	// imageStore: Object
-	//	Implementation of the dojo.data.api.Read API, which provides data on the images
+	//	Implementation of the dojo/data/api/Read API, which provides data on the images
 	//	to be displayed.
 	imageStore: null,
 
@@ -107,7 +107,7 @@ dojo.declare("dojox.image.SlideShow",
 	_tmpImage: null,
 
 	// _request: Object
-	//	Implementation of the dojo.data.api.Request API, which defines the query
+	//	Implementation of the dojo/data/api/Request API, which defines the query
 	//	parameters for accessing the store.
 	_request: null,
 
@@ -150,10 +150,10 @@ dojo.declare("dojox.image.SlideShow",
 		// summary:
 		//		Sets the data store and request objects to read data from.
 		// dataStore:
-		//		An implementation of the dojo.data.api.Read API. This accesses the image
+		//		An implementation of the dojo/data/api/Read API. This accesses the image
 		//		data.
 		// request:
-		//		An implementation of the dojo.data.api.Request API. This specifies the
+		//		An implementation of the dojo/data/api/Request API. This specifies the
 		//		query and paging information to be used by the data store
 		// paramNames:
 		//		An object defining the names of the item attributes to fetch from the

image/ThumbnailPicker.js

@@ -215,10 +215,10 @@ dojo.declare("dojox.image.ThumbnailPicker",
 		// summary:
 		//		Sets the data store and request objects to read data from.
 		// dataStore:
-		//		An implementation of the dojo.data.api.Read API. This accesses the image
+		//		An implementation of the dojo/data/api/Read API. This accesses the image
 		//		data.
 		// request:
-		//		An implementation of the dojo.data.api.Request API. This specifies the
+		//		An implementation of the dojo/data/api/Request API. This specifies the
 		//		query and paging information to be used by the data store
 		// paramNames:
 		//		An object defining the names of the item attributes to fetch from the

math/stats.js

@@ -22,7 +22,7 @@ define(["dojo", "../main"], function(dojo, dojox) {
 			return (squares/a.length)-Math.pow(mean/a.length, 2);	// Number
 		},
 
-		bestFit: function(/* Object[] || Number[] */a, /* String? */xProp, /* String? */yProp){
+		bestFit: function(/* Object[]|Number[] */ a, /* String? */ xProp, /* String? */ yProp){
 			// summary:
 			//		Calculate the slope and intercept in a linear fashion.  An array
 			//		of objects is expected; optionally you can pass in the property
@@ -75,7 +75,7 @@ define(["dojo", "../main"], function(dojo, dojox) {
 			};
 		},
 
-		forecast: function(/* Object[] || Number[] */a, /* Number */x, /* String? */xProp, /* String? */yProp){
+		forecast: function(/* Object[]|Number[] */a, /* Number */x, /* String? */xProp, /* String? */yProp){
 			// summary:
 			//		Using the bestFit algorithm above, find y for the given x.
 			var fit = st.bestFit(a, xProp, yProp);

timing/ThreadPool.js

@@ -73,7 +73,7 @@ define(["./_base"], function(){
 		this.getMaxThreads=function(){ return maxThreads; };
 		this.getAvailableThreads=function(){ return availableThreads; };
 		this.getTickInterval=function(){ return interval; };
-		this.queueUserWorkItem=function(/* Function || dojox.timing.Thread */fn){
+		this.queueUserWorkItem=function(/* Function|dojox/timing/Thread */fn){
 			var item=fn;
 			if(item instanceof Function){
 				item=new t.Thread(item);
@@ -92,7 +92,7 @@ define(["./_base"], function(){
 			}
 			return true;
 		};
-		this.removeQueuedUserWorkItem=function(/* Function || dojox.timing.Thread */item){
+		this.removeQueuedUserWorkItem=function(/* Function|dojox/timing/Thread */item){
 			if(item instanceof Function){
 				var idx=-1;
 				for(var i=0; i<queue.length; i++){

validate/creditCard.js

@@ -84,7 +84,7 @@ validate.isValidCreditCardNumber = function(value, ccType){
 			results.push(p);
 		}
 	}
-	return results.length ? results.join('|') : false; // String | boolean
+	return results.length ? results.join('|') : false; // String|Boolean
 };
 
 validate.isValidCvv = function(/* String|Int */value, /* String */ccType) {