Index: openacs-4/packages/ajaxhelper/www/resources/yui/container/container-debug.js
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/ajaxhelper/www/resources/yui/container/container-debug.js,v
diff -u -r1.1 -r1.2
--- openacs-4/packages/ajaxhelper/www/resources/yui/container/container-debug.js	21 Oct 2006 06:14:57 -0000	1.1
+++ openacs-4/packages/ajaxhelper/www/resources/yui/container/container-debug.js	25 Dec 2006 16:40:01 -0000	1.2
@@ -2,13 +2,15 @@
 Copyright (c) 2006, Yahoo! Inc. All rights reserved.
 Code licensed under the BSD License:
 http://developer.yahoo.net/yui/license.txt
-Version 0.11.3
+version 0.12.1
 */
 
 /**
-* Config is a utility used within an object to allow the implementer to maintain a list of local configuration properties and listen for changes to those properties dynamically using CustomEvent. The initial values are also maintained so that the configuration can be reset at any given point to its initial state.
-* @param {object}	owner	The owner object to which this Config object belongs
+* Config is a utility used within an Object to allow the implementer to maintain a list of local configuration properties and listen for changes to those properties dynamically using CustomEvent. The initial values are also maintained so that the configuration can be reset at any given point to its initial state.
+* @namespace YAHOO.util
+* @class Config
 * @constructor
+* @param {Object}	owner	The owner Object to which this Config Object belongs
 */
 YAHOO.util.Config = function(owner) {
 	if (owner) {
@@ -19,116 +21,28 @@
 };
 
 YAHOO.util.Config.prototype = {
-	
+
 	/**
-	* Object reference to the owner of this Config object
-	* @type object
+	* Object reference to the owner of this Config Object
+	* @property owner
+	* @type Object
 	*/
 	owner : null,
 
 	/**
-	* Object reference to the owner of this Config object
-	* args: key, value
-	* @type YAHOO.util.CustomEvent
-	*/
-	configChangedEvent : null,
-
-	/**
 	* Boolean flag that specifies whether a queue is currently being executed
-	* @type boolean
+	* @property queueInProgress
+	* @type Boolean
 	*/
 	queueInProgress : false,
 
-	/**
-	* Adds a property to the Config object's private config hash. 
-	* @param {string}	key	The configuration property's name
-	* @param {object}	propertyObject	The object containing all of this property's arguments
-	*/
-	addProperty : function(key, propertyObject){},
 
 	/**
-	* Returns a key-value configuration map of the values currently set in the Config object.
-	* @return {object} The current config, represented in a key-value map
+	* Validates that the value passed in is a Boolean.
+	* @method checkBoolean
+	* @param	{Object}	val	The value to validate
+	* @return	{Boolean}	true, if the value is valid
 	*/
-	getConfig : function(){},
-
-	/**
-	* Returns the value of specified property.
-	* @param {key}		The name of the property
-	* @return {object}	The value of the specified property
-	*/
-	getProperty : function(key){},
-
-	/**
-	* Resets the specified property's value to its initial value.
-	* @param {key}		The name of the property
-	*/
-	resetProperty : function(key){},
-
-	/**
-	* Sets the value of a property. If the silent property is passed as true, the property's event will not be fired.
-	* @param {key}		The name of the property
-	* @param {value}	The value to set the property to
-	* @param {boolean}	Whether the value should be set silently, without firing the property event.
-	* @return {boolean}	true, if the set was successful, false if it failed.
-	*/
-	setProperty : function(key,value,silent){},
-
-	/**
-	* Sets the value of a property and queues its event to execute. If the event is already scheduled to execute, it is
-	* moved from its current position to the end of the queue.
-	* @param {key}		The name of the property
-	* @param {value}	The value to set the property to
-	* @return {boolean}	true, if the set was successful, false if it failed.
-	*/	
-	queueProperty : function(key,value){},
-
-	/**
-	* Fires the event for a property using the property's current value.
-	* @param {key}		The name of the property
-	*/
-	refireEvent : function(key){},
-
-	/**
-	* Applies a key-value object literal to the configuration, replacing any existing values, and queueing the property events.
-	* Although the values will be set, fireQueue() must be called for their associated events to execute.
-	* @param {object}	userConfig	The configuration object literal
-	* @param {boolean}	init		When set to true, the initialConfig will be set to the userConfig passed in, so that calling a reset will reset the properties to the passed values.
-	*/
-	applyConfig : function(userConfig,init){},
-
-	/**
-	* Refires the events for all configuration properties using their current values.
-	*/
-	refresh : function(){},
-
-	/**
-	* Fires the normalized list of queued property change events
-	*/
-	fireQueue : function(){},
-
-	/**
-	* Subscribes an external handler to the change event for any given property. 
-	* @param {string}	key			The property name
-	* @param {Function}	handler		The handler function to use subscribe to the property's event
-	* @param {object}	obj			The object to use for scoping the event handler (see CustomEvent documentation)
-	* @param {boolean}	override	Optional. If true, will override "this" within the handler to map to the scope object passed into the method.
-	*/	
-	subscribeToConfigEvent : function(key,handler,obj,override){},
-
-	/**
-	* Unsubscribes an external handler from the change event for any given property. 
-	* @param {string}	key			The property name
-	* @param {Function}	handler		The handler function to use subscribe to the property's event
-	* @param {object}	obj			The object to use for scoping the event handler (see CustomEvent documentation)
-	*/
-	unsubscribeFromConfigEvent: function(key,handler,obj){},
-
-	/**
-	* Validates that the value passed in is a boolean.
-	* @param	{object}	val	The value to validate
-	* @return	{boolean}	true, if the value is valid
-	*/	
 	checkBoolean: function(val) {
 		if (typeof val == 'boolean') {
 			return true;
@@ -139,8 +53,9 @@
 
 	/**
 	* Validates that the value passed in is a number.
-	* @param	{object}	val	The value to validate
-	* @return	{boolean}	true, if the value is valid
+	* @method checkNumber
+	* @param	{Object}	val	The value to validate
+	* @return	{Boolean}	true, if the value is valid
 	*/
 	checkNumber: function(val) {
 		if (isNaN(val)) {
@@ -153,43 +68,77 @@
 
 
 /**
-* Initializes the configuration object and all of its local members.
-* @param {object}	owner	The owner object to which this Config object belongs
+* Initializes the configuration Object and all of its local members.
+* @method init
+* @param {Object}	owner	The owner Object to which this Config Object belongs
 */
 YAHOO.util.Config.prototype.init = function(owner) {
 
 	this.owner = owner;
+
+	/**
+	* Object reference to the owner of this Config Object
+	* @event configChangedEvent
+	*/
 	this.configChangedEvent = new YAHOO.util.CustomEvent("configChanged");
 	this.queueInProgress = false;
 
 	/* Private Members */
 
+	/**
+	* Maintains the local collection of configuration property objects and their specified values
+	* @property config
+	* @private
+	* @type Object
+	*/
 	var config = {};
+
+	/**
+	* Maintains the local collection of configuration property objects as they were initially applied.
+	* This object is used when resetting a property.
+	* @property initialConfig
+	* @private
+	* @type Object
+	*/
 	var initialConfig = {};
+
+	/**
+	* Maintains the local, normalized CustomEvent queue
+	* @property eventQueue
+	* @private
+	* @type Object
+	*/
 	var eventQueue = [];
 
 	/**
+	* Fires a configuration property event using the specified value.
+	* @method fireEvent
 	* @private
-	* Fires a configuration property event using the specified value. 
-	* @param {string}	key			The configuration property's name
-	* @param {value}	object		The value of the correct type for the property
-	*/ 
+	* @param {String}	key			The configuration property's name
+	* @param {value}	Object		The value of the correct type for the property
+	*/
 	var fireEvent = function( key, value ) {
 		YAHOO.log("Firing Config event: " + key + "=" + value, "info");
-		
+
 		key = key.toLowerCase();
 
 		var property = config[key];
 
 		if (typeof property != 'undefined' && property.event) {
 			property.event.fire(value);
-		}	
+		}
 	};
 	/* End Private Members */
 
+	/**
+	* Adds a property to the Config Object's private config hash.
+	* @method addProperty
+	* @param {String}	key	The configuration property's name
+	* @param {Object}	propertyObject	The Object containing all of this property's arguments
+	*/
 	this.addProperty = function( key, propertyObject ) {
 		key = key.toLowerCase();
-		
+
 		YAHOO.log("Added property: " + key, "info");
 
 		config[key] = propertyObject;
@@ -202,25 +151,36 @@
 		}
 
 		this.setProperty(key, propertyObject.value, true);
-		
+
 		if (! propertyObject.suppressEvent) {
 			this.queueProperty(key, propertyObject.value);
 		}
 	};
 
+	/**
+	* Returns a key-value configuration map of the values currently set in the Config Object.
+	* @method getConfig
+	* @return {Object} The current config, represented in a key-value map
+	*/
 	this.getConfig = function() {
 		var cfg = {};
-			
+
 		for (var prop in config) {
 			var property = config[prop];
 			if (typeof property != 'undefined' && property.event) {
 				cfg[prop] = property.value;
 			}
 		}
-		
+
 		return cfg;
 	};
 
+	/**
+	* Returns the value of specified property.
+	* @method getProperty
+	* @param {String} key	The name of the property
+	* @return {Object}		The value of the specified property
+	*/
 	this.getProperty = function(key) {
 		key = key.toLowerCase();
 
@@ -232,24 +192,41 @@
 		}
 	};
 
+	/**
+	* Resets the specified property's value to its initial value.
+	* @method resetProperty
+	* @param {String} key	The name of the property
+	* @return {Boolean} True is the property was reset, false if not
+	*/
 	this.resetProperty = function(key) {
 		key = key.toLowerCase();
 
 		var property = config[key];
 		if (typeof property != 'undefined' && property.event) {
-			this.setProperty(key, initialConfig[key].value);
+			if (initialConfig[key] && initialConfig[key] != 'undefined')	{
+				this.setProperty(key, initialConfig[key]);
+			}
+			return true;
 		} else {
-			return undefined;
+			return false;
 		}
 	};
 
+	/**
+	* Sets the value of a property. If the silent property is passed as true, the property's event will not be fired.
+	* @method setProperty
+	* @param {String} key		The name of the property
+	* @param {String} value		The value to set the property to
+	* @param {Boolean} silent	Whether the value should be set silently, without firing the property event.
+	* @return {Boolean}			True, if the set was successful, false if it failed.
+	*/
 	this.setProperty = function(key, value, silent) {
 		key = key.toLowerCase();
-		
+
 		YAHOO.log("setProperty: " + key + "=" + value, "info");
 
 		if (this.queueInProgress && ! silent) {
-			this.queueProperty(key,value); // Currently running through a queue... 
+			this.queueProperty(key,value); // Currently running through a queue...
 			return true;
 		} else {
 			var property = config[key];
@@ -270,13 +247,21 @@
 		}
 	};
 
+	/**
+	* Sets the value of a property and queues its event to execute. If the event is already scheduled to execute, it is
+	* moved from its current position to the end of the queue.
+	* @method queueProperty
+	* @param {String} key	The name of the property
+	* @param {String} value	The value to set the property to
+	* @return {Boolean}		true, if the set was successful, false if it failed.
+	*/
 	this.queueProperty = function(key, value) {
 		key = key.toLowerCase();
 
 		YAHOO.log("queueProperty: " + key + "=" + value, "info");
 
 		var property = config[key];
-							
+
 		if (typeof property != 'undefined' && property.event) {
 			if (typeof value != 'undefined' && property.validator && ! property.validator(value)) { // validator
 				return false;
@@ -296,7 +281,7 @@
 					if (queueItem) {
 						var queueItemKey = queueItem[0];
 						var queueItemValue = queueItem[1];
-						
+
 						if (queueItemKey.toLowerCase() == key) {
 							// found a dupe... push to end of queue, null current item, and break
 							eventQueue[i] = null;
@@ -306,7 +291,7 @@
 						}
 					}
 				}
-				
+
 				if (! foundDuplicate && typeof value != 'undefined') { // this is a refire, or a new property in the queue
 					eventQueue.push([key, value]);
 				}
@@ -322,7 +307,7 @@
 						if (queueItemCheck) {
 							var queueItemCheckKey = queueItemCheck[0];
 							var queueItemCheckValue = queueItemCheck[1];
-							
+
 							if ( queueItemCheckKey.toLowerCase() == supercedesCheck.toLowerCase() ) {
 								eventQueue.push([queueItemCheckKey, queueItemCheckValue]);
 								eventQueue[q] = null;
@@ -332,7 +317,7 @@
 					}
 				}
 			}
-	
+
 			YAHOO.log("Config event queue: " + this.outputEventQueue(), "info");
 
 			return true;
@@ -341,6 +326,11 @@
 		}
 	};
 
+	/**
+	* Fires the event for a property using the property's current value.
+	* @method refireEvent
+	* @param {String} key	The name of the property
+	*/
 	this.refireEvent = function(key) {
 		key = key.toLowerCase();
 
@@ -354,6 +344,13 @@
 		}
 	};
 
+	/**
+	* Applies a key-value Object literal to the configuration, replacing any existing values, and queueing the property events.
+	* Although the values will be set, fireQueue() must be called for their associated events to execute.
+	* @method applyConfig
+	* @param {Object}	userConfig	The configuration Object literal
+	* @param {Boolean}	init		When set to true, the initialConfig will be set to the userConfig passed in, so that calling a reset will reset the properties to the passed values.
+	*/
 	this.applyConfig = function(userConfig, init) {
 		if (init) {
 			initialConfig = userConfig;
@@ -363,31 +360,48 @@
 		}
 	};
 
+	/**
+	* Refires the events for all configuration properties using their current values.
+	* @method refresh
+	*/
 	this.refresh = function() {
 		for (var prop in config) {
 			this.refireEvent(prop);
 		}
 	};
 
+	/**
+	* Fires the normalized list of queued property change events
+	* @method fireQueue
+	*/
 	this.fireQueue = function() {
 		this.queueInProgress = true;
 		for (var i=0;i<eventQueue.length;i++) {
 			var queueItem = eventQueue[i];
 			if (queueItem) {
 				var key = queueItem[0];
 				var value = queueItem[1];
-				
+
 				var property = config[key];
 				property.value = value;
 
 				fireEvent(key,value);
 			}
 		}
-		
+
 		this.queueInProgress = false;
 		eventQueue = [];
 	};
 
+	/**
+	* Subscribes an external handler to the change event for any given property.
+	* @method subscribeToConfigEvent
+	* @param {String}	key			The property name
+	* @param {Function}	handler		The handler function to use subscribe to the property's event
+	* @param {Object}	obj			The Object to use for scoping the event handler (see CustomEvent documentation)
+	* @param {Boolean}	override	Optional. If true, will override "this" within the handler to map to the scope Object passed into the method.
+	* @return {Boolean}				True, if the subscription was successful, otherwise false.
+	*/
 	this.subscribeToConfigEvent = function(key, handler, obj, override) {
 		key = key.toLowerCase();
 
@@ -402,7 +416,14 @@
 		}
 	};
 
-
+	/**
+	* Unsubscribes an external handler from the change event for any given property.
+	* @method unsubscribeFromConfigEvent
+	* @param {String}	key			The property name
+	* @param {Function}	handler		The handler function to use subscribe to the property's event
+	* @param {Object}	obj			The Object to use for scoping the event handler (see CustomEvent documentation)
+	* @return {Boolean}				True, if the unsubscription was successful, otherwise false.
+	*/
 	this.unsubscribeFromConfigEvent = function(key, handler, obj) {
 		key = key.toLowerCase();
 
@@ -414,6 +435,11 @@
 		}
 	};
 
+	/**
+	* Returns a string representation of the Config object
+	* @method toString
+	* @return {String}	The Config object in string format.
+	*/
 	this.toString = function() {
 		var output = "Config";
 		if (this.owner) {
@@ -422,6 +448,11 @@
 		return output;
 	};
 
+	/**
+	* Returns a string representation of the Config object's current CustomEvent queue
+	* @method outputEventQueue
+	* @return {String}	The string list of CustomEvents currently queued for execution
+	*/
 	this.outputEventQueue = function() {
 		var output = "";
 		for (var q=0;q<eventQueue.length;q++) {
@@ -435,11 +466,13 @@
 };
 
 /**
-* Checks to determine if a particular function/object pair are already subscribed to the specified CustomEvent
+* Checks to determine if a particular function/Object pair are already subscribed to the specified CustomEvent
+* @method YAHOO.util.Config.alreadySubscribed
+* @static
 * @param {YAHOO.util.CustomEvent} evt	The CustomEvent for which to check the subscriptions
 * @param {Function}	fn	The function to look for in the subscribers list
-* @param {object}	obj	The execution scope object for the subscription
-* @return {boolean}	true, if the function/object pair is already subscribed to the CustomEvent passed in
+* @param {Object}	obj	The execution scope Object for the subscription
+* @return {Boolean}	true, if the function/Object pair is already subscribed to the CustomEvent passed in
 */
 YAHOO.util.Config.alreadySubscribed = function(evt, fn, obj) {
 	for (var e=0;e<evt.subscribers.length;e++) {
@@ -452,244 +485,249 @@
 };
 
 /**
+*  The Container family of components is designed to enable developers to create different kinds of content-containing modules on the web. Module and Overlay are the most basic containers, and they can be used directly or extended to build custom containers. Also part of the Container family are four UI controls that extend Module and Overlay: Tooltip, Panel, Dialog, and SimpleDialog.
+* @module container
+* @title Container
+* @requires yahoo,dom,event,dragdrop,animation
+*/
+
+/**
 * Module is a JavaScript representation of the Standard Module Format. Standard Module Format is a simple standard for markup containers where child nodes representing the header, body, and footer of the content are denoted using the CSS classes "hd", "bd", and "ft" respectively. Module is the base class for all other classes in the YUI Container package.
-* @param {string}	el	The element ID representing the Module <em>OR</em>
-* @param {Element}	el	The element representing the Module
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this module. See configuration documentation for more details.
+* @namespace YAHOO.widget
+* @class Module
 * @constructor
+* @param {String} el			The element ID representing the Module <em>OR</em>
+* @param {HTMLElement} el		The element representing the Module
+* @param {Object} userConfig	The configuration Object literal containing the configuration that should be set for this module. See configuration documentation for more details.
 */
 YAHOO.widget.Module = function(el, userConfig) {
-	if (el) { 
-		this.init(el, userConfig); 
+	if (el) {
+		this.init(el, userConfig);
 	} else {
 		YAHOO.log("No element or element ID specified for Module instantiation", "error");
 	}
 };
 
 /**
 * Constant representing the prefix path to use for non-secure images
-* @type string
+* @property YAHOO.widget.Module.IMG_ROOT
+* @static
+* @final
+* @type String
 */
 YAHOO.widget.Module.IMG_ROOT = "http://us.i1.yimg.com/us.yimg.com/i/";
 
 /**
 * Constant representing the prefix path to use for securely served images
-* @type string
+* @property YAHOO.widget.Module.IMG_ROOT_SSL
+* @static
+* @final
+* @type String
 */
 YAHOO.widget.Module.IMG_ROOT_SSL = "https://a248.e.akamai.net/sec.yimg.com/i/";
 
 /**
 * Constant for the default CSS class name that represents a Module
-* @type string
+* @property YAHOO.widget.Module.CSS_MODULE
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Module.CSS_MODULE = "module";
 
 /**
 * Constant representing the module header
-* @type string
+* @property YAHOO.widget.Module.CSS_HEADER
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Module.CSS_HEADER = "hd";
 
 /**
 * Constant representing the module body
-* @type string
+* @property YAHOO.widget.Module.CSS_BODY
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Module.CSS_BODY = "bd";
 
 /**
 * Constant representing the module footer
-* @type string
+* @property YAHOO.widget.Module.CSS_FOOTER
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Module.CSS_FOOTER = "ft";
 
 /**
 * Constant representing the url for the "src" attribute of the iframe used to monitor changes to the browser's base font size
-* @type string
+* @property YAHOO.widget.Module.RESIZE_MONITOR_SECURE_URL
+* @static
 * @final
+* @type String
 */
-YAHOO.widget.Module.RESIZE_MONITOR_SECURE_URL = "javascript:false";
+YAHOO.widget.Module.RESIZE_MONITOR_SECURE_URL = "javascript:false;";
 
-YAHOO.widget.Module.prototype = {
+/**
+* Singleton CustomEvent fired when the font size is changed in the browser.
+* Opera's "zoom" functionality currently does not support text size detection.
+* @event YAHOO.widget.Module.textResizeEvent
+*/
+YAHOO.widget.Module.textResizeEvent = new YAHOO.util.CustomEvent("textResize");
 
+YAHOO.widget.Module.prototype = {
 	/**
 	* The class's constructor function
-	* @type function
+	* @property contructor
+	* @type Function
 	*/
 	constructor : YAHOO.widget.Module,
 
 	/**
 	* The main module element that contains the header, body, and footer
-	* @type Element
+	* @property element
+	* @type HTMLElement
 	*/
-	element : null, 
+	element : null,
 
 	/**
 	* The header element, denoted with CSS class "hd"
-	* @type Element
+	* @property header
+	* @type HTMLElement
 	*/
 	header : null,
 
 	/**
 	* The body element, denoted with CSS class "bd"
-	* @type Element
+	* @property body
+	* @type HTMLElement
 	*/
 	body : null,
 
 	/**
 	* The footer element, denoted with CSS class "ft"
-	* @type Element
+	* @property footer
+	* @type HTMLElement
 	*/
 	footer : null,
 
 	/**
 	* The id of the element
-	* @type string
+	* @property id
+	* @type String
 	*/
 	id : null,
 
 	/**
-	* Array of elements
-	* @type Element[]
+	* The String representing the image root
+	* @property imageRoot
+	* @type String
 	*/
-	childNodesInDOM : null,
-
-	/**
-	* The string representing the image root
-	* @type string
-	*/
 	imageRoot : YAHOO.widget.Module.IMG_ROOT,
 
 	/**
-	* CustomEvent fired prior to class initalization.
-	* args: class reference of the initializing class, such as this.beforeInitEvent.fire(YAHOO.widget.Module)
-	* @type YAHOO.util.CustomEvent
+	* Initializes the custom events for Module which are fired automatically at appropriate times by the Module class.
+	* @method initEvents
 	*/
-	beforeInitEvent : null,
+	initEvents : function() {
 
-	/**
-	* CustomEvent fired after class initalization.
-	* args: class reference of the initializing class, such as this.initEvent.fire(YAHOO.widget.Module)
-	* @type YAHOO.util.CustomEvent
-	*/
-	initEvent : null,
+		/**
+		* CustomEvent fired prior to class initalization.
+		* @event beforeInitEvent
+		* @param {class} classRef	class reference of the initializing class, such as this.beforeInitEvent.fire(YAHOO.widget.Module)
+		*/
+		this.beforeInitEvent = new YAHOO.util.CustomEvent("beforeInit");
 
-	/**
-	* CustomEvent fired when the Module is appended to the DOM
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	appendEvent : null,
+		/**
+		* CustomEvent fired after class initalization.
+		* @event initEvent
+		* @param {class} classRef	class reference of the initializing class, such as this.beforeInitEvent.fire(YAHOO.widget.Module)
+		*/
+		this.initEvent = new YAHOO.util.CustomEvent("init");
 
-	/**
-	* CustomEvent fired before the Module is rendered
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	beforeRenderEvent : null,
+		/**
+		* CustomEvent fired when the Module is appended to the DOM
+		* @event appendEvent
+		*/
+		this.appendEvent = new YAHOO.util.CustomEvent("append");
 
-	/**
-	* CustomEvent fired after the Module is rendered
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	renderEvent : null,
+		/**
+		* CustomEvent fired before the Module is rendered
+		* @event beforeRenderEvent
+		*/
+		this.beforeRenderEvent = new YAHOO.util.CustomEvent("beforeRender");
 
-	/**
-	* CustomEvent fired when the header content of the Module is modified
-	* args: string/element representing the new header content
-	* @type YAHOO.util.CustomEvent
-	*/
-	changeHeaderEvent : null,
+		/**
+		* CustomEvent fired after the Module is rendered
+		* @event renderEvent
+		*/
+		this.renderEvent = new YAHOO.util.CustomEvent("render");
 
-	/**
-	* CustomEvent fired when the body content of the Module is modified
-	* args: string/element representing the new body content
-	* @type YAHOO.util.CustomEvent
-	*/
-	changeBodyEvent : null,
+		/**
+		* CustomEvent fired when the header content of the Module is modified
+		* @event changeHeaderEvent
+		* @param {String/HTMLElement} content	String/element representing the new header content
+		*/
+		this.changeHeaderEvent = new YAHOO.util.CustomEvent("changeHeader");
 
-	/**
-	* CustomEvent fired when the footer content of the Module is modified
-	* args: string/element representing the new footer content
-	* @type YAHOO.util.CustomEvent
-	*/
-	changeFooterEvent : null,
+		/**
+		* CustomEvent fired when the body content of the Module is modified
+		* @event changeBodyEvent
+		* @param {String/HTMLElement} content	String/element representing the new body content
+		*/
+		this.changeBodyEvent = new YAHOO.util.CustomEvent("changeBody");
 
-	/**
-	* CustomEvent fired when the content of the Module is modified
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	changeContentEvent : null,
+		/**
+		* CustomEvent fired when the footer content of the Module is modified
+		* @event changeFooterEvent
+		* @param {String/HTMLElement} content	String/element representing the new footer content
+		*/
+		this.changeFooterEvent = new YAHOO.util.CustomEvent("changeFooter");
 
-	/**
-	* CustomEvent fired when the Module is destroyed
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	destroyEvent : null,
+		/**
+		* CustomEvent fired when the content of the Module is modified
+		* @event changeContentEvent
+		*/
+		this.changeContentEvent = new YAHOO.util.CustomEvent("changeContent");
 
-	/**
-	* CustomEvent fired before the Module is shown
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	beforeShowEvent : null,
+		/**
+		* CustomEvent fired when the Module is destroyed
+		* @event destroyEvent
+		*/
+		this.destroyEvent = new YAHOO.util.CustomEvent("destroy");
 
-	/**
-	* CustomEvent fired after the Module is shown
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	showEvent : null,
+		/**
+		* CustomEvent fired before the Module is shown
+		* @event beforeShowEvent
+		*/
+		this.beforeShowEvent = new YAHOO.util.CustomEvent("beforeShow");
 
-	/**
-	* CustomEvent fired before the Module is hidden
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	beforeHideEvent : null,
-	
-	/**
-	* CustomEvent fired after the Module is hidden
-	* args: none
-	* @type YAHOO.util.CustomEvent
-	*/
-	hideEvent : null,
-		
-	/**
-	* Initializes the custom events for Module which are fired automatically at appropriate times by the Module class.
-	*/
-	initEvents : function() {
+		/**
+		* CustomEvent fired after the Module is shown
+		* @event showEvent
+		*/
+		this.showEvent = new YAHOO.util.CustomEvent("show");
 
-		this.beforeInitEvent		= new YAHOO.util.CustomEvent("beforeInit");
-		this.initEvent				= new YAHOO.util.CustomEvent("init");
+		/**
+		* CustomEvent fired before the Module is hidden
+		* @event beforeHideEvent
+		*/
+		this.beforeHideEvent = new YAHOO.util.CustomEvent("beforeHide");
 
-		this.appendEvent			= new YAHOO.util.CustomEvent("append");
+		/**
+		* CustomEvent fired after the Module is hidden
+		* @event hideEvent
+		*/
+		this.hideEvent = new YAHOO.util.CustomEvent("hide");
+	},
 
-		this.beforeRenderEvent		= new YAHOO.util.CustomEvent("beforeRender");
-		this.renderEvent			= new YAHOO.util.CustomEvent("render");
-
-		this.changeHeaderEvent		= new YAHOO.util.CustomEvent("changeHeader");
-		this.changeBodyEvent		= new YAHOO.util.CustomEvent("changeBody");
-		this.changeFooterEvent		= new YAHOO.util.CustomEvent("changeFooter");
-
-		this.changeContentEvent		= new YAHOO.util.CustomEvent("changeContent");
-
-		this.destroyEvent			= new YAHOO.util.CustomEvent("destroy");
-		this.beforeShowEvent		= new YAHOO.util.CustomEvent("beforeShow");
-		this.showEvent				= new YAHOO.util.CustomEvent("show");
-		this.beforeHideEvent		= new YAHOO.util.CustomEvent("beforeHide");
-		this.hideEvent				= new YAHOO.util.CustomEvent("hide");
-	}, 
-
 	/**
 	* String representing the current user-agent platform
-	* @type string
+	* @property platform
+	* @type String
 	*/
 	platform : function() {
 					var ua = navigator.userAgent.toLowerCase();
@@ -704,7 +742,8 @@
 
 	/**
 	* String representing the current user-agent browser
-	* @type string
+	* @property browser
+	* @type String
 	*/
 	browser : function() {
 			var ua = navigator.userAgent.toLowerCase();
@@ -725,7 +764,8 @@
 
 	/**
 	* Boolean representing whether or not the current browsing context is secure (https)
-	* @type boolean
+	* @property isSecure
+	* @type Boolean
 	*/
 	isSecure : function() {
 		if (window.location.href.toLowerCase().indexOf("https") === 0) {
@@ -741,25 +781,51 @@
 	initDefaultConfig : function() {
 		// Add properties //
 
+		/**
+		* Specifies whether the Module is visible on the page.
+		* @config visible
+		* @type Boolean
+		* @default true
+		*/
 		this.cfg.addProperty("visible", { value:true, handler:this.configVisible, validator:this.cfg.checkBoolean } );
+
+		/**
+		* Object or array of objects representing the ContainerEffect classes that are active for animating the container.
+		* @config effect
+		* @type Object
+		* @default null
+		*/
 		this.cfg.addProperty("effect", { suppressEvent:true, supercedes:["visible"] } );
+
+		/**
+		* Specifies whether to create a special proxy iframe to monitor for user font resizing in the document
+		* @config monitorresize
+		* @type Boolean
+		* @default true
+		*/
 		this.cfg.addProperty("monitorresize", { value:true, handler:this.configMonitorResize } );
 	},
 
 	/**
 	* The Module class's initialization method, which is executed for Module and all of its subclasses. This method is automatically called by the constructor, and  sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.
-	* @param {string}	el	The element ID representing the Module <em>OR</em>
-	* @param {Element}	el	The element representing the Module
-	* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this module. See configuration documentation for more details.
+	* @method init
+	* @param {String}	el	The element ID representing the Module <em>OR</em>
+	* @param {HTMLElement}	el	The element representing the Module
+	* @param {Object}	userConfig	The configuration Object literal containing the configuration that should be set for this module. See configuration documentation for more details.
 	*/
 	init : function(el, userConfig) {
 
 		this.initEvents();
 
 		this.beforeInitEvent.fire(YAHOO.widget.Module);
 
+		/**
+		* The Module's Config object used for monitoring configuration properties.
+		* @property cfg
+		* @type YAHOO.util.Config
+		*/
 		this.cfg = new YAHOO.util.Config(this);
-		
+
 		if (this.isSecure) {
 			this.imageRoot = YAHOO.widget.Module.IMG_ROOT_SSL;
 		}
@@ -775,10 +841,10 @@
 		}
 
 		this.element = el;
-		
+
 		if (el.id) {
 			this.id = el.id;
-		} 
+		}
 
 		var childNodes = this.element.childNodes;
 
@@ -817,96 +883,111 @@
 	},
 
 	/**
-	* Initialized an empty DOM element that is placed out of the visible area that can be used to detect text resize.
+	* Initialized an empty IFRAME that is placed out of the visible area that can be used to detect text resize.
+	* @method initResizeMonitor
 	*/
 	initResizeMonitor : function() {
 
         if(this.browser != "opera") {
 
             var resizeMonitor = document.getElementById("_yuiResizeMonitor");
-    
+
             if (! resizeMonitor) {
-    
+
                 resizeMonitor = document.createElement("iframe");
-    
+
                 var bIE = (this.browser.indexOf("ie") === 0);
-    
-                if(this.isSecure && 
-                   YAHOO.widget.Module.RESIZE_MONITOR_SECURE_URL && 
+
+                if(this.isSecure &&
+                   YAHOO.widget.Module.RESIZE_MONITOR_SECURE_URL &&
                    bIE) {
-    
-                  resizeMonitor.src = 
+
+                  resizeMonitor.src =
                        YAHOO.widget.Module.RESIZE_MONITOR_SECURE_URL;
-    
-                }                
 
+                }
+
                 resizeMonitor.id = "_yuiResizeMonitor";
                 resizeMonitor.style.visibility = "hidden";
-                
+
                 document.body.appendChild(resizeMonitor);
-    
+
                 resizeMonitor.style.width = "10em";
                 resizeMonitor.style.height = "10em";
                 resizeMonitor.style.position = "absolute";
-                
+
                 var nLeft = -1 * resizeMonitor.offsetWidth,
                     nTop = -1 * resizeMonitor.offsetHeight;
-    
+
                 resizeMonitor.style.top = nTop + "px";
                 resizeMonitor.style.left =  nLeft + "px";
                 resizeMonitor.style.borderStyle = "none";
                 resizeMonitor.style.borderWidth = "0";
                 YAHOO.util.Dom.setStyle(resizeMonitor, "opacity", "0");
-                
+
                 resizeMonitor.style.visibility = "visible";
-    
+
                 if(!bIE) {
-    
+
                     var doc = resizeMonitor.contentWindow.document;
-    
+
                     doc.open();
                     doc.close();
-                
+
                 }
-    
             }
-    
+
+			var fireTextResize = function() {
+				YAHOO.widget.Module.textResizeEvent.fire();
+			};
+
             if(resizeMonitor && resizeMonitor.contentWindow) {
-    
                 this.resizeMonitor = resizeMonitor;
-    
-                YAHOO.util.Event.addListener(this.resizeMonitor.contentWindow, "resize", this.onDomResize, this, true);
-    
+
+				YAHOO.widget.Module.textResizeEvent.subscribe(this.onDomResize, this, true);
+
+				if (! YAHOO.widget.Module.textResizeInitialized) {
+					if (! YAHOO.util.Event.addListener(this.resizeMonitor.contentWindow, "resize", fireTextResize)) {
+						// This will fail in IE if document.domain has changed, so we must change the listener to
+						// use the resizeMonitor element instead
+						YAHOO.util.Event.addListener(this.resizeMonitor, "resize", fireTextResize);
+					}
+					YAHOO.widget.Module.textResizeInitialized = true;
+				}
             }
-        
+
         }
 
 	},
 
 	/**
 	* Event handler fired when the resize monitor element is resized.
+	* @method onDomResize
+	* @param {DOMEvent} e	The DOM resize event
+	* @param {Object} obj	The scope object passed to the handler
 	*/
-	onDomResize : function(e, obj) { 
+	onDomResize : function(e, obj) {
 
         var nLeft = -1 * this.resizeMonitor.offsetWidth,
             nTop = -1 * this.resizeMonitor.offsetHeight;
-        
+
         this.resizeMonitor.style.top = nTop + "px";
         this.resizeMonitor.style.left =  nLeft + "px";
-	
+
 	},
 
 	/**
 	* Sets the Module's header content to the HTML specified, or appends the passed element to the header. If no header is present, one will be automatically created.
-	* @param {string}	headerContent	The HTML used to set the header <em>OR</em>
-	* @param {Element}	headerContent	The Element to append to the header
-	*/	
+	* @method setHeader
+	* @param {String}	headerContent	The HTML used to set the header <em>OR</em>
+	* @param {HTMLElement}	headerContent	The HTMLElement to append to the header
+	*/
 	setHeader : function(headerContent) {
 		if (! this.header) {
 			this.header = document.createElement("DIV");
 			this.header.className = YAHOO.widget.Module.CSS_HEADER;
 		}
-		
+
 		if (typeof headerContent == "string") {
 			this.header.innerHTML = headerContent;
 		} else {
@@ -920,24 +1001,26 @@
 
 	/**
 	* Appends the passed element to the header. If no header is present, one will be automatically created.
-	* @param {Element}	element	The element to append to the header
-	*/	
+	* @method appendToHeader
+	* @param {HTMLElement}	element	The element to append to the header
+	*/
 	appendToHeader : function(element) {
 		if (! this.header) {
 			this.header = document.createElement("DIV");
 			this.header.className = YAHOO.widget.Module.CSS_HEADER;
 		}
-		
+
 		this.header.appendChild(element);
 		this.changeHeaderEvent.fire(element);
 		this.changeContentEvent.fire();
 	},
 
 	/**
 	* Sets the Module's body content to the HTML specified, or appends the passed element to the body. If no body is present, one will be automatically created.
-	* @param {string}	bodyContent	The HTML used to set the body <em>OR</em>
-	* @param {Element}	bodyContent	The Element to append to the body
-	*/		
+	* @method setBody
+	* @param {String}	bodyContent	The HTML used to set the body <em>OR</em>
+	* @param {HTMLElement}	bodyContent	The HTMLElement to append to the body
+	*/
 	setBody : function(bodyContent) {
 		if (! this.body) {
 			this.body = document.createElement("DIV");
@@ -958,7 +1041,8 @@
 
 	/**
 	* Appends the passed element to the body. If no body is present, one will be automatically created.
-	* @param {Element}	element	The element to append to the body
+	* @method appendToBody
+	* @param {HTMLElement}	element	The element to append to the body
 	*/
 	appendToBody : function(element) {
 		if (! this.body) {
@@ -973,9 +1057,10 @@
 
 	/**
 	* Sets the Module's footer content to the HTML specified, or appends the passed element to the footer. If no footer is present, one will be automatically created.
-	* @param {string}	footerContent	The HTML used to set the footer <em>OR</em>
-	* @param {Element}	footerContent	The Element to append to the footer
-	*/	
+	* @method setFooter
+	* @param {String}	footerContent	The HTML used to set the footer <em>OR</em>
+	* @param {HTMLElement}	footerContent	The HTMLElement to append to the footer
+	*/
 	setFooter : function(footerContent) {
 		if (! this.footer) {
 			this.footer = document.createElement("DIV");
@@ -995,7 +1080,8 @@
 
 	/**
 	* Appends the passed element to the footer. If no footer is present, one will be automatically created.
-	* @param {Element}	element	The element to append to the footer
+	* @method appendToFooter
+	* @param {HTMLElement}	element	The element to append to the footer
 	*/
 	appendToFooter : function(element) {
 		if (! this.footer) {
@@ -1010,10 +1096,11 @@
 
 	/**
 	* Renders the Module by inserting the elements that are not already in the main Module into their correct places. Optionally appends the Module to the specified node prior to the render's execution. NOTE: For Modules without existing markup, the appendToNode argument is REQUIRED. If this argument is ommitted and the current element is not present in the document, the function will return false, indicating that the render was a failure.
-	* @param {string}	appendToNode	The element id to which the Module should be appended to prior to rendering <em>OR</em>
-	* @param {Element}	appendToNode	The element to which the Module should be appended to prior to rendering	
-	* @param {Element}	moduleElement	OPTIONAL. The element that represents the actual Standard Module container. 
-	* @return {boolean} Success or failure of the render
+	* @method render
+	* @param {String}	appendToNode	The element id to which the Module should be appended to prior to rendering <em>OR</em>
+	* @param {HTMLElement}	appendToNode	The element to which the Module should be appended to prior to rendering
+	* @param {HTMLElement}	moduleElement	OPTIONAL. The element that represents the actual Standard Module container.
+	* @return {Boolean} Success or failure of the render
 	*/
 	render : function(appendToNode, moduleElement) {
 		this.beforeRenderEvent.fire();
@@ -1027,7 +1114,7 @@
 			if (typeof element == "string") {
 				element = document.getElementById(element);
 			}
-			
+
 			if (element) {
 				element.appendChild(me.element);
 				me.appendEvent.fire();
@@ -1044,7 +1131,7 @@
 		}
 
 		// Need to get everything into the DOM if it isn't already
-		
+
 		if (this.header && ! YAHOO.util.Dom.inDocument(this.header)) {
 			// There is a header, but it's not in the DOM yet... need to add it
 			var firstChild = moduleElement.firstChild;
@@ -1075,10 +1162,14 @@
 
 	/**
 	* Removes the Module element from the DOM and sets all child elements to null.
+	* @method destroy
 	*/
 	destroy : function() {
+		var parent;
+
 		if (this.element) {
-			var parent = this.element.parentNode;
+			YAHOO.util.Event.purgeElement(this.element, true);
+			parent = this.element.parentNode;
 		}
 		if (parent) {
 			parent.removeChild(this.element);
@@ -1089,18 +1180,28 @@
 		this.body = null;
 		this.footer = null;
 
+		for (var e in this) {
+			if (e instanceof YAHOO.util.CustomEvent) {
+				e.unsubscribeAll();
+			}
+		}
+
+		YAHOO.widget.Module.textResizeEvent.unsubscribe(this.onDomResize, this);
+
 		this.destroyEvent.fire();
 	},
 
 	/**
 	* Shows the Module element by setting the visible configuration property to true. Also fires two events: beforeShowEvent prior to the visibility change, and showEvent after.
+	* @method show
 	*/
 	show : function() {
 		this.cfg.setProperty("visible", true);
 	},
 
 	/**
 	* Hides the Module element by setting the visible configuration property to false. Also fires two events: beforeHideEvent prior to the visibility change, and hideEvent after.
+	* @method hide
 	*/
 	hide : function() {
 		this.cfg.setProperty("visible", false);
@@ -1111,6 +1212,10 @@
 	/**
 	* Default event handler for changing the visibility property of a Module. By default, this is achieved by switching the "display" style between "block" and "none".
 	* This method is responsible for firing showEvent and hideEvent.
+	* @param {String} type	The CustomEvent type (usually the property name)
+	* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+	* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+	* @method configVisible
 	*/
 	configVisible : function(type, args, obj) {
 		var visible = args[0];
@@ -1127,6 +1232,10 @@
 
 	/**
 	* Default event handler for the "monitorresize" configuration property
+	* @param {String} type	The CustomEvent type (usually the property name)
+	* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+	* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+	* @method configMonitorResize
 	*/
 	configMonitorResize : function(type, args, obj) {
 		var monitor = args[0];
@@ -1140,19 +1249,22 @@
 };
 
 /**
-* Returns a string representation of the object.
-* @type string
-*/ 
+* Returns a String representation of the Object.
+* @method toString
+* @return {String}	The string representation of the Module
+*/
 YAHOO.widget.Module.prototype.toString = function() {
 	return "Module " + this.id;
 };
 
 /**
 * Overlay is a Module that is absolutely positioned above the page flow. It has convenience methods for positioning and sizing, as well as options for controlling zIndex and constraining the Overlay's position to the current visible viewport. Overlay also contains a dynamicly generated IFRAME which is placed beneath it for Internet Explorer 6 and 5.x so that it will be properly rendered above SELECT elements.
+* @namespace YAHOO.widget
+* @class Overlay
 * @extends YAHOO.widget.Module
-* @param {string}	el	The element ID representing the Overlay <em>OR</em>
-* @param {Element}	el	The element representing the Overlay
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
+* @param {String}	el	The element ID representing the Overlay <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Overlay
+* @param {Object}	userConfig	The configuration object literal containing 10/23/2006the configuration that should be set for this Overlay. See configuration documentation for more details.
 * @constructor
 */
 YAHOO.widget.Overlay = function(el, userConfig) {
@@ -1162,70 +1274,69 @@
 YAHOO.extend(YAHOO.widget.Overlay, YAHOO.widget.Module);
 
 /**
-* The URL of the blank image that will be placed in the iframe
-* @type string
+* The URL that will be placed in the iframe
+* @property YAHOO.widget.Overlay.IFRAME_SRC
+* @static
 * @final
+* @type String
 */
-YAHOO.widget.Overlay.IFRAME_SRC = "promo/m/irs/blank.gif";
+YAHOO.widget.Overlay.IFRAME_SRC = "javascript:false;";
 
 /**
 * Constant representing the top left corner of an element, used for configuring the context element alignment
-* @type string
+* @property YAHOO.widget.Overlay.TOP_LEFT
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Overlay.TOP_LEFT = "tl";
 
 /**
 * Constant representing the top right corner of an element, used for configuring the context element alignment
-* @type string
+* @property YAHOO.widget.Overlay.TOP_RIGHT
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Overlay.TOP_RIGHT = "tr";
 
 /**
 * Constant representing the top bottom left corner of an element, used for configuring the context element alignment
-* @type string
+* @property YAHOO.widget.Overlay.BOTTOM_LEFT
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Overlay.BOTTOM_LEFT = "bl";
 
 /**
 * Constant representing the bottom right corner of an element, used for configuring the context element alignment
-* @type string
+* @property YAHOO.widget.Overlay.BOTTOM_RIGHT
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Overlay.BOTTOM_RIGHT = "br";
 
 /**
 * Constant representing the default CSS class used for an Overlay
-* @type string
+* @property YAHOO.widget.Overlay.CSS_OVERLAY
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Overlay.CSS_OVERLAY = "overlay";
 
 /**
-* CustomEvent fired before the Overlay is moved.
-* args: x,y that the Overlay will be moved to
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Overlay.prototype.beforeMoveEvent = null;
-
-/**
-* CustomEvent fired after the Overlay is moved.
-* args: x,y that the Overlay was moved to
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Overlay.prototype.moveEvent = null;
-
-/**
 * The Overlay initialization method, which is executed for Overlay and all of its subclasses. This method is automatically called by the constructor, and  sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.
-* @param {string}	el	The element ID representing the Overlay <em>OR</em>
-* @param {Element}	el	The element representing the Overlay
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
+* @method init
+* @param {String}	el	The element ID representing the Overlay <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Overlay
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
 */
 YAHOO.widget.Overlay.prototype.init = function(el, userConfig) {
 	YAHOO.widget.Overlay.superclass.init.call(this, el/*, userConfig*/);  // Note that we don't pass the user config in here yet because we only want it executed once, at the lowest subclass level
-	
+
 	this.beforeInitEvent.fire(YAHOO.widget.Overlay);
 
 	YAHOO.util.Dom.addClass(this.element, YAHOO.widget.Overlay.CSS_OVERLAY);
@@ -1249,41 +1360,123 @@
 
 /**
 * Initializes the custom events for Overlay which are fired automatically at appropriate times by the Overlay class.
+* @method initEvents
 */
 YAHOO.widget.Overlay.prototype.initEvents = function() {
 	YAHOO.widget.Overlay.superclass.initEvents.call(this);
 
+	/**
+	* CustomEvent fired before the Overlay is moved.
+	* @event beforeMoveEvent
+	* @param {Number} x	x coordinate
+	* @param {Number} y	y coordinate
+	*/
 	this.beforeMoveEvent = new YAHOO.util.CustomEvent("beforeMove", this);
+
+	/**
+	* CustomEvent fired after the Overlay is moved.
+	* @event moveEvent
+	* @param {Number} x	x coordinate
+	* @param {Number} y	y coordinate
+	*/
 	this.moveEvent = new YAHOO.util.CustomEvent("move", this);
 };
 
 /**
 * Initializes the class's configurable properties which can be changed using the Overlay's Config object (cfg).
+* @method initDefaultConfig
 */
 YAHOO.widget.Overlay.prototype.initDefaultConfig = function() {
 	YAHOO.widget.Overlay.superclass.initDefaultConfig.call(this);
 
 	// Add overlay config properties //
+
+	/**
+	* The absolute x-coordinate position of the Overlay
+	* @config x
+	* @type Number
+	* @default null
+	*/
 	this.cfg.addProperty("x", { handler:this.configX, validator:this.cfg.checkNumber, suppressEvent:true, supercedes:["iframe"] } );
+
+	/**
+	* The absolute y-coordinate position of the Overlay
+	* @config y
+	* @type Number
+	* @default null
+	*/
 	this.cfg.addProperty("y", { handler:this.configY, validator:this.cfg.checkNumber, suppressEvent:true, supercedes:["iframe"] } );
+
+	/**
+	* An array with the absolute x and y positions of the Overlay
+	* @config xy
+	* @type Number[]
+	* @default null
+	*/
 	this.cfg.addProperty("xy",{ handler:this.configXY, suppressEvent:true, supercedes:["iframe"] } );
 
+	/**
+	* The array of context arguments for context-sensitive positioning. The format is: [id or element, element corner, context corner]. For example, setting this property to ["img1", "tl", "bl"] would align the Overlay's top left corner to the context element's bottom left corner.
+	* @config context
+	* @type Array
+	* @default null
+	*/
 	this.cfg.addProperty("context",	{ handler:this.configContext, suppressEvent:true, supercedes:["iframe"] } );
+
+	/**
+	* True if the Overlay should be anchored to the center of the viewport.
+	* @config fixedcenter
+	* @type Boolean
+	* @default false
+	*/
 	this.cfg.addProperty("fixedcenter", { value:false, handler:this.configFixedCenter, validator:this.cfg.checkBoolean, supercedes:["iframe","visible"] } );
 
+	/**
+	* CSS width of the Overlay.
+	* @config width
+	* @type String
+	* @default null
+	*/
 	this.cfg.addProperty("width", { handler:this.configWidth, suppressEvent:true, supercedes:["iframe"] } );
+
+	/**
+	* CSS height of the Overlay.
+	* @config height
+	* @type String
+	* @default null
+	*/
 	this.cfg.addProperty("height", { handler:this.configHeight, suppressEvent:true, supercedes:["iframe"] } );
 
+	/**
+	* CSS z-index of the Overlay.
+	* @config zIndex
+	* @type Number
+	* @default null
+	*/
 	this.cfg.addProperty("zIndex", { value:null, handler:this.configzIndex } );
 
+	/**
+	* True if the Overlay should be prevented from being positioned out of the viewport.
+	* @config constraintoviewport
+	* @type Boolean
+	* @default false
+	*/
 	this.cfg.addProperty("constraintoviewport", { value:false, handler:this.configConstrainToViewport, validator:this.cfg.checkBoolean, supercedes:["iframe","x","y","xy"] } );
+
+	/**
+	* True if the Overlay should have an IFRAME shim (for correcting the select z-index bug in IE6 and below).
+	* @config iframe
+	* @type Boolean
+	* @default true for IE6 and below, false for all others
+	*/
 	this.cfg.addProperty("iframe", { value:(this.browser == "ie" ? true : false), handler:this.configIframe, validator:this.cfg.checkBoolean, supercedes:["zIndex"] } );
 };
 
 /**
 * Moves the Overlay to the specified position. This function is identical to calling this.cfg.setProperty("xy", [x,y]);
-* @param {int}	x	The Overlay's new x position
-* @param {int}	y	The Overlay's new y position
+* @method moveTo
+* @param {Number}	x	The Overlay's new x position
+* @param {Number}	y	The Overlay's new y position
 */
 YAHOO.widget.Overlay.prototype.moveTo = function(x, y) {
 	this.cfg.setProperty("xy",[x,y]);
@@ -1292,6 +1485,7 @@
 /**
 * Adds a special CSS class to the Overlay when Mac/Gecko is in use, to work around a Gecko bug where
 * scrollbars cannot be hidden. See https://bugzilla.mozilla.org/show_bug.cgi?id=187435
+* @method hideMacGeckoScrollbars
 */
 YAHOO.widget.Overlay.prototype.hideMacGeckoScrollbars = function() {
 	YAHOO.util.Dom.removeClass(this.element, "show-scrollbars");
@@ -1301,6 +1495,7 @@
 /**
 * Removes a special CSS class from the Overlay when Mac/Gecko is in use, to work around a Gecko bug where
 * scrollbars cannot be hidden. See https://bugzilla.mozilla.org/show_bug.cgi?id=187435
+* @method showMacGeckoScrollbars
 */
 YAHOO.widget.Overlay.prototype.showMacGeckoScrollbars = function() {
 	YAHOO.util.Dom.removeClass(this.element, "hide-scrollbars");
@@ -1311,11 +1506,27 @@
 
 /**
 * The default event handler fired when the "visible" property is changed. This method is responsible for firing showEvent and hideEvent.
+* @method configVisible
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configVisible = function(type, args, obj) {
 	var visible = args[0];
 	var currentVis = YAHOO.util.Dom.getStyle(this.element, "visibility");
 
+	if (currentVis == "inherit") {
+		var e = this.element.parentNode;
+		while (e.nodeType != 9 && e.nodeType != 11) {
+			currentVis = YAHOO.util.Dom.getStyle(e, "visibility");
+			if (currentVis != "inherit") { break; }
+			e = e.parentNode;
+		}
+		if (currentVis == "inherit") {
+			currentVis = "visible";
+		}
+	}
+
 	var effect = this.cfg.getProperty("effect");
 
 	var effectInstances = [];
@@ -1335,23 +1546,23 @@
 	if (visible) { // Show
 		if (isMacGecko) {
 			this.showMacGeckoScrollbars();
-		}	
+		}
 
 		if (effect) { // Animate in
 			if (visible) { // Animate in if not showing
-				if (currentVis != "visible") {
+				if (currentVis != "visible" || currentVis === "") {
 					this.beforeShowEvent.fire();
 					for (var j=0;j<effectInstances.length;j++) {
-						var e = effectInstances[j];
-						if (j === 0 && ! YAHOO.util.Config.alreadySubscribed(e.animateInCompleteEvent,this.showEvent.fire,this.showEvent)) {
-							e.animateInCompleteEvent.subscribe(this.showEvent.fire,this.showEvent,true); // Delegate showEvent until end of animateInComplete
+						var ei = effectInstances[j];
+						if (j === 0 && ! YAHOO.util.Config.alreadySubscribed(ei.animateInCompleteEvent,this.showEvent.fire,this.showEvent)) {
+							ei.animateInCompleteEvent.subscribe(this.showEvent.fire,this.showEvent,true); // Delegate showEvent until end of animateInComplete
 						}
-						e.animateIn();
+						ei.animateIn();
 					}
 				}
 			}
 		} else { // Show
-			if (currentVis != "visible") {
+			if (currentVis != "visible" || currentVis === "") {
 				this.beforeShowEvent.fire();
 				YAHOO.util.Dom.setStyle(this.element, "visibility", "visible");
 				this.cfg.refireEvent("iframe");
@@ -1362,32 +1573,35 @@
 	} else { // Hide
 		if (isMacGecko) {
 			this.hideMacGeckoScrollbars();
-		}	
+		}
 
 		if (effect) { // Animate out if showing
 			if (currentVis == "visible") {
 				this.beforeHideEvent.fire();
 				for (var k=0;k<effectInstances.length;k++) {
 					var h = effectInstances[k];
-					if (k === 0 && ! YAHOO.util.Config.alreadySubscribed(h.animateOutCompleteEvent,this.hideEvent.fire,this.hideEvent)) {				
+					if (k === 0 && ! YAHOO.util.Config.alreadySubscribed(h.animateOutCompleteEvent,this.hideEvent.fire,this.hideEvent)) {
 						h.animateOutCompleteEvent.subscribe(this.hideEvent.fire,this.hideEvent,true); // Delegate hideEvent until end of animateOutComplete
 					}
 					h.animateOut();
 				}
+			} else if (currentVis === "") {
+				YAHOO.util.Dom.setStyle(this.element, "visibility", "hidden");
 			}
 		} else { // Simple hide
-			if (currentVis == "visible") {
+			if (currentVis == "visible" || currentVis === "") {
 				this.beforeHideEvent.fire();
 				YAHOO.util.Dom.setStyle(this.element, "visibility", "hidden");
 				this.cfg.refireEvent("iframe");
 				this.hideEvent.fire();
 			}
-		}	
+		}
 	}
 };
 
 /**
 * Center event handler used for centering on scroll/resize, but only if the Overlay is visible
+* @method doCenterOnDOMEvent
 */
 YAHOO.widget.Overlay.prototype.doCenterOnDOMEvent = function() {
 	if (this.cfg.getProperty("visible")) {
@@ -1397,17 +1611,21 @@
 
 /**
 * The default event handler fired when the "fixedcenter" property is changed.
+* @method configFixedCenter
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configFixedCenter = function(type, args, obj) {
 	var val = args[0];
 
 	if (val) {
 		this.center();
-			
+
 		if (! YAHOO.util.Config.alreadySubscribed(this.beforeShowEvent, this.center, this)) {
 			this.beforeShowEvent.subscribe(this.center, this, true);
 		}
-		
+
 		if (! YAHOO.util.Config.alreadySubscribed(YAHOO.widget.Overlay.windowResizeEvent, this.doCenterOnDOMEvent, this)) {
 			YAHOO.widget.Overlay.windowResizeEvent.subscribe(this.doCenterOnDOMEvent, this, true);
 		}
@@ -1423,6 +1641,10 @@
 
 /**
 * The default event handler fired when the "height" property is changed.
+* @method configHeight
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configHeight = function(type, args, obj) {
 	var height = args[0];
@@ -1433,6 +1655,10 @@
 
 /**
 * The default event handler fired when the "width" property is changed.
+* @method configWidth
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configWidth = function(type, args, obj) {
 	var width = args[0];
@@ -1443,6 +1669,10 @@
 
 /**
 * The default event handler fired when the "zIndex" property is changed.
+* @method configzIndex
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configzIndex = function(type, args, obj) {
 	var zIndex = args[0];
@@ -1469,6 +1699,10 @@
 
 /**
 * The default event handler fired when the "xy" property is changed.
+* @method configXY
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configXY = function(type, args, obj) {
 	var pos = args[0];
@@ -1491,6 +1725,10 @@
 
 /**
 * The default event handler fired when the "x" property is changed.
+* @method configX
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configX = function(type, args, obj) {
 	var x = args[0];
@@ -1505,7 +1743,7 @@
 	y = this.cfg.getProperty("y");
 
 	YAHOO.util.Dom.setX(this.element, x, true);
-	
+
 	this.cfg.setProperty("xy", [x, y], true);
 
 	this.cfg.refireEvent("iframe");
@@ -1514,6 +1752,10 @@
 
 /**
 * The default event handler fired when the "y" property is changed.
+* @method configY
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configY = function(type, args, obj) {
 	var x = this.cfg.getProperty("x");
@@ -1537,24 +1779,30 @@
 
 /**
 * Shows the iframe shim, if it has been enabled
+* @method showIframe
 */
 YAHOO.widget.Overlay.prototype.showIframe = function() {
 	if (this.iframe) {
 		this.iframe.style.display = "block";
 	}
-}
+};
 
 /**
 * Hides the iframe shim, if it has been enabled
+* @method hideIframe
 */
 YAHOO.widget.Overlay.prototype.hideIframe = function() {
 	if (this.iframe) {
 		this.iframe.style.display = "none";
 	}
-}
+};
 
 /**
 * The default event handler fired when the "iframe" property is changed.
+* @method configIframe
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configIframe = function(type, args, obj) {
 
@@ -1584,9 +1832,9 @@
 			if (! this.iframe) {
 				this.iframe = document.createElement("iframe");
 				if (this.isSecure) {
-					this.iframe.src = this.imageRoot + YAHOO.widget.Overlay.IFRAME_SRC;
+					this.iframe.src = YAHOO.widget.Overlay.IFRAME_SRC;
 				}
-				
+
 				var parent = this.element.parentNode;
 				if (parent) {
 					parent.appendChild(this.iframe);
@@ -1605,7 +1853,7 @@
 					this.hideIframe();
 				}
 			}
-			
+
 			var iframeDisplay = YAHOO.util.Dom.getStyle(this.iframe, "display");
 
 			if (iframeDisplay == "none") {
@@ -1636,6 +1884,10 @@
 
 /**
 * The default event handler fired when the "constraintoviewport" property is changed.
+* @method configConstrainToViewport
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configConstrainToViewport = function(type, args, obj) {
 	var val = args[0];
@@ -1650,6 +1902,10 @@
 
 /**
 * The default event handler fired when the "context" property is changed.
+* @method configContext
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.configContext = function(type, args, obj) {
 	var contextArgs = args[0];
@@ -1663,11 +1919,11 @@
 			if (typeof contextEl == "string") {
 				this.cfg.setProperty("context", [document.getElementById(contextEl),elementMagnetCorner,contextMagnetCorner], true);
 			}
-			
+
 			if (elementMagnetCorner && contextMagnetCorner) {
 				this.align(elementMagnetCorner, contextMagnetCorner);
 			}
-		}	
+		}
 	}
 };
 
@@ -1676,14 +1932,15 @@
 
 /**
 * Aligns the Overlay to its context element using the specified corner points (represented by the constants TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, and BOTTOM_RIGHT.
-* @param {string} elementAlign		The string representing the corner of the Overlay that should be aligned to the context element
-* @param {string} contextAlign		The corner of the context element that the elementAlign corner should stick to.
+* @method align
+* @param {String} elementAlign		The String representing the corner of the Overlay that should be aligned to the context element
+* @param {String} contextAlign		The corner of the context element that the elementAlign corner should stick to.
 */
 YAHOO.widget.Overlay.prototype.align = function(elementAlign, contextAlign) {
 	var contextArgs = this.cfg.getProperty("context");
 	if (contextArgs) {
 		var context = contextArgs[0];
-		
+
 		var element = this.element;
 		var me = this;
 
@@ -1722,7 +1979,7 @@
 					break;
 				case YAHOO.widget.Overlay.TOP_RIGHT:
 					doAlign(contextRegion.top, contextRegion.right);
-					break;		
+					break;
 				case YAHOO.widget.Overlay.BOTTOM_LEFT:
 					doAlign(contextRegion.bottom, contextRegion.left);
 					break;
@@ -1736,6 +1993,10 @@
 
 /**
 * The default event handler executed when the moveEvent is fired, if the "constraintoviewport" is set to true.
+* @method enforceConstraints
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Overlay.prototype.enforceConstraints = function(type, args, obj) {
 	var pos = args[0];
@@ -1756,7 +2017,7 @@
 	var leftConstraint = scrollX + 10;
 	var bottomConstraint = scrollY + viewPortHeight - offsetHeight - 10;
 	var rightConstraint = scrollX + viewPortWidth - offsetWidth - 10;
-	
+
 	if (x < leftConstraint) {
 		x = leftConstraint;
 	} else if (x > rightConstraint) {
@@ -1776,6 +2037,7 @@
 
 /**
 * Centers the container in the viewport.
+* @method center
 */
 YAHOO.widget.Overlay.prototype.center = function() {
 	var scrollX = document.documentElement.scrollLeft || document.body.scrollLeft;
@@ -1789,16 +2051,15 @@
 
 	var x = (viewPortWidth / 2) - (elementWidth / 2) + scrollX;
 	var y = (viewPortHeight / 2) - (elementHeight / 2) + scrollY;
-	
-	this.element.style.left = parseInt(x, 10) + "px";
-	this.element.style.top = parseInt(y, 10) + "px";
-	this.syncPosition();
 
+	this.cfg.setProperty("xy", [parseInt(x, 10), parseInt(y, 10)]);
+
 	this.cfg.refireEvent("iframe");
 };
 
 /**
 * Synchronizes the Panel's "xy", "x", and "y" properties with the Panel's position in the DOM. This is primarily used to update position information during drag & drop.
+* @method syncPosition
 */
 YAHOO.widget.Overlay.prototype.syncPosition = function() {
 	var pos = YAHOO.util.Dom.getXY(this.element);
@@ -1809,63 +2070,99 @@
 
 /**
 * Event handler fired when the resize monitor element is resized.
+* @method onDomResize
+* @param {DOMEvent} e	The resize DOM event
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.Overlay.prototype.onDomResize = function(e, obj) {
 	YAHOO.widget.Overlay.superclass.onDomResize.call(this, e, obj);
-	this.cfg.refireEvent("iframe");
+	var me = this;
+	setTimeout(function() {
+		me.syncPosition();
+		me.cfg.refireEvent("iframe");
+		me.cfg.refireEvent("context");
+	}, 0);
 };
 
 /**
 * Removes the Overlay element from the DOM and sets all child elements to null.
+* @method destroy
 */
 YAHOO.widget.Overlay.prototype.destroy = function() {
 	if (this.iframe) {
 		this.iframe.parentNode.removeChild(this.iframe);
 	}
-	
+
 	this.iframe = null;
 
-	YAHOO.widget.Overlay.superclass.destroy.call(this);  
+	YAHOO.widget.Overlay.windowResizeEvent.unsubscribe(this.doCenterOnDOMEvent, this);
+	YAHOO.widget.Overlay.windowScrollEvent.unsubscribe(this.doCenterOnDOMEvent, this);
+
+	YAHOO.widget.Overlay.superclass.destroy.call(this);
 };
 
 /**
-* Returns a string representation of the object.
-* @type string
-*/ 
+* Returns a String representation of the object.
+* @method toString
+* @return {String} The string representation of the Overlay.
+*/
 YAHOO.widget.Overlay.prototype.toString = function() {
 	return "Overlay " + this.id;
 };
 
 /**
 * A singleton CustomEvent used for reacting to the DOM event for window scroll
-* @type YAHOO.util.CustomEvent
+* @event YAHOO.widget.Overlay.windowScrollEvent
 */
 YAHOO.widget.Overlay.windowScrollEvent = new YAHOO.util.CustomEvent("windowScroll");
 
 /**
 * A singleton CustomEvent used for reacting to the DOM event for window resize
-* @type YAHOO.util.CustomEvent
+* @event YAHOO.widget.Overlay.windowResizeEvent
 */
 YAHOO.widget.Overlay.windowResizeEvent = new YAHOO.util.CustomEvent("windowResize");
 
 /**
 * The DOM event handler used to fire the CustomEvent for window scroll
-* @type Function
+* @method YAHOO.widget.Overlay.windowScrollHandler
+* @static
+* @param {DOMEvent} e The DOM scroll event
 */
 YAHOO.widget.Overlay.windowScrollHandler = function(e) {
-	YAHOO.widget.Overlay.windowScrollEvent.fire();
+	if (YAHOO.widget.Module.prototype.browser == "ie" || YAHOO.widget.Module.prototype.browser == "ie7") {
+		if (! window.scrollEnd) {
+			window.scrollEnd = -1;
+		}
+		clearTimeout(window.scrollEnd);
+		window.scrollEnd = setTimeout(function() { YAHOO.widget.Overlay.windowScrollEvent.fire(); }, 1);
+	} else {
+		YAHOO.widget.Overlay.windowScrollEvent.fire();
+	}
 };
 
 /**
 * The DOM event handler used to fire the CustomEvent for window resize
-* @type Function
+* @method YAHOO.widget.Overlay.windowResizeHandler
+* @static
+* @param {DOMEvent} e The DOM resize event
 */
 YAHOO.widget.Overlay.windowResizeHandler = function(e) {
-	YAHOO.widget.Overlay.windowResizeEvent.fire();
+	if (YAHOO.widget.Module.prototype.browser == "ie" || YAHOO.widget.Module.prototype.browser == "ie7") {
+		if (! window.resizeEnd) {
+			window.resizeEnd = -1;
+		}
+		clearTimeout(window.resizeEnd);
+		window.resizeEnd = setTimeout(function() { YAHOO.widget.Overlay.windowResizeEvent.fire(); }, 100);
+	} else {
+		YAHOO.widget.Overlay.windowResizeEvent.fire();
+	}
 };
 
 /**
+* A boolean that indicated whether the window resize and scroll events have already been subscribed to.
+* @property YAHOO.widget.Overlay._initialized
 * @private
+* @type Boolean
 */
 YAHOO.widget.Overlay._initialized = null;
 
@@ -1876,72 +2173,76 @@
 	YAHOO.widget.Overlay._initialized = true;
 }
 
-
 /**
-* OverlayManager is used for maintaining the focus status of multiple Overlays.
-* @param {Array}	overlays	Optional. A collection of Overlays to register with the manager.
-* @param {object}	userConfig		The object literal representing the user configuration of the OverlayManager
+* OverlayManager is used for maintaining the focus status of multiple Overlays.* @namespace YAHOO.widget
+* @namespace YAHOO.widget
+* @class OverlayManager
 * @constructor
+* @param {Array}	overlays	Optional. A collection of Overlays to register with the manager.
+* @param {Object}	userConfig		The object literal representing the user configuration of the OverlayManager
 */
 YAHOO.widget.OverlayManager = function(userConfig) {
 	this.init(userConfig);
 };
 
 /**
 * The CSS class representing a focused Overlay
-* @type string
+* @property YAHOO.widget.OverlayManager.CSS_FOCUSED
+* @static
+* @final
+* @type String
 */
 YAHOO.widget.OverlayManager.CSS_FOCUSED = "focused";
 
 YAHOO.widget.OverlayManager.prototype = {
-
+	/**
+	* The class's constructor function
+	* @property contructor
+	* @type Function
+	*/
 	constructor : YAHOO.widget.OverlayManager,
 
 	/**
 	* The array of Overlays that are currently registered
-	* @type Array
+	* @property overlays
+	* @type YAHOO.widget.Overlay[]
 	*/
 	overlays : null,
 
 	/**
 	* Initializes the default configuration of the OverlayManager
-	*/	
+	* @method initDefaultConfig
+	*/
 	initDefaultConfig : function() {
+		/**
+		* The collection of registered Overlays in use by the OverlayManager
+		* @config overlays
+		* @type YAHOO.widget.Overlay[]
+		* @default null
+		*/
 		this.cfg.addProperty("overlays", { suppressEvent:true } );
+
+		/**
+		* The default DOM event that should be used to focus an Overlay
+		* @config focusevent
+		* @type String
+		* @default "mousedown"
+		*/
 		this.cfg.addProperty("focusevent", { value:"mousedown" } );
-	}, 
+	},
 
 	/**
-	* Returns the currently focused Overlay
-	* @return {Overlay}	The currently focused Overlay
-	*/
-	getActive : function() {},
-
-	/**
-	* Focuses the specified Overlay
-	* @param {Overlay}	The Overlay to focus
-	* @param {string}	The id of the Overlay to focus
-	*/
-	focus : function(overlay) {},
-
-	/**
-	* Removes the specified Overlay from the manager
-	* @param {Overlay}	The Overlay to remove
-	* @param {string}	The id of the Overlay to remove
-	*/
-	remove: function(overlay) {},
-
-	/**
-	* Removes focus from all registered Overlays in the manager
-	*/
-	blurAll : function() {},
-
-	/**
 	* Initializes the OverlayManager
-	* @param {Array}	overlays	Optional. A collection of Overlays to register with the manager.
-	* @param {object}	userConfig		The object literal representing the user configuration of the OverlayManager
+	* @method init
+	* @param {YAHOO.widget.Overlay[]}	overlays	Optional. A collection of Overlays to register with the manager.
+	* @param {Object}	userConfig		The object literal representing the user configuration of the OverlayManager
 	*/
 	init : function(userConfig) {
+		/**
+		* The OverlayManager's Config object used for monitoring configuration properties.
+		* @property cfg
+		* @type YAHOO.util.Config
+		*/
 		this.cfg = new YAHOO.util.Config(this);
 
 		this.initDefaultConfig();
@@ -1951,12 +2252,29 @@
 		}
 		this.cfg.fireQueue();
 
+		/**
+		* The currently activated Overlay
+		* @property activeOverlay
+		* @private
+		* @type YAHOO.widget.Overlay
+		*/
 		var activeOverlay = null;
 
+		/**
+		* Returns the currently focused Overlay
+		* @method getActive
+		* @return {YAHOO.widget.Overlay}	The currently focused Overlay
+		*/
 		this.getActive = function() {
 			return activeOverlay;
 		};
 
+		/**
+		* Focuses the specified Overlay
+		* @method focus
+		* @param {YAHOO.widget.Overlay} overlay	The Overlay to focus
+		* @param {String} overlay	The id of the Overlay to focus
+		*/
 		this.focus = function(overlay) {
 			var o = this.find(overlay);
 			if (o) {
@@ -1972,6 +2290,12 @@
 			}
 		};
 
+		/**
+		* Removes the specified Overlay from the manager
+		* @method remove
+		* @param {YAHOO.widget.Overlay}	overlay	The Overlay to remove
+		* @param {String} overlay	The id of the Overlay to remove
+		*/
 		this.remove = function(overlay) {
 			var o = this.find(overlay);
 			if (o) {
@@ -1989,15 +2313,19 @@
 			}
 		};
 
+		/**
+		* Removes focus from all registered Overlays in the manager
+		* @method blurAll
+		*/
 		this.blurAll = function() {
 			activeOverlay = null;
 			for (var o=0;o<this.overlays.length;o++) {
 				YAHOO.util.Dom.removeClass(this.overlays[o].element, YAHOO.widget.OverlayManager.CSS_FOCUSED);
-			}		
+			}
 		};
 
 		var overlays = this.cfg.getProperty("overlays");
-		
+
 		if (! this.overlays) {
 			this.overlays = [];
 		}
@@ -2010,17 +2338,18 @@
 
 	/**
 	* Registers an Overlay or an array of Overlays with the manager. Upon registration, the Overlay receives functions for focus and blur, along with CustomEvents for each.
-	* @param {Overlay}	overlay		An Overlay to register with the manager.
-	* @param {Overlay[]}	overlay		An array of Overlays to register with the manager.
-	* @return	{boolean}	True if any Overlays are registered.
+	* @method register
+	* @param {YAHOO.widget.Overlay}	overlay		An Overlay to register with the manager.
+	* @param {YAHOO.widget.Overlay[]}	overlay		An array of Overlays to register with the manager.
+	* @return	{Boolean}	True if any Overlays are registered.
 	*/
 	register : function(overlay) {
 		if (overlay instanceof YAHOO.widget.Overlay) {
 			overlay.cfg.addProperty("manager", { value:this } );
 
 			overlay.focusEvent = new YAHOO.util.CustomEvent("focus");
 			overlay.blurEvent = new YAHOO.util.CustomEvent("blur");
-			
+
 			var mgr=this;
 
 			overlay.focus = function() {
@@ -2036,7 +2365,7 @@
 			var focusOnDomEvent = function(e,obj) {
 				overlay.focus();
 			};
-			
+
 			var focusevent = this.cfg.getProperty("focusevent");
 			YAHOO.util.Event.addListener(overlay.element,focusevent,focusOnDomEvent,this,true);
 
@@ -2046,7 +2375,7 @@
 			} else {
 				overlay.cfg.setProperty("zIndex", 0);
 			}
-			
+
 			this.overlays.push(overlay);
 			return true;
 		} else if (overlay instanceof Array) {
@@ -2066,9 +2395,10 @@
 
 	/**
 	* Attempts to locate an Overlay by instance or ID.
-	* @param {Overlay}	overlay		An Overlay to locate within the manager
-	* @param {string}	overlay		An Overlay id to locate within the manager
-	* @return	{Overlay}	The requested Overlay, if found, or null if it cannot be located.
+	* @method find
+	* @param {YAHOO.widget.Overlay}	overlay		An Overlay to locate within the manager
+	* @param {String}	overlay		An Overlay id to locate within the manager
+	* @return	{YAHOO.widget.Overlay}	The requested Overlay, if found, or null if it cannot be located.
 	*/
 	find : function(overlay) {
 		if (overlay instanceof YAHOO.widget.Overlay) {
@@ -2082,14 +2412,16 @@
 				if (this.overlays[p].id == overlay) {
 					return this.overlays[p];
 				}
-			}			
+			}
 		}
 		return null;
 	},
 
 	/**
 	* Used for sorting the manager's Overlays by z-index.
+	* @method compareZIndexDesc
 	* @private
+	* @return {Number}	0, 1, or -1, depending on where the Overlay should fall in the stacking order.
 	*/
 	compareZIndexDesc : function(o1, o2) {
 		var zIndex1 = o1.cfg.getProperty("zIndex");
@@ -2106,6 +2438,7 @@
 
 	/**
 	* Shows all Overlays in the manager.
+	* @method showAll
 	*/
 	showAll : function() {
 		for (var o=0;o<this.overlays.length;o++) {
@@ -2115,6 +2448,7 @@
 
 	/**
 	* Hides all Overlays in the manager.
+	* @method hideAll
 	*/
 	hideAll : function() {
 		for (var o=0;o<this.overlays.length;o++) {
@@ -2124,8 +2458,9 @@
 
 	/**
 	* Returns a string representation of the object.
-	* @type string
-	*/ 
+	* @method toString
+	* @return {String}	The string representation of the OverlayManager
+	*/
 	toString : function() {
 		return "OverlayManager";
 	}
@@ -2134,13 +2469,15 @@
 
 /**
 * KeyListener is a utility that provides an easy interface for listening for keydown/keyup events fired against DOM elements.
-* @param {Element}	attachTo	The element or element ID to which the key event should be attached
-* @param {string}	attachTo	The element or element ID to which the key event should be attached
-* @param {object}	keyData		The object literal representing the key(s) to detect. Possible attributes are shift(boolean), alt(boolean), ctrl(boolean) and keys(either an int or an array of ints representing keycodes).
-* @param {function}	handler		The CustomEvent handler to fire when the key event is detected
-* @param {object}	handler		An object literal representing the handler. 
-* @param {string}	event		Optional. The event (keydown or keyup) to listen for. Defaults automatically to keydown.
+* @namespace YAHOO.util
+* @class KeyListener
 * @constructor
+* @param {HTMLElement}	attachTo	The element or element ID to which the key event should be attached
+* @param {String}	attachTo	The element or element ID to which the key event should be attached
+* @param {Object}	keyData		The object literal representing the key(s) to detect. Possible attributes are shift(boolean), alt(boolean), ctrl(boolean) and keys(either an int or an array of ints representing keycodes).
+* @param {Function}	handler		The CustomEvent handler to fire when the key event is detected
+* @param {Object}	handler		An object literal representing the handler.
+* @param {String}	event		Optional. The event (keydown or keyup) to listen for. Defaults automatically to keydown.
 */
 YAHOO.util.KeyListener = function(attachTo, keyData, handler, event) {
 	if (! attachTo) {
@@ -2157,9 +2494,26 @@
 		event = YAHOO.util.KeyListener.KEYDOWN;
 	}
 
+	/**
+	* The CustomEvent fired internally when a key is pressed
+	* @event keyEvent
+	* @private
+	* @param {Object}	keyData		The object literal representing the key(s) to detect. Possible attributes are shift(boolean), alt(boolean), ctrl(boolean) and keys(either an int or an array of ints representing keycodes).
+	*/
 	var keyEvent = new YAHOO.util.CustomEvent("keyPressed");
-	
+
+	/**
+	* The CustomEvent fired when the KeyListener is enabled via the enable() function
+	* @event enabledEvent
+	* @param {Object}	keyData		The object literal representing the key(s) to detect. Possible attributes are shift(boolean), alt(boolean), ctrl(boolean) and keys(either an int or an array of ints representing keycodes).
+	*/
 	this.enabledEvent = new YAHOO.util.CustomEvent("enabled");
+
+	/**
+	* The CustomEvent fired when the KeyListener is disabled via the disable() function
+	* @event disabledEvent
+	* @param {Object}	keyData		The object literal representing the key(s) to detect. Possible attributes are shift(boolean), alt(boolean), ctrl(boolean) and keys(either an int or an array of ints representing keycodes).
+	*/
 	this.disabledEvent = new YAHOO.util.CustomEvent("disabled");
 
 	if (typeof attachTo == 'string') {
@@ -2174,49 +2528,74 @@
 
 	/**
 	* Handles the key event when a key is pressed.
+	* @method handleKeyPress
+	* @param {DOMEvent} e	The keypress DOM event
+	* @param {Object}	obj	The DOM event scope object
 	* @private
 	*/
 	function handleKeyPress(e, obj) {
-		var keyPressed = e.charCode || e.keyCode;
-		
-		if (! keyData.shift) {	
-			keyData.shift = false; 
+		if (! keyData.shift) {
+			keyData.shift = false;
 		}
-		if (! keyData.alt) {	
+		if (! keyData.alt) {
 			keyData.alt = false;
 		}
 		if (! keyData.ctrl) {
 			keyData.ctrl = false;
 		}
 
 		// check held down modifying keys first
-		if (e.shiftKey == keyData.shift && 
+		if (e.shiftKey == keyData.shift &&
 			e.altKey   == keyData.alt &&
 			e.ctrlKey  == keyData.ctrl) { // if we pass this, all modifiers match
 
+			var dataItem;
+			var keyPressed;
+
 			if (keyData.keys instanceof Array) {
 				for (var i=0;i<keyData.keys.length;i++) {
-					if (keyPressed == keyData.keys[i]) {
-						keyEvent.fire(keyPressed, e);
+					dataItem = keyData.keys[i];
+
+					if (dataItem == e.charCode ) {
+						keyEvent.fire(e.charCode, e);
 						break;
+					} else if (dataItem == e.keyCode) {
+						keyEvent.fire(e.keyCode, e);
+						break;
 					}
 				}
 			} else {
-				if (keyPressed == keyData.keys) {
-					keyEvent.fire(keyPressed, e);
+				dataItem = keyData.keys;
+				if (dataItem == e.charCode ) {
+					keyEvent.fire(e.charCode, e);
+				} else if (dataItem == e.keyCode) {
+					keyEvent.fire(e.keyCode, e);
 				}
 			}
 		}
 	}
 
+	/**
+	* Enables the KeyListener by attaching the DOM event listeners to the target DOM element
+	* @method enable
+	*/
 	this.enable = function() {
 		if (! this.enabled) {
 			YAHOO.util.Event.addListener(attachTo, event, handleKeyPress);
 			this.enabledEvent.fire(keyData);
 		}
+		/**
+		* Boolean indicating the enabled/disabled state of the Tooltip
+		* @property enabled
+		* @type Boolean
+		*/
 		this.enabled = true;
 	};
 
+	/**
+	* Disables the KeyListener by removing the DOM event listeners from the target DOM element
+	* @method disable
+	*/
 	this.disable = function() {
 		if (this.enabled) {
 			YAHOO.util.Event.removeListener(attachTo, event, handleKeyPress);
@@ -2226,9 +2605,10 @@
 	};
 
 	/**
-	* Returns a string representation of the object.
-	* @type string
-	*/ 
+	* Returns a String representation of the object.
+	* @method toString
+	* @return {String}	The string representation of the KeyListener
+	*/
 	this.toString = function() {
 		return "KeyListener [" + keyData.keys + "] " + attachTo.tagName + (attachTo.id ? "[" + attachTo.id + "]" : "");
 	};
@@ -2237,75 +2617,53 @@
 
 /**
 * Constant representing the DOM "keydown" event.
+* @property YAHOO.util.KeyListener.KEYDOWN
+* @static
 * @final
+* @type String
 */
 YAHOO.util.KeyListener.KEYDOWN = "keydown";
 
 /**
 * Constant representing the DOM "keyup" event.
+* @property YAHOO.util.KeyListener.KEYUP
+* @static
 * @final
+* @type String
 */
 YAHOO.util.KeyListener.KEYUP = "keyup";
 
 /**
-* Boolean indicating the enabled/disabled state of the Tooltip
-* @type Booleam
-*/
-YAHOO.util.KeyListener.prototype.enabled = null;
-
-/**
-* Enables the KeyListener, by dynamically attaching the key event to the appropriate DOM element.
-*/
-YAHOO.util.KeyListener.prototype.enable = function() {};
-
-/**
-* Disables the KeyListener, by dynamically removing the key event from the appropriate DOM element.
-*/
-YAHOO.util.KeyListener.prototype.disable = function() {};
-
-/**
-* CustomEvent fired when the KeyListener is enabled
-* args: keyData
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.util.KeyListener.prototype.enabledEvent = null;
-
-/**
-* CustomEvent fired when the KeyListener is disabled
-* args: keyData
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.util.KeyListener.prototype.disabledEvent = null;
-
-
-/**
 * Tooltip is an implementation of Overlay that behaves like an OS tooltip, displaying when the user mouses over a particular element, and disappearing on mouse out.
+* @namespace YAHOO.widget
+* @class Tooltip
 * @extends YAHOO.widget.Overlay
-* @param {string}	el	The element ID representing the Tooltip <em>OR</em>
-* @param {Element}	el	The element representing the Tooltip
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
 * @constructor
+* @param {String}	el	The element ID representing the Tooltip <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Tooltip
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
 */
 YAHOO.widget.Tooltip = function(el, userConfig) {
 	YAHOO.widget.Tooltip.superclass.constructor.call(this, el, userConfig);
 };
 
 YAHOO.extend(YAHOO.widget.Tooltip, YAHOO.widget.Overlay);
 
-YAHOO.widget.Tooltip.logger = new YAHOO.widget.LogWriter("Tooltip");
-
 /**
 * Constant representing the Tooltip CSS class
-* @type string
+* @property YAHOO.widget.Tooltip.CSS_TOOLTIP
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Tooltip.CSS_TOOLTIP = "tt";
 
 /**
 * The Tooltip initialization method. This method is automatically called by the constructor. A Tooltip is automatically rendered by the init method, and it also is set to be invisible by default, and constrained to viewport by default as well.
-* @param {string}	el	The element ID representing the Tooltip <em>OR</em>
-* @param {Element}	el	The element representing the Tooltip
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Tooltip. See configuration documentation for more details.
+* @method init
+* @param {String}	el	The element ID representing the Tooltip <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Tooltip
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Tooltip. See configuration documentation for more details.
 */
 YAHOO.widget.Tooltip.prototype.init = function(el, userConfig) {
 	this.logger = YAHOO.widget.Tooltip.logger;
@@ -2325,7 +2683,7 @@
 		if (userConfig) {
 			this.cfg.applyConfig(userConfig, true);
 		}
-		
+
 		this.cfg.queueProperty("visible",false);
 		this.cfg.queueProperty("constraintoviewport",true);
 
@@ -2338,24 +2696,76 @@
 
 /**
 * Initializes the class's configurable properties which can be changed using the Overlay's Config object (cfg).
+* @method initDefaultConfig
 */
 YAHOO.widget.Tooltip.prototype.initDefaultConfig = function() {
 	YAHOO.widget.Tooltip.superclass.initDefaultConfig.call(this);
 
+	/**
+	* Specifies whether the Tooltip should be kept from overlapping its context element.
+	* @config preventoverlap
+	* @type Boolean
+	* @default true
+	*/
 	this.cfg.addProperty("preventoverlap",		{ value:true, validator:this.cfg.checkBoolean, supercedes:["x","y","xy"] } );
 
+	/**
+	* The number of milliseconds to wait before showing a Tooltip on mouseover.
+	* @config showdelay
+	* @type Number
+	* @default 200
+	*/
 	this.cfg.addProperty("showdelay",			{ value:200, handler:this.configShowDelay, validator:this.cfg.checkNumber } );
+
+	/**
+	* The number of milliseconds to wait before automatically dismissing a Tooltip after the mouse has been resting on the context element.
+	* @config autodismissdelay
+	* @type Number
+	* @default 5000
+	*/
 	this.cfg.addProperty("autodismissdelay",	{ value:5000, handler:this.configAutoDismissDelay, validator:this.cfg.checkNumber } );
+
+	/**
+	* The number of milliseconds to wait before hiding a Tooltip on mouseover.
+	* @config hidedelay
+	* @type Number
+	* @default 250
+	*/
 	this.cfg.addProperty("hidedelay",			{ value:250, handler:this.configHideDelay, validator:this.cfg.checkNumber } );
 
+	/**
+	* Specifies the Tooltip's text.
+	* @config text
+	* @type String
+	* @default null
+	*/
 	this.cfg.addProperty("text",				{ handler:this.configText, suppressEvent:true } );
+
+	/**
+	* Specifies the container element that the Tooltip's markup should be rendered into.
+	* @config container
+	* @type HTMLElement/String
+	* @default document.body
+	*/
 	this.cfg.addProperty("container",			{ value:document.body, handler:this.configContainer } );
+
+	/**
+	* Specifies the element or elements that the Tooltip should be anchored to on mouseover.
+	* @config context
+	* @type HTMLElement[]/String[]
+	* @default null
+	*/
+
 };
 
 // BEGIN BUILT-IN PROPERTY EVENT HANDLERS //
 
 /**
 * The default event handler fired when the "text" property is changed.
+* @method configText
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Tooltip.prototype.configText = function(type, args, obj) {
 	var text = args[0];
@@ -2366,6 +2776,10 @@
 
 /**
 * The default event handler fired when the "container" property is changed.
+* @method configContainer
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Tooltip.prototype.configContainer = function(type, args, obj) {
 	var container = args[0];
@@ -2376,11 +2790,15 @@
 
 /**
 * The default event handler fired when the "context" property is changed.
+* @method configContext
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Tooltip.prototype.configContext = function(type, args, obj) {
 	var context = args[0];
 	if (context) {
-		
+
 		// Normalize parameter into an array
 		if (! (context instanceof Array)) {
 			if (typeof context == "string") {
@@ -2419,8 +2837,9 @@
 
 /**
 * The default event handler fired when the user moves the mouse while over the context element.
+* @method onContextMouseMove
 * @param {DOMEvent} e	The current DOM event
-* @param {object}	obj	The object argument
+* @param {Object}	obj	The object argument
 */
 YAHOO.widget.Tooltip.prototype.onContextMouseMove = function(e, obj) {
 	obj.pageX = YAHOO.util.Event.getPageX(e);
@@ -2430,8 +2849,9 @@
 
 /**
 * The default event handler fired when the user mouses over the context element.
+* @method onContextMouseOver
 * @param {DOMEvent} e	The current DOM event
-* @param {object}	obj	The object argument
+* @param {Object}	obj	The object argument
 */
 YAHOO.widget.Tooltip.prototype.onContextMouseOver = function(e, obj) {
 
@@ -2440,7 +2860,7 @@
 		obj.logger.log("Clearing hide timer: " + obj.hideProcId, "time");
 		obj.hideProcId = null;
 	}
-	
+
 	var context = this;
 	YAHOO.util.Event.addListener(context, "mousemove", obj.onContextMouseMove, obj);
 
@@ -2459,8 +2879,9 @@
 
 /**
 * The default event handler fired when the user mouses out of the context element.
+* @method onContextMouseOut
 * @param {DOMEvent} e	The current DOM event
-* @param {object}	obj	The object argument
+* @param {Object}	obj	The object argument
 */
 YAHOO.widget.Tooltip.prototype.onContextMouseOut = function(e, obj) {
 	var el = this;
@@ -2469,11 +2890,11 @@
 		el.title = obj._tempTitle;
 		obj._tempTitle = null;
 	}
-	
+
 	if (obj.showProcId) {
 		clearTimeout(obj.showProcId);
 		obj.logger.log("Clearing show timer: " + obj.showProcId, "time");
-		obj.showProcId = null;		
+		obj.showProcId = null;
 	}
 
 	if (obj.hideProcId) {
@@ -2492,11 +2913,12 @@
 
 /**
 * Processes the showing of the Tooltip by setting the timeout delay and offset of the Tooltip.
+* @method doShow
 * @param {DOMEvent} e	The current DOM event
-* @return {int}	The process ID of the timeout function associated with doShow
+* @return {Number}	The process ID of the timeout function associated with doShow
 */
 YAHOO.widget.Tooltip.prototype.doShow = function(e, context) {
-	
+
 	var yOffset = 25;
 	if (this.browser == "opera" && context.tagName == "A") {
 		yOffset += 12;
@@ -2516,7 +2938,7 @@
 			if (me.cfg.getProperty("preventoverlap")) {
 				me.preventOverlap(me.pageX, me.pageY);
 			}
-			
+
 			YAHOO.util.Event.removeListener(context, "mousemove", me.onContextMouseMove);
 
 			me.show();
@@ -2528,6 +2950,7 @@
 
 /**
 * Sets the timeout for the auto-dismiss delay, which by default is 5 seconds, meaning that a tooltip will automatically dismiss itself after 5 seconds of being displayed.
+* @method doHide
 */
 YAHOO.widget.Tooltip.prototype.doHide = function() {
 	var me = this;
@@ -2542,11 +2965,14 @@
 
 /**
 * Fired when the Tooltip is moved, this event handler is used to prevent the Tooltip from overlapping with its context element.
+* @method preventOverlay
+* @param {Number} pageX	The x coordinate position of the mouse pointer
+* @param {Number} pageY	The y coordinate position of the mouse pointer
 */
 YAHOO.widget.Tooltip.prototype.preventOverlap = function(pageX, pageY) {
-	
+
 	var height = this.element.offsetHeight;
-	
+
 	var elementRegion = YAHOO.util.Dom.getRegion(this.element);
 
 	elementRegion.top -= 5;
@@ -2555,7 +2981,7 @@
 	elementRegion.bottom += 5;
 
 	var mousePoint = new YAHOO.util.Point(pageX, pageY);
-	
+
 	this.logger.log("context " + elementRegion, "ttip");
 	this.logger.log("mouse " + mousePoint, "ttip");
 
@@ -2567,19 +2993,22 @@
 
 /**
 * Returns a string representation of the object.
-* @type string
-*/ 
+* @method toString
+* @return {String}	The string representation of the Tooltip
+*/
 YAHOO.widget.Tooltip.prototype.toString = function() {
 	return "Tooltip " + this.id;
 };
 
 /**
 * Panel is an implementation of Overlay that behaves like an OS window, with a draggable header and an optional close icon at the top right.
+* @namespace YAHOO.widget
+* @class Panel
 * @extends YAHOO.widget.Overlay
-* @param {string}	el	The element ID representing the Panel <em>OR</em>
-* @param {Element}	el	The element representing the Panel
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Panel. See configuration documentation for more details.
 * @constructor
+* @param {String}	el	The element ID representing the Panel <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Panel
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Panel. See configuration documentation for more details.
 */
 YAHOO.widget.Panel = function(el, userConfig) {
 	YAHOO.widget.Panel.superclass.constructor.call(this, el, userConfig);
@@ -2589,47 +3018,38 @@
 
 /**
 * Constant representing the default CSS class used for a Panel
-* @type string
+* @property YAHOO.widget.Panel.CSS_PANEL
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Panel.CSS_PANEL = "panel";
 
 /**
 * Constant representing the default CSS class used for a Panel's wrapping container
-* @type string
+* @property YAHOO.widget.Panel.CSS_PANEL_CONTAINER
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Panel.CSS_PANEL_CONTAINER = "panel-container";
 
 /**
-* CustomEvent fired after the modality mask is shown
-* args: none
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Panel.prototype.showMaskEvent = null;
-
-/**
-* CustomEvent fired after the modality mask is hidden
-* args: none
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Panel.prototype.hideMaskEvent = null;
-
-/**
 * The Overlay initialization method, which is executed for Overlay and all of its subclasses. This method is automatically called by the constructor, and  sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.
-* @param {string}	el	The element ID representing the Overlay <em>OR</em>
-* @param {Element}	el	The element representing the Overlay
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
+* @method init
+* @param {String}	el	The element ID representing the Overlay <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Overlay
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.
 */
 YAHOO.widget.Panel.prototype.init = function(el, userConfig) {
 	YAHOO.widget.Panel.superclass.init.call(this, el/*, userConfig*/);  // Note that we don't pass the user config in here yet because we only want it executed once, at the lowest subclass level
-	
+
 	this.beforeInitEvent.fire(YAHOO.widget.Panel);
 
 	YAHOO.util.Dom.addClass(this.element, YAHOO.widget.Panel.CSS_PANEL);
 
-	this.buildWrapper();			
-	
+	this.buildWrapper();
+
 	if (userConfig) {
 		this.cfg.applyConfig(userConfig, true);
 	}
@@ -2638,35 +3058,42 @@
 		var draggable = this.cfg.getProperty("draggable");
 		if (draggable) {
 			if (! this.header) {
-				this.setHeader("&nbsp;");
+				this.setHeader("&#160;");
 			}
 		}
 	}, this, true);
 
 	var me = this;
 
+	var doBlur = function() {
+		this.blur();
+	};
+
 	this.showMaskEvent.subscribe(function() {
 		var checkFocusable = function(el) {
-			if (el.tagName == "A" || el.tagName == "BUTTON" || el.tagName == "SELECT" || el.tagName == "INPUT" || el.tagName == "TEXTAREA" || el.tagName == "FORM") {
+			if ((el.tagName == "A" || el.tagName == "BUTTON" || el.tagName == "SELECT" || el.tagName == "INPUT" || el.tagName == "TEXTAREA" || el.tagName == "FORM") && el.type != "hidden") {
 				if (! YAHOO.util.Dom.isAncestor(me.element, el)) {
-					YAHOO.util.Event.addListener(el, "focus", el.blur);
+					YAHOO.util.Event.addListener(el, "focus", doBlur, el, true);
 					return true;
 				}
 			} else {
 				return false;
 			}
 		};
-		
+
 		this.focusableElements = YAHOO.util.Dom.getElementsBy(checkFocusable);
 	}, this, true);
 
 	this.hideMaskEvent.subscribe(function() {
 		for (var i=0;i<this.focusableElements.length;i++) {
 			var el2 = this.focusableElements[i];
-			YAHOO.util.Event.removeListener(el2, "focus", el2.blur);
+			YAHOO.util.Event.removeListener(el2, "focus", doBlur);
 		}
 	}, this, true);
 
+	this.beforeShowEvent.subscribe(function() {
+		this.cfg.refireEvent("underlay");
+	}, this, true);
 	this.initEvent.fire(YAHOO.widget.Panel);
 };
 
@@ -2676,33 +3103,83 @@
 YAHOO.widget.Panel.prototype.initEvents = function() {
 	YAHOO.widget.Panel.superclass.initEvents.call(this);
 
+	/**
+	* CustomEvent fired after the modality mask is shown
+	* @event showMaskEvent
+	*/
 	this.showMaskEvent = new YAHOO.util.CustomEvent("showMask");
+
+	/**
+	* CustomEvent fired after the modality mask is hidden
+	* @event hideMaskEvent
+	*/
 	this.hideMaskEvent = new YAHOO.util.CustomEvent("hideMask");
 
+	/**
+	* CustomEvent when the Panel is dragged
+	* @event dragEvent
+	*/
 	this.dragEvent = new YAHOO.util.CustomEvent("drag");
 };
 
 /**
 * Initializes the class's configurable properties which can be changed using the Panel's Config object (cfg).
+* @method initDefaultConfig
 */
 YAHOO.widget.Panel.prototype.initDefaultConfig = function() {
 	YAHOO.widget.Panel.superclass.initDefaultConfig.call(this);
 
 	// Add panel config properties //
 
+	/**
+	* True if the Panel should display a "close" button
+	* @config close
+	* @type Boolean
+	* @default true
+	*/
 	this.cfg.addProperty("close", { value:true, handler:this.configClose, validator:this.cfg.checkBoolean, supercedes:["visible"] } );
+
+	/**
+	* True if the Panel should be draggable
+	* @config draggable
+	* @type Boolean
+	* @default true
+	*/
 	this.cfg.addProperty("draggable", { value:true,	handler:this.configDraggable, validator:this.cfg.checkBoolean, supercedes:["visible"] } );
 
+	/**
+	* Sets the type of underlay to display for the Panel. Valid values are "shadow", "matte", and "none".
+	* @config underlay
+	* @type String
+	* @default shadow
+	*/
 	this.cfg.addProperty("underlay", { value:"shadow", handler:this.configUnderlay, supercedes:["visible"] } );
+
+	/**
+	* True if the Panel should be displayed in a modal fashion, automatically creating a transparent mask over the document that will not be removed until the Panel is dismissed.
+	* @config modal
+	* @type Boolean
+	* @default false
+	*/
 	this.cfg.addProperty("modal",	{ value:false, handler:this.configModal, validator:this.cfg.checkBoolean, supercedes:["visible"] } );
 
+	/**
+	* A KeyListener (or array of KeyListeners) that will be enabled when the Panel is shown, and disabled when the Panel is hidden.
+	* @config keylisteners
+	* @type YAHOO.util.KeyListener[]
+	* @default null
+	*/
 	this.cfg.addProperty("keylisteners", { handler:this.configKeyListeners, suppressEvent:true, supercedes:["visible"] } );
 };
 
 // BEGIN BUILT-IN PROPERTY EVENT HANDLERS //
 
 /**
 * The default event handler fired when the "close" property is changed. The method controls the appending or hiding of the close icon at the top right of the Panel.
+* @method configClose
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Panel.prototype.configClose = function(type, args, obj) {
 	var val = args[0];
@@ -2722,9 +3199,9 @@
 				YAHOO.util.Dom.addClass(this.close, "nonsecure");
 			}
 
-			this.close.innerHTML = "&nbsp;";
+			this.close.innerHTML = "&#160;";
 			this.innerElement.appendChild(this.close);
-			YAHOO.util.Event.addListener(this.close, "click", doHide, this);	
+			YAHOO.util.Event.addListener(this.close, "click", doHide, this);
 		} else {
 			this.close.style.display = "block";
 		}
@@ -2737,6 +3214,10 @@
 
 /**
 * The default event handler fired when the "draggable" property is changed.
+* @method configDraggable
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Panel.prototype.configDraggable = function(type, args, obj) {
 	var val = args[0];
@@ -2757,6 +3238,10 @@
 
 /**
 * The default event handler fired when the "underlay" property is changed.
+* @method configUnderlay
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Panel.prototype.configUnderlay = function(type, args, obj) {
 	var val = args[0];
@@ -2769,9 +3254,9 @@
 			if (! this.underlay) { // create if not already in DOM
 				this.underlay = document.createElement("DIV");
 				this.underlay.className = "underlay";
-				this.underlay.innerHTML = "&nbsp;";
+				this.underlay.innerHTML = "&#160;";
 				this.element.appendChild(this.underlay);
-			} 
+			}
 
 			this.sizeUnderlay();
 			break;
@@ -2788,32 +3273,59 @@
 
 /**
 * The default event handler fired when the "modal" property is changed. This handler subscribes or unsubscribes to the show and hide events to handle the display or hide of the modality mask.
+* @method configModal
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Panel.prototype.configModal = function(type, args, obj) {
 	var modal = args[0];
 
 	if (modal) {
 		this.buildMask();
 
-		if (! YAHOO.util.Config.alreadySubscribed( this.showEvent, this.showMask, this ) ) {
-			this.showEvent.subscribe(this.showMask, this, true);
+		if (! YAHOO.util.Config.alreadySubscribed( this.beforeShowEvent, this.showMask, this ) ) {
+			this.beforeShowEvent.subscribe(this.showMask, this, true);
 		}
 		if (! YAHOO.util.Config.alreadySubscribed( this.hideEvent, this.hideMask, this) ) {
 			this.hideEvent.subscribe(this.hideMask, this, true);
 		}
 		if (! YAHOO.util.Config.alreadySubscribed( YAHOO.widget.Overlay.windowResizeEvent, this.sizeMask, this ) ) {
 			YAHOO.widget.Overlay.windowResizeEvent.subscribe(this.sizeMask, this, true);
 		}
+		if (! YAHOO.util.Config.alreadySubscribed( this.destroyEvent, this.removeMask, this) ) {
+			this.destroyEvent.subscribe(this.removeMask, this, true);
+		}
+
+		this.cfg.refireEvent("zIndex");
 	} else {
 		this.beforeShowEvent.unsubscribe(this.showMask, this);
 		this.hideEvent.unsubscribe(this.hideMask, this);
-		YAHOO.widget.Overlay.windowResizeEvent.unsubscribe(this.sizeMask);
+		YAHOO.widget.Overlay.windowResizeEvent.unsubscribe(this.sizeMask, this);
+		this.destroyEvent.unsubscribe(this.removeMask, this);
 	}
 };
 
 /**
-* The default event handler fired when the "keylisteners" property is changed. 
+* Removes the modality mask.
+* @method removeMask
 */
+YAHOO.widget.Panel.prototype.removeMask = function() {
+	if (this.mask) {
+		if (this.mask.parentNode) {
+			this.mask.parentNode.removeChild(this.mask);
+		}
+		this.mask = null;
+	}
+};
+
+/**
+* The default event handler fired when the "keylisteners" property is changed.
+* @method configKeyListeners
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+*/
 YAHOO.widget.Panel.prototype.configKeyListeners = function(type, args, obj) {
 	var listeners = args[0];
 
@@ -2836,64 +3348,100 @@
 			}
 			if (! YAHOO.util.Config.alreadySubscribed(this.hideEvent, listeners.disable, listeners)) {
 				this.hideEvent.subscribe(listeners.disable, listeners, true);
-				this.destroyEvent.subscribe(listeners.disable, listeners, true); 
+				this.destroyEvent.subscribe(listeners.disable, listeners, true);
 			}
 		}
-	} 
+	}
 };
 
+/**
+* The default event handler fired when the "height" property is changed.
+* @method configHeight
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+*/
+YAHOO.widget.Panel.prototype.configHeight = function(type, args, obj) {
+	var height = args[0];
+	var el = this.innerElement;
+	YAHOO.util.Dom.setStyle(el, "height", height);
+	this.cfg.refireEvent("underlay");
+	this.cfg.refireEvent("iframe");
+};
+
+/**
+* The default event handler fired when the "width" property is changed.
+* @method configWidth
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+*/
+YAHOO.widget.Panel.prototype.configWidth = function(type, args, obj) {
+	var width = args[0];
+	var el = this.innerElement;
+	YAHOO.util.Dom.setStyle(el, "width", width);
+	this.cfg.refireEvent("underlay");
+	this.cfg.refireEvent("iframe");
+};
+
+/**
+* The default event handler fired when the "zIndex" property is changed.
+* @method configzIndex
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+*/
+YAHOO.widget.Panel.prototype.configzIndex = function(type, args, obj) {
+	YAHOO.widget.Panel.superclass.configzIndex.call(this, type, args, obj);
+
+	var maskZ = 0;
+	var currentZ = YAHOO.util.Dom.getStyle(this.element, "zIndex");
+
+	if (this.mask) {
+		if (! currentZ || isNaN(currentZ)) {
+			currentZ = 0;
+		}
+
+		if (currentZ === 0) {
+			this.cfg.setProperty("zIndex", 1);
+		} else {
+			maskZ = currentZ - 1;
+			YAHOO.util.Dom.setStyle(this.mask, "zIndex", maskZ);
+		}
+
+	}
+};
+
 // END BUILT-IN PROPERTY EVENT HANDLERS //
 
 
 /**
 * Builds the wrapping container around the Panel that is used for positioning the shadow and matte underlays. The container element is assigned to a  local instance variable called container, and the element is reinserted inside of it.
+* @method buildWrapper
 */
 YAHOO.widget.Panel.prototype.buildWrapper = function() {
 	var elementParent = this.element.parentNode;
+	var originalElement = this.element;
 
-	var elementClone = this.element.cloneNode(true);
-	this.innerElement = elementClone;
-	this.innerElement.style.visibility = "inherit";
-
-	YAHOO.util.Dom.addClass(this.innerElement, YAHOO.widget.Panel.CSS_PANEL);
-
 	var wrapper = document.createElement("DIV");
 	wrapper.className = YAHOO.widget.Panel.CSS_PANEL_CONTAINER;
-	wrapper.id = elementClone.id + "_c";
-	
-	wrapper.appendChild(elementClone);
-	
+	wrapper.id = originalElement.id + "_c";
+
 	if (elementParent) {
-		elementParent.replaceChild(wrapper, this.element);
+		elementParent.insertBefore(wrapper, originalElement);
 	}
 
+	wrapper.appendChild(originalElement);
+
 	this.element = wrapper;
+	this.innerElement = originalElement;
 
-	// Resynchronize the local field references
-
-	var childNodes = this.innerElement.childNodes;
-	if (childNodes) {
-		for (var i=0;i<childNodes.length;i++) {
-			var child = childNodes[i];
-			switch (child.className) {
-				case YAHOO.widget.Module.CSS_HEADER:
-					this.header = child;
-					break;
-				case YAHOO.widget.Module.CSS_BODY:
-					this.body = child;
-					break;
-				case YAHOO.widget.Module.CSS_FOOTER:
-					this.footer = child;
-					break;
-			}
-		}
-	}
-
-	this.initDefaultConfig(); // We've changed the DOM, so the configuration must be re-tooled to get the DOM references right
+	YAHOO.util.Dom.setStyle(this.innerElement, "visibility", "inherit");
 };
 
 /**
 * Adjusts the size of the shadow based on the size of the element.
+* @method sizeUnderlay
 */
 YAHOO.widget.Panel.prototype.sizeUnderlay = function() {
 	if (this.underlay && this.browser != "gecko" && this.browser != "safari") {
@@ -2904,8 +3452,11 @@
 
 /**
 * Event handler fired when the resize monitor element is resized.
+* @method onDomResize
+* @param {DOMEvent} e	The resize DOM event
+* @param {Object} obj	The scope object
 */
-YAHOO.widget.Panel.prototype.onDomResize = function(e, obj) { 
+YAHOO.widget.Panel.prototype.onDomResize = function(e, obj) {
 	YAHOO.widget.Panel.superclass.onDomResize.call(this, e, obj);
 	var me = this;
 	setTimeout(function() {
@@ -2915,6 +3466,7 @@
 
 /**
 * Registers the Panel's header for drag & drop capability.
+* @method registerDragDrop
 */
 YAHOO.widget.Panel.prototype.registerDragDrop = function() {
 	if (this.header) {
@@ -2923,7 +3475,7 @@
 		if (! this.header.id) {
 			this.header.id = this.id + "_h";
 		}
-		
+
 		var me = this;
 
 		this.dd.startDrag = function() {
@@ -2961,7 +3513,7 @@
 
 			me.dragEvent.fire("startDrag", arguments);
 		};
-		
+
 		this.dd.onDrag = function() {
 			me.syncPosition();
 			me.cfg.refireEvent("iframe");
@@ -2989,13 +3541,14 @@
 
 /**
 * Builds the mask that is laid over the document when the Panel is configured to be modal.
+* @method buildMask
 */
 YAHOO.widget.Panel.prototype.buildMask = function() {
 	if (! this.mask) {
 		this.mask = document.createElement("DIV");
 		this.mask.id = this.id + "_mask";
 		this.mask.className = "mask";
-		this.mask.innerHTML = "&nbsp;";
+		this.mask.innerHTML = "&#160;";
 
 		var maskClick = function(e, obj) {
 			YAHOO.util.Event.stopEvent(e);
@@ -3012,6 +3565,7 @@
 
 /**
 * Hides the modality mask.
+* @method hideMask
 */
 YAHOO.widget.Panel.prototype.hideMask = function() {
 	if (this.cfg.getProperty("modal") && this.mask) {
@@ -3023,6 +3577,7 @@
 
 /**
 * Shows the modality mask.
+* @method showMask
 */
 YAHOO.widget.Panel.prototype.showMask = function() {
 	if (this.cfg.getProperty("modal") && this.mask) {
@@ -3035,6 +3590,7 @@
 
 /**
 * Sets the size of the modality mask to cover the entire scrollable area of the document
+* @method sizeMask
 */
 YAHOO.widget.Panel.prototype.sizeMask = function() {
 	if (this.mask) {
@@ -3044,52 +3600,34 @@
 };
 
 /**
-* The default event handler fired when the "height" property is changed.
-*/
-YAHOO.widget.Panel.prototype.configHeight = function(type, args, obj) {
-	var height = args[0];
-	var el = this.innerElement;
-	YAHOO.util.Dom.setStyle(el, "height", height);
-	this.cfg.refireEvent("underlay");
-	this.cfg.refireEvent("iframe");
-};
-
-/**
-* The default event handler fired when the "width" property is changed.
-*/
-YAHOO.widget.Panel.prototype.configWidth = function(type, args, obj) {
-	var width = args[0];
-	var el = this.innerElement;
-	YAHOO.util.Dom.setStyle(el, "width", width);
-	this.cfg.refireEvent("underlay");
-	this.cfg.refireEvent("iframe");
-};
-
-/**
 * Renders the Panel by inserting the elements that are not already in the main Panel into their correct places. Optionally appends the Panel to the specified node prior to the render's execution. NOTE: For Panels without existing markup, the appendToNode argument is REQUIRED. If this argument is ommitted and the current element is not present in the document, the function will return false, indicating that the render was a failure.
-* @param {string}	appendToNode	The element id to which the Module should be appended to prior to rendering <em>OR</em>
-* @param {Element}	appendToNode	The element to which the Module should be appended to prior to rendering	
+* @method render
+* @param {String}	appendToNode	The element id to which the Module should be appended to prior to rendering <em>OR</em>
+* @param {HTMLElement}	appendToNode	The element to which the Module should be appended to prior to rendering
 * @return {boolean} Success or failure of the render
 */
 YAHOO.widget.Panel.prototype.render = function(appendToNode) {
 	return YAHOO.widget.Panel.superclass.render.call(this, appendToNode, this.innerElement);
 };
 
 /**
-* Returns a string representation of the object.
-* @type string
-*/ 
+* Returns a String representation of the object.
+* @method toString
+* @return {String} The string representation of the Panel.
+*/
 YAHOO.widget.Panel.prototype.toString = function() {
 	return "Panel " + this.id;
 };
 
 /**
 * Dialog is an implementation of Panel that can be used to submit form data. Built-in functionality for buttons with event handlers is included, and button sets can be build dynamically, or the preincluded ones for Submit/Cancel and OK/Cancel can be utilized. Forms can be processed in 3 ways -- via an asynchronous Connection utility call, a simple form POST or GET, or manually.
+* @namespace YAHOO.widget
+* @class Dialog
 * @extends YAHOO.widget.Panel
-* @param {string}	el	The element ID representing the Dialog <em>OR</em>
-* @param {Element}	el	The element representing the Dialog
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Dialog. See configuration documentation for more details.
 * @constructor
+* @param {String}	el	The element ID representing the Dialog <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Dialog
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Dialog. See configuration documentation for more details.
 */
 YAHOO.widget.Dialog = function(el, userConfig) {
 	YAHOO.widget.Dialog.superclass.constructor.call(this, el, userConfig);
@@ -3099,122 +3637,125 @@
 
 /**
 * Constant representing the default CSS class used for a Dialog
-* @type string
+* @property YAHOO.widget.Dialog.CSS_DIALOG
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.Dialog.CSS_DIALOG = "dialog";
 
-
 /**
-* CustomEvent fired prior to submission
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Dialog.prototype.beforeSubmitEvent = null;
-
-/**
-* CustomEvent fired after submission
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Dialog.prototype.submitEvent = null;
-
-/**
-* CustomEvent fired prior to manual submission
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Dialog.prototype.manualSubmitEvent = null;
-
-/**
-* CustomEvent fired prior to asynchronous submission
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Dialog.prototype.asyncSubmitEvent = null;
-
-/**
-* CustomEvent fired prior to form-based submission
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Dialog.prototype.formSubmitEvent = null;
-
-/**
-* CustomEvent fired after cancel
-* @type YAHOO.util.CustomEvent
-*/
-YAHOO.widget.Dialog.prototype.cancelEvent = null;
-
-
-/**
 * Initializes the class's configurable properties which can be changed using the Dialog's Config object (cfg).
+* @method initDefaultConfig
 */
 YAHOO.widget.Dialog.prototype.initDefaultConfig = function() {
 	YAHOO.widget.Dialog.superclass.initDefaultConfig.call(this);
 
 	/**
 	* The internally maintained callback object for use with the Connection utility
-	* @type object
-	* @private
+	* @property callback
+	* @type Object
 	*/
 	this.callback = {
+		/**
+		* The function to execute upon success of the Connection submission
+		* @property callback.success
+		* @type Function
+		*/
 		success : null,
+		/**
+		* The function to execute upon failure of the Connection submission
+		* @property callback.failure
+		* @type Function
+		*/
 		failure : null,
+		/**
+		* The arbitraty argument or arguments to pass to the Connection callback functions
+		* @property callback.argument
+		* @type Object
+		*/
 		argument: null
 	};
 
-	this.doSubmit = function() {
-		var method = this.cfg.getProperty("postmethod");
-		switch (method) {
-			case "async":
-				YAHOO.util.Connect.setForm(this.form);
-				var cObj = YAHOO.util.Connect.asyncRequest('POST', this.form.action, this.callback);
-				this.asyncSubmitEvent.fire();
-				break;
-			case "form":
-				this.form.submit();
-				this.formSubmitEvent.fire();
-				break;
-			case "none":
-			case "manual":
-				this.manualSubmitEvent.fire();
-				break;
-		}
-	};
-
 	// Add form dialog config properties //
-	this.cfg.addProperty("postmethod", { value:"async", validator:function(val) { 
+
+	/**
+	* The method to use for posting the Dialog's form. Possible values are "async", "form", and "manual".
+	* @config postmethod
+	* @type String
+	* @default async
+	*/
+	this.cfg.addProperty("postmethod", { value:"async", handler:this.configPostMethod, validator:function(val) {
 													if (val != "form" && val != "async" && val != "none" && val != "manual") {
 														return false;
 													} else {
 														return true;
 													}
 												} });
 
+	/**
+	* Object literal(s) defining the buttons for the Dialog's footer.
+	* @config buttons
+	* @type Object[]
+	* @default "none"
+	*/
 	this.cfg.addProperty("buttons",		{ value:"none",	handler:this.configButtons } );
 };
 
 /**
 * Initializes the custom events for Dialog which are fired automatically at appropriate times by the Dialog class.
+* @method initEvents
 */
 YAHOO.widget.Dialog.prototype.initEvents = function() {
 	YAHOO.widget.Dialog.superclass.initEvents.call(this);
-	
+
+	/**
+	* CustomEvent fired prior to submission
+	* @event beforeSumitEvent
+	*/
 	this.beforeSubmitEvent	= new YAHOO.util.CustomEvent("beforeSubmit");
+
+	/**
+	* CustomEvent fired after submission
+	* @event submitEvent
+	*/
 	this.submitEvent		= new YAHOO.util.CustomEvent("submit");
 
+	/**
+	* CustomEvent fired prior to manual submission
+	* @event manualSubmitEvent
+	*/
 	this.manualSubmitEvent	= new YAHOO.util.CustomEvent("manualSubmit");
+
+	/**
+	* CustomEvent fired prior to asynchronous submission
+	* @event asyncSubmitEvent
+	*/
 	this.asyncSubmitEvent	= new YAHOO.util.CustomEvent("asyncSubmit");
+
+	/**
+	* CustomEvent fired prior to form-based submission
+	* @event formSubmitEvent
+	*/
 	this.formSubmitEvent	= new YAHOO.util.CustomEvent("formSubmit");
 
+	/**
+	* CustomEvent fired after cancel
+	* @event cancelEvent
+	*/
 	this.cancelEvent		= new YAHOO.util.CustomEvent("cancel");
 };
 
 /**
 * The Dialog initialization method, which is executed for Dialog and all of its subclasses. This method is automatically called by the constructor, and  sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.
-* @param {string}	el	The element ID representing the Dialog <em>OR</em>
-* @param {Element}	el	The element representing the Dialog
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this Dialog. See configuration documentation for more details.
+* @method init
+* @param {String}	el	The element ID representing the Dialog <em>OR</em>
+* @param {HTMLElement}	el	The element representing the Dialog
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this Dialog. See configuration documentation for more details.
 */
 YAHOO.widget.Dialog.prototype.init = function(el, userConfig) {
 	YAHOO.widget.Dialog.superclass.init.call(this, el/*, userConfig*/);  // Note that we don't pass the user config in here yet because we only want it executed once, at the lowest subclass level
-	
+
 	this.beforeInitEvent.fire(YAHOO.widget.Dialog);
 
 	YAHOO.util.Dom.addClass(this.element, YAHOO.widget.Dialog.CSS_DIALOG);
@@ -3225,8 +3766,6 @@
 		this.cfg.applyConfig(userConfig, true);
 	}
 
-	this.renderEvent.subscribe(this.registerForm, this, true);
-
 	this.showEvent.subscribe(this.focusFirst, this, true);
 	this.beforeHideEvent.subscribe(this.blurButtons, this, true);
 
@@ -3243,7 +3782,33 @@
 };
 
 /**
+* Performs the submission of the Dialog form depending on the value of "postmethod" property.
+* @method doSubmit
+*/
+YAHOO.widget.Dialog.prototype.doSubmit = function() {
+	var pm = this.cfg.getProperty("postmethod");
+	switch (pm) {
+		case "async":
+			var method = this.form.getAttribute("method") || 'POST';
+			method = method.toUpperCase();
+			YAHOO.util.Connect.setForm(this.form);
+			var cObj = YAHOO.util.Connect.asyncRequest(method, this.form.getAttribute("action"), this.callback);
+			this.asyncSubmitEvent.fire();
+			break;
+		case "form":
+			this.form.submit();
+			this.formSubmitEvent.fire();
+			break;
+		case "none":
+		case "manual":
+			this.manualSubmitEvent.fire();
+			break;
+	}
+};
+
+/**
 * Prepares the Dialog's internal FORM object, creating one if one is not currently present.
+* @method registerForm
 */
 YAHOO.widget.Dialog.prototype.registerForm = function() {
 	var form = this.element.getElementsByTagName("FORM")[0];
@@ -3283,7 +3848,7 @@
 	if (this.cfg.getProperty("modal") && this.form) {
 
 		var me = this;
-		
+
 		var firstElement = this.firstFormElement || this.firstButton;
 		if (firstElement) {
 			this.preventBackTab = new YAHOO.util.KeyListener(firstElement, { shift:true, keys:9 }, {fn:me.focusLast, scope:me, correctScope:true} );
@@ -3304,6 +3869,10 @@
 
 /**
 * The default event handler for the "buttons" configuration property
+* @method configButtons
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.Dialog.prototype.configButtons = function(type, args, obj) {
 	var buttons = args[0];
@@ -3326,7 +3895,7 @@
 			htmlButton.appendChild(document.createTextNode(button.text));
 			YAHOO.util.Event.addListener(htmlButton, "click", button.handler, this, true);
 
-			this.buttonSpan.appendChild(htmlButton);		
+			this.buttonSpan.appendChild(htmlButton);
 			button.htmlButton = htmlButton;
 
 			if (b === 0) {
@@ -3357,23 +3926,10 @@
 	}
 };
 
-/**
-* The default handler fired when the "success" property is changed. Used for asynchronous submission only.
-*/ 
-YAHOO.widget.Dialog.prototype.configOnSuccess = function(type,args,obj){};
 
 /**
-* The default handler fired when the "failure" property is changed. Used for asynchronous submission only.
-*/ 
-YAHOO.widget.Dialog.prototype.configOnFailure = function(type,args,obj){};
-
-/**
-* Executes a submission of the form based on the value of the postmethod property.
-*/
-YAHOO.widget.Dialog.prototype.doSubmit = function() {};
-
-/**
 * The default event handler used to focus the first field of the form when the Dialog is shown.
+* @method focusFirst
 */
 YAHOO.widget.Dialog.prototype.focusFirst = function(type,args,obj) {
 	if (args) {
@@ -3392,6 +3948,7 @@
 
 /**
 * Sets the focus to the last button in the button or form element in the Dialog
+* @method focusLast
 */
 YAHOO.widget.Dialog.prototype.focusLast = function(type,args,obj) {
 	if (args) {
@@ -3413,6 +3970,7 @@
 
 /**
 * Sets the focus to the button that is designated as the default. By default, his handler is executed when the show event is fired.
+* @method focusDefaultButton
 */
 YAHOO.widget.Dialog.prototype.focusDefaultButton = function() {
 	if (this.defaultHtmlButton) {
@@ -3422,6 +3980,7 @@
 
 /**
 * Blurs all the html buttons
+* @method blurButtons
 */
 YAHOO.widget.Dialog.prototype.blurButtons = function() {
 	var buttons = this.cfg.getProperty("buttons");
@@ -3435,6 +3994,7 @@
 
 /**
 * Sets the focus to the first button in the button list
+* @method focusFirstButton
 */
 YAHOO.widget.Dialog.prototype.focusFirstButton = function() {
 	var buttons = this.cfg.getProperty("buttons");
@@ -3448,6 +4008,7 @@
 
 /**
 * Sets the focus to the first button in the button list
+* @method focusLastButton
 */
 YAHOO.widget.Dialog.prototype.focusLastButton = function() {
 	var buttons = this.cfg.getProperty("buttons");
@@ -3459,17 +4020,37 @@
 	}
 };
 
+/**
+* The default event handler for the "postmethod" configuration property
+* @method configPostMethod
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
+*/
+YAHOO.widget.Dialog.prototype.configPostMethod = function(type, args, obj) {
+	var postmethod = args[0];
+
+	this.registerForm();
+	YAHOO.util.Event.addListener(this.form, "submit", function(e) {
+														YAHOO.util.Event.stopEvent(e);
+														this.submit();
+														this.form.blur();
+													  }, this, true);
+};
+
 // END BUILT-IN PROPERTY EVENT HANDLERS //
 
 /**
 * Built-in function hook for writing a validation function that will be checked for a "true" value prior to a submit. This function, as implemented by default, always returns true, so it should be overridden if validation is necessary.
+* @method validate
 */
 YAHOO.widget.Dialog.prototype.validate = function() {
 	return true;
 };
 
 /**
 * Executes a submit of the Dialog followed by a hide, if validation is successful.
+* @method submit
 */
 YAHOO.widget.Dialog.prototype.submit = function() {
 	if (this.validate()) {
@@ -3485,40 +4066,42 @@
 
 /**
 * Executes the cancel of the Dialog followed by a hide.
+* @method cancel
 */
 YAHOO.widget.Dialog.prototype.cancel = function() {
 	this.cancelEvent.fire();
-	this.hide();	
+	this.hide();
 };
 
 /**
 * Returns a JSON-compatible data structure representing the data currently contained in the form.
-* @return {object} A JSON object reprsenting the data of the current form.
+* @method getData
+* @return {Object} A JSON object reprsenting the data of the current form.
 */
 YAHOO.widget.Dialog.prototype.getData = function() {
 	var form = this.form;
 	var data = {};
 
 	if (form) {
-		for (var i in this.form) {
-			var formItem = form[i];
+		for (var i=0;i<form.elements.length;i++) {
+			var formItem = form.elements[i];
 			if (formItem) {
 				if (formItem.tagName) { // Got a single form item
 					switch (formItem.tagName) {
 						case "INPUT":
 							switch (formItem.type) {
-								case "checkbox": 
-									data[i] = formItem.checked;
+								case "checkbox":
+									data[formItem.name] = formItem.checked;
 									break;
 								case "textbox":
 								case "text":
 								case "hidden":
-									data[i] = formItem.value;
+									data[formItem.name] = formItem.value;
 									break;
 							}
 							break;
 						case "TEXTAREA":
-							data[i] = formItem.value;
+							data[formItem.name] = formItem.value;
 							break;
 						case "SELECT":
 							var val = [];
@@ -3532,56 +4115,58 @@
 									val[val.length] = selval;
 								}
 							}
-							data[i] = val;
+							data[formItem.name] = val;
 							break;
 					}
 				} else if (formItem[0] && formItem[0].tagName) { // this is an array of form items
-					switch (formItem[0].tagName) {
-						case "INPUT" :
-							switch (formItem[0].type) {
-								case "radio":
-									for (var r=0; r<formItem.length; r++) {
-										var radio = formItem[r];
-										if (radio.checked) {
-											data[radio.name] = radio.value;
-											break;
-										}
+					if (formItem[0].tagName == "INPUT") {
+						switch (formItem[0].type) {
+							case "radio":
+								for (var r=0; r<formItem.length; r++) {
+									var radio = formItem[r];
+									if (radio.checked) {
+										data[radio.name] = radio.value;
+										break;
 									}
-									break;
-								case "checkbox":
-									var cbArray = [];
-									for (var c=0; c<formItem.length; c++) {
-										var check = formItem[c];
-										if (check.checked) {
-											cbArray[cbArray.length] = check.value;
-										}
+								}
+								break;
+							case "checkbox":
+								var cbArray = [];
+								for (var c=0; c<formItem.length; c++) {
+									var check = formItem[c];
+									if (check.checked) {
+										cbArray[cbArray.length] = check.value;
 									}
-									data[formItem[0].name] = cbArray;
-									break;
-							}
+								}
+								data[formItem[0].name] = cbArray;
+								break;
+						}
 					}
 				}
 			}
-		}	
+		}
 	}
 	return data;
 };
 
 /**
 * Returns a string representation of the object.
-* @type string
-*/ 
+* @method toString
+* @return {String}	The string representation of the Dialog
+*/
 YAHOO.widget.Dialog.prototype.toString = function() {
 	return "Dialog " + this.id;
 };
 
 /**
 * SimpleDialog is a simple implementation of Dialog that can be used to submit a single value. Forms can be processed in 3 ways -- via an asynchronous Connection utility call, a simple form POST or GET, or manually.
+* @namespace YAHOO.widget
+* @class SimpleDialog
 * @extends YAHOO.widget.Dialog
-* @param {string}	el	The element ID representing the SimpleDialog <em>OR</em>
-* @param {Element}	el	The element representing the SimpleDialog
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this SimpleDialog. See configuration documentation for more details.
 * @constructor
+* @param {String}	el	The element ID representing the SimpleDialog <em>OR</em>
+* @param {HTMLElement}	el	The element representing the SimpleDialog
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this SimpleDialog. See configuration documentation for more details.
 */
 YAHOO.widget.SimpleDialog = function(el, userConfig) {
 	YAHOO.widget.SimpleDialog.superclass.constructor.call(this, el, userConfig);
@@ -3591,70 +4176,100 @@
 
 /**
 * Constant for the standard network icon for a blocking action
-* @type string
+* @property YAHOO.widget.SimpleDialog.ICON_BLOCK
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.ICON_BLOCK = "nt/ic/ut/bsc/blck16_1.gif";
 
 /**
 * Constant for the standard network icon for alarm
-* @type string
+* @property YAHOO.widget.SimpleDialog.ICON_ALARM
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.ICON_ALARM = "nt/ic/ut/bsc/alrt16_1.gif";
 
 /**
 * Constant for the standard network icon for help
-* @type string
+* @property YAHOO.widget.SimpleDialog.ICON_HELP
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.ICON_HELP  = "nt/ic/ut/bsc/hlp16_1.gif";
 
 /**
 * Constant for the standard network icon for info
-* @type string
+* @property YAHOO.widget.SimpleDialog.ICON_INFO
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.ICON_INFO  = "nt/ic/ut/bsc/info16_1.gif";
 
 /**
 * Constant for the standard network icon for warn
-* @type string
+* @property YAHOO.widget.SimpleDialog.ICON_WARN
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.ICON_WARN  = "nt/ic/ut/bsc/warn16_1.gif";
 
 /**
 * Constant for the standard network icon for a tip
-* @type string
+* @property YAHOO.widget.SimpleDialog.ICON_TIP
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.ICON_TIP   = "nt/ic/ut/bsc/tip16_1.gif";
 
 /**
 * Constant representing the default CSS class used for a SimpleDialog
-* @type string
+* @property YAHOO.widget.SimpleDialog.CSS_SIMPLEDIALOG
+* @static
 * @final
+* @type String
 */
 YAHOO.widget.SimpleDialog.CSS_SIMPLEDIALOG = "simple-dialog";
 
 /**
 * Initializes the class's configurable properties which can be changed using the SimpleDialog's Config object (cfg).
+* @method initDefaultConfig
 */
 YAHOO.widget.SimpleDialog.prototype.initDefaultConfig = function() {
 	YAHOO.widget.SimpleDialog.superclass.initDefaultConfig.call(this);
 
 	// Add dialog config properties //
+
+	/**
+	* Sets the informational icon for the SimpleDialog
+	* @config icon
+	* @type String
+	* @default "none"
+	*/
 	this.cfg.addProperty("icon",	{ value:"none",	handler:this.configIcon, suppressEvent:true } );
+
+	/**
+	* Sets the text for the SimpleDialog
+	* @config text
+	* @type String
+	* @default ""
+	*/
 	this.cfg.addProperty("text",	{ value:"", handler:this.configText, suppressEvent:true, supercedes:["icon"] } );
 };
 
 
 /**
 * The SimpleDialog initialization method, which is executed for SimpleDialog and all of its subclasses. This method is automatically called by the constructor, and  sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.
-* @param {string}	el	The element ID representing the SimpleDialog <em>OR</em>
-* @param {Element}	el	The element representing the SimpleDialog
-* @param {object}	userConfig	The configuration object literal containing the configuration that should be set for this SimpleDialog. See configuration documentation for more details.
+* @method init
+* @param {String}	el	The element ID representing the SimpleDialog <em>OR</em>
+* @param {HTMLElement}	el	The element representing the SimpleDialog
+* @param {Object}	userConfig	The configuration object literal containing the configuration that should be set for this SimpleDialog. See configuration documentation for more details.
 */
 YAHOO.widget.SimpleDialog.prototype.init = function(el, userConfig) {
 	YAHOO.widget.SimpleDialog.superclass.init.call(this, el/*, userConfig*/);  // Note that we don't pass the user config in here yet because we only want it executed once, at the lowest subclass level
@@ -3680,6 +4295,7 @@
 };
 /**
 * Prepares the SimpleDialog's internal FORM object, creating one if one is not currently present, and adding the value hidden field.
+* @method registerForm
 */
 YAHOO.widget.SimpleDialog.prototype.registerForm = function() {
 	YAHOO.widget.SimpleDialog.superclass.registerForm.call(this);
@@ -3690,6 +4306,10 @@
 
 /**
 * Fired when the "icon" property is set.
+* @method configIcon
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.SimpleDialog.prototype.configIcon = function(type,args,obj) {
 	var icon = args[0];
@@ -3701,6 +4321,10 @@
 
 /**
 * Fired when the "text" property is set.
+* @method configText
+* @param {String} type	The CustomEvent type (usually the property name)
+* @param {Object[]}	args	The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
+* @param {Object} obj	The scope object. For configuration handlers, this will usually equal the owner.
 */
 YAHOO.widget.SimpleDialog.prototype.configText = function(type,args,obj) {
 	var text = args[0];
@@ -3713,20 +4337,23 @@
 
 /**
 * Returns a string representation of the object.
-* @type string
-*/ 
+* @method toString
+* @return {String}	The string representation of the SimpleDialog
+*/
 YAHOO.widget.SimpleDialog.prototype.toString = function() {
 	return "SimpleDialog " + this.id;
 };
 
 /**
 * ContainerEffect encapsulates animation transitions that are executed when an Overlay is shown or hidden.
-* @param {Overlay}	overlay		The Overlay that the animation should be associated with
-* @param {object}	attrIn		The object literal representing the animation arguments to be used for the animate-in transition. The arguments for this literal are: attributes(object, see YAHOO.util.Anim for description), duration(float), and method(i.e. YAHOO.util.Easing.easeIn).
-* @param {object}	attrOut		The object literal representing the animation arguments to be used for the animate-out transition. The arguments for this literal are: attributes(object, see YAHOO.util.Anim for description), duration(float), and method(i.e. YAHOO.util.Easing.easeIn).
-* @param {Element}	targetElement	Optional. The target element that should be animated during the transition. Defaults to overlay.element.
-* @param {class}	Optional. The animation class to instantiate. Defaults to YAHOO.util.Anim. Other options include YAHOO.util.Motion.
+* @namespace YAHOO.widget
+* @class ContainerEffect
 * @constructor
+* @param {YAHOO.widget.Overlay}	overlay		The Overlay that the animation should be associated with
+* @param {Object}	attrIn		The object literal representing the animation arguments to be used for the animate-in transition. The arguments for this literal are: attributes(object, see YAHOO.util.Anim for description), duration(Number), and method(i.e. YAHOO.util.Easing.easeIn).
+* @param {Object}	attrOut		The object literal representing the animation arguments to be used for the animate-out transition. The arguments for this literal are: attributes(object, see YAHOO.util.Anim for description), duration(Number), and method(i.e. YAHOO.util.Easing.easeIn).
+* @param {HTMLElement}	targetElement	Optional. The target element that should be animated during the transition. Defaults to overlay.element.
+* @param {class}	Optional. The animation class to instantiate. Defaults to YAHOO.util.Anim. Other options include YAHOO.util.Motion.
 */
 YAHOO.widget.ContainerEffect = function(overlay, attrIn, attrOut, targetElement, animClass) {
 	if (! animClass) {
@@ -3735,28 +4362,39 @@
 
 	/**
 	* The overlay to animate
+	* @property overlay
+	* @type YAHOO.widget.Overlay
 	*/
 	this.overlay = overlay;
 	/**
 	* The animation attributes to use when transitioning into view
+	* @property attrIn
+	* @type Object
 	*/
 	this.attrIn = attrIn;
 	/**
 	* The animation attributes to use when transitioning out of view
+	* @property attrOut
+	* @type Object
 	*/
 	this.attrOut = attrOut;
 	/**
 	* The target element to be animated
+	* @property targetElement
+	* @type HTMLElement
 	*/
 	this.targetElement = targetElement || overlay.element;
 	/**
 	* The animation class to use for animating the overlay
+	* @property animClass
+	* @type class
 	*/
 	this.animClass = animClass;
 };
 
 /**
 * Initializes the animation classes and events.
+* @method init
 */
 YAHOO.widget.ContainerEffect.prototype.init = function() {
 	this.beforeAnimateInEvent = new YAHOO.util.CustomEvent("beforeAnimateIn");
@@ -3778,6 +4416,7 @@
 
 /**
 * Triggers the in-animation.
+* @method animateIn
 */
 YAHOO.widget.ContainerEffect.prototype.animateIn = function() {
 	this.beforeAnimateInEvent.fire();
@@ -3786,6 +4425,7 @@
 
 /**
 * Triggers the out-animation.
+* @method animateOut
 */
 YAHOO.widget.ContainerEffect.prototype.animateOut = function() {
 	this.beforeAnimateOutEvent.fire();
@@ -3794,34 +4434,59 @@
 
 /**
 * The default onStart handler for the in-animation.
+* @method handleStartAnimateIn
+* @param {String} type	The CustomEvent type
+* @param {Object[]}	args	The CustomEvent arguments
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.ContainerEffect.prototype.handleStartAnimateIn = function(type, args, obj) { };
 /**
 * The default onTween handler for the in-animation.
+* @method handleTweenAnimateIn
+* @param {String} type	The CustomEvent type
+* @param {Object[]}	args	The CustomEvent arguments
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.ContainerEffect.prototype.handleTweenAnimateIn = function(type, args, obj) { };
 /**
 * The default onComplete handler for the in-animation.
+* @method handleCompleteAnimateIn
+* @param {String} type	The CustomEvent type
+* @param {Object[]}	args	The CustomEvent arguments
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.ContainerEffect.prototype.handleCompleteAnimateIn = function(type, args, obj) { };
 
 /**
 * The default onStart handler for the out-animation.
+* @method handleStartAnimateOut
+* @param {String} type	The CustomEvent type
+* @param {Object[]}	args	The CustomEvent arguments
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.ContainerEffect.prototype.handleStartAnimateOut = function(type, args, obj) { };
 /**
 * The default onTween handler for the out-animation.
+* @method handleTweenAnimateOut
+* @param {String} type	The CustomEvent type
+* @param {Object[]}	args	The CustomEvent arguments
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.ContainerEffect.prototype.handleTweenAnimateOut = function(type, args, obj) { };
 /**
 * The default onComplete handler for the out-animation.
+* @method handleCompleteAnimateOut
+* @param {String} type	The CustomEvent type
+* @param {Object[]}	args	The CustomEvent arguments
+* @param {Object} obj	The scope object
 */
 YAHOO.widget.ContainerEffect.prototype.handleCompleteAnimateOut = function(type, args, obj) { };
 
 /**
 * Returns a string representation of the object.
-* @type string
-*/ 
+* @method toString
+* @return {String}	The string representation of the ContainerEffect
+*/
 YAHOO.widget.ContainerEffect.prototype.toString = function() {
 	var output = "ContainerEffect";
 	if (this.overlay) {
@@ -3832,16 +4497,18 @@
 
 /**
 * A pre-configured ContainerEffect instance that can be used for fading an overlay in and out.
-* @param {Overlay}	The Overlay object to animate
-* @param {float}	The duration of the animation
-* @type ContainerEffect
+* @method FADE
+* @static
+* @param {Overlay}	overlay	The Overlay object to animate
+* @param {Number}	dur	The duration of the animation
+* @return {ContainerEffect}	The configured ContainerEffect object
 */
 YAHOO.widget.ContainerEffect.FADE = function(overlay, dur) {
 	var fade = new YAHOO.widget.ContainerEffect(overlay, { attributes:{opacity: {from:0, to:1}}, duration:dur, method:YAHOO.util.Easing.easeIn }, { attributes:{opacity: {to:0}}, duration:dur, method:YAHOO.util.Easing.easeOut}, overlay.element );
 
 	fade.handleStartAnimateIn = function(type,args,obj) {
 		YAHOO.util.Dom.addClass(obj.overlay.element, "hide-select");
-		
+
 		if (! obj.overlay.underlay) {
 			obj.overlay.cfg.refireEvent("underlay");
 		}
@@ -3851,7 +4518,7 @@
 			obj.overlay.underlay.style.filter = null;
 		}
 
-		YAHOO.util.Dom.setStyle(obj.overlay.element, "visibility", "visible"); 
+		YAHOO.util.Dom.setStyle(obj.overlay.element, "visibility", "visible");
 		YAHOO.util.Dom.setStyle(obj.overlay.element, "opacity", 0);
 	};
 
@@ -3860,8 +4527,8 @@
 
 		if (obj.overlay.element.style.filter) {
 			obj.overlay.element.style.filter = null;
-		}			
-		
+		}
+
 		if (obj.overlay.underlay) {
 			YAHOO.util.Dom.setStyle(obj.overlay.underlay, "opacity", obj.initialUnderlayOpacity);
 		}
@@ -3878,18 +4545,18 @@
 		}
 	};
 
-	fade.handleCompleteAnimateOut =  function(type, args, obj) { 
+	fade.handleCompleteAnimateOut =  function(type, args, obj) {
 		YAHOO.util.Dom.removeClass(obj.overlay.element, "hide-select");
 		if (obj.overlay.element.style.filter) {
 			obj.overlay.element.style.filter = null;
-		}				
+		}
 		YAHOO.util.Dom.setStyle(obj.overlay.element, "visibility", "hidden");
-		YAHOO.util.Dom.setStyle(obj.overlay.element, "opacity", 1); 
+		YAHOO.util.Dom.setStyle(obj.overlay.element, "opacity", 1);
 
 		obj.overlay.cfg.refireEvent("iframe");
 
 		obj.animateOutCompleteEvent.fire();
-	};	
+	};
 
 	fade.init();
 	return fade;
@@ -3898,9 +4565,11 @@
 
 /**
 * A pre-configured ContainerEffect instance that can be used for sliding an overlay in and out.
-* @param {Overlay}	The Overlay object to animate
-* @param {float}	The duration of the animation
-* @type ContainerEffect
+* @method SLIDE
+* @static
+* @param {Overlay}	overlay	The Overlay object to animate
+* @param {Number}	dur	The duration of the animation
+* @return {ContainerEffect}	The configured ContainerEffect object
 */
 YAHOO.widget.ContainerEffect.SLIDE = function(overlay, dur) {
 	var x = overlay.cfg.getProperty("x") || YAHOO.util.Dom.getX(overlay.element);
@@ -3909,25 +4578,25 @@
 	var clientWidth = YAHOO.util.Dom.getClientWidth();
 	var offsetWidth = overlay.element.offsetWidth;
 
-	var slide = new YAHOO.widget.ContainerEffect(overlay, { 
-															attributes:{ points: { to:[x, y] } }, 
-															duration:dur, 
-															method:YAHOO.util.Easing.easeIn 
-														}, 
-														{ 
+	var slide = new YAHOO.widget.ContainerEffect(overlay, {
+															attributes:{ points: { to:[x, y] } },
+															duration:dur,
+															method:YAHOO.util.Easing.easeIn
+														},
+														{
 															attributes:{ points: { to:[(clientWidth+25), y] } },
-															duration:dur, 
+															duration:dur,
 															method:YAHOO.util.Easing.easeOut
 														},
 														overlay.element,
 														YAHOO.util.Motion);
-												
 
+
 	slide.handleStartAnimateIn = function(type,args,obj) {
 		obj.overlay.element.style.left = (-25-offsetWidth) + "px";
 		obj.overlay.element.style.top  = y + "px";
 	};
-	
+
 	slide.handleTweenAnimateIn = function(type, args, obj) {
 
 
@@ -3943,7 +4612,7 @@
 		obj.overlay.cfg.setProperty("xy", [currentX,currentY], true);
 		obj.overlay.cfg.refireEvent("iframe");
 	};
-	
+
 	slide.handleCompleteAnimateIn = function(type, args, obj) {
 		obj.overlay.cfg.setProperty("xy", [x,y], true);
 		obj.startX = x;
@@ -3953,34 +4622,32 @@
 	};
 
 	slide.handleStartAnimateOut = function(type, args, obj) {
-		var clientWidth = YAHOO.util.Dom.getViewportWidth();
-		
+		var vw = YAHOO.util.Dom.getViewportWidth();
+
 		var pos = YAHOO.util.Dom.getXY(obj.overlay.element);
 
-		var x = pos[0];
-		var y = pos[1];
+		var yso = pos[1];
 
 		var currentTo = obj.animOut.attributes.points.to;
-		obj.animOut.attributes.points.to = [(clientWidth+25), y];
+		obj.animOut.attributes.points.to = [(vw+25), yso];
 	};
 
 	slide.handleTweenAnimateOut = function(type, args, obj) {
 		var pos = YAHOO.util.Dom.getXY(obj.overlay.element);
 
-		var x = pos[0];
-		var y = pos[1];
+		var xto = pos[0];
+		var yto = pos[1];
 
-		obj.overlay.cfg.setProperty("xy", [x,y], true);
+		obj.overlay.cfg.setProperty("xy", [xto,yto], true);
 		obj.overlay.cfg.refireEvent("iframe");
 	};
 
-	slide.handleCompleteAnimateOut = function(type, args, obj) { 
-		YAHOO.util.Dom.setStyle(obj.overlay.element, "visibility", "hidden");		
-		var offsetWidth = obj.overlay.element.offsetWidth;
+	slide.handleCompleteAnimateOut = function(type, args, obj) {
+		YAHOO.util.Dom.setStyle(obj.overlay.element, "visibility", "hidden");
 
 		obj.overlay.cfg.setProperty("xy", [x,y]);
 		obj.animateOutCompleteEvent.fire();
-	};	
+	};
 
 	slide.init();
 	return slide;