Index: /CKEditor/branches/prototype/_source/plugins/dialog/dialogDefinition.js
===================================================================
--- /CKEditor/branches/prototype/_source/plugins/dialog/dialogDefinition.js	(revision 2726)
+++ /CKEditor/branches/prototype/_source/plugins/dialog/dialogDefinition.js	(revision 2727)
@@ -285,5 +285,5 @@
 /**
  * The popup label of the UI element.
- * @name CKEDITOR.dialog.uiElementDefinition.prototype.label
+ * @name CKEDITOR.dialog.uiElementDefinition.prototype.title
  * @field
  * @type String
@@ -301,5 +301,5 @@
 /**
  * Inline CSS classes to append to the UI element.
- * @name CKEDITOR.dialog.uiElementDefinition.prorotype.style
+ * @name CKEDITOR.dialog.uiElementDefinition.prototype.style
  * @field
  * @type String
@@ -314,2 +314,18 @@
  * @example
  */
+
+/**
+ * Function to execute whenever the UI element's parent dialog is displayed.
+ * @name CKEDITOR.dialog.uiElementDefinition.prototype.onShow
+ * @field
+ * @type Function
+ * @example
+ */
+
+/**
+ * Function to execute whenever the UI element's parent dialog is closed.
+ * @name CKEDITOR.dialog.uiElementDefinition.prototype.onHide
+ * @field
+ * @type Function
+ * @example
+ */
Index: /CKEditor/branches/prototype/_source/plugins/dialog/plugin.js
===================================================================
--- /CKEditor/branches/prototype/_source/plugins/dialog/plugin.js	(revision 2726)
+++ /CKEditor/branches/prototype/_source/plugins/dialog/plugin.js	(revision 2727)
@@ -1676,4 +1676,24 @@
 		 * @constructor
 		 * @extends CKEDITOR.ui.dialog.uiElement
+		 * @param {CKEDITOR.dialog} dialog
+		 * Parent dialog object.
+		 * @param {Array} childObjList
+		 * Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this
+		 * container.
+		 * @param {Array} childHtmlList
+		 * Array of HTML code that correspond to the HTML output of all the
+		 * objects in childObjList.
+		 * @param {Array} htmlList
+		 * Array of HTML code that this element will output to.
+		 * @param {CKEDITOR.dialog.uiElementDefinition} elementDefinition
+		 * The element definition. Accepted fields:
+		 * <ul>
+		 * 	<li><strong>widths</strong> (Optional) The widths of child cells.</li>
+		 * 	<li><strong>height</strong> (Optional) The height of the layout.</li>
+		 * 	<li><strong>padding</strong> (Optional) The padding width inside child
+		 * 	 cells.</li>
+		 * 	<li><strong>align</strong> (Optional) The alignment of the whole layout
+		 * 	</li>
+		 * </ul>
 		 * @example
 		 */
@@ -1731,4 +1751,26 @@
 		 * @constructor
 		 * @extends CKEDITOR.ui.dialog.hbox
+		 * @param {CKEDITOR.dialog} dialog
+		 * Parent dialog object.
+		 * @param {Array} childObjList
+		 * Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this
+		 * container.
+		 * @param {Array} childHtmlList
+		 * Array of HTML code that correspond to the HTML output of all the
+		 * objects in childObjList.
+		 * @param {Array} htmlList
+		 * Array of HTML code that this element will output to.
+		 * @param {CKEDITOR.dialog.uiElementDefinition} elementDefinition
+		 * The element definition. Accepted fields:
+		 * <ul>
+		 * 	<li><strong>width</strong> (Optional) The width of the layout.</li>
+		 * 	<li><strong>heights</strong> (Optional) The heights of individual cells.
+		 * 	</li>
+		 * 	<li><strong>align</strong> (Optional) The alignment of the layout.</li>
+		 * 	<li><strong>padding</strong> (Optional) The padding width inside child
+		 * 	cells.</li>
+		 * 	<li><strong>expand</strong> (Optional) Whether the layout should expand
+		 * 	vertically to fill its container.</li>
+		 * </ul>
 		 * @example
 		 */
Index: /CKEditor/branches/prototype/_source/plugins/dialogui/plugin.js
===================================================================
--- /CKEditor/branches/prototype/_source/plugins/dialogui/plugin.js	(revision 2726)
+++ /CKEditor/branches/prototype/_source/plugins/dialogui/plugin.js	(revision 2727)
@@ -100,4 +100,22 @@
 			 * @example
 			 * @extends CKEDITOR.ui.dialog.uiElement
+			 * @param {CKEDITOR.dialog} dialog
+			 * Parent dialog object.
+			 * @param {CKEDITOR.dialog.uiElementDefinition} elementDefinition
+			 * The element definition. Accepted fields:
+			 * <ul>
+			 * 	<li><strong>label</strong> (Required) The label string.</li>
+			 * 	<li><strong>labelLayout</strong> (Optional) Put 'horizontal' here if the
+			 * 	label element is to be layed out horizontally. Otherwise a vertical
+			 * 	layout will be used.</li>
+			 * 	<li><strong>widths</strong> (Optional) This applies only for horizontal
+			 * 	layouts - an 2-element array of lengths to specify the widths of the
+			 * 	label and the content element.</li>
+			 * </ul>
+			 * @param {Array} htmlList
+			 * List of HTML code to output to.
+			 * @param {Function} contentHtml
+			 * A function returning the HTML code string to be added inside the content
+			 * cell.
 			 */
 			labeledElement : function( dialog, elementDefinition, htmlList, contentHtml )
@@ -152,8 +170,23 @@
 
 			/**
-			 * A text input with a label.
+			 * A text input with a label. This UI element class represents both the
+			 * single-line text inputs and password inputs in dialog boxes.
 			 * @constructor
 			 * @example
 			 * @extends CKEDITOR.ui.dialog.labeledElement
+			 * @param {CKEDITOR.dialog} dialog
+			 * Parent dialog object.
+			 * @param {CKEDITOR.dialog.uiElementDefinition} elementDefinition
+			 * The element definition. Accepted fields:
+			 * <ul>
+			 * 	<li><strong>default</strong> (Optional) The default value.</li>
+			 * 	<li><strong>validate</strong> (Optional) The validation function. </li>
+			 * 	<li><strong>maxLength</strong> (Optional) The maximum length of text box
+			 * 	contents.</li>
+			 * 	<li><strong>size</strong> (Optional) The size of the text box. This is
+			 * 	usually overridden by the size defined by the skin, however.</li>
+			 * </ul>
+			 * @param {Array} htmlList
+			 * List of HTML code to output to.
 			 */
 			textInput : function( dialog, elementDefinition, htmlList )
@@ -212,4 +245,18 @@
 			 * @constructor
 			 * @extends CKEDITOR.ui.dialog.labeledElement
+			 * @param {CKEDITOR.dialog} dialog
+			 * Parent dialog object.
+			 * @param {CKEDITOR.dialog.uiElementDefinition} elementDefinition
+			 * The element definition. Accepted fields:
+			 * <ul>
+			 * 	<li><strong>rows</strong> (Optional) The number of rows displayed.
+			 * 	Defaults to 5 if not defined.</li>
+			 * 	<li><strong>cols</strong> (Optional) The number of cols displayed.
+			 * 	Defaults to 20 if not defined. Usually overridden by skins.</li>
+			 * 	<li><strong>default</strong> (Optional) The default value.</li>
+			 * 	<li><strong>validate</strong> (Optional) The validation function. </li>
+			 * </ul>
+			 * @param {Array} htmlList
+			 * List of HTML code to output to.
 			 */
 			textarea : function( dialog, elementDefinition, htmlList )
@@ -245,4 +292,14 @@
 			 * @constructor
 			 * @extends CKEDITOR.ui.dialog.uiElement
+			 * @param {CKEDITOR.dialog.uiElementDefinition} elementDefinition
+			 * The element definition. Accepted fields:
+			 * <ul>
+			 * 	<li><strong>checked</strong> (Optional) Whether the checkbox is checked
+			 * 	on instantiation.</li>
+			 * 	<li><strong>validate</strong> (Optional) The validation function.</li>
+			 * 	<li><strong>label</strong> (Optional) The checkbox label.</li>
+			 * </ul>
+			 * @param {Array} htmlList
+			 * List of HTML code to output to.
 			 */
 			checkbox : function( dialog, elementDefinition, htmlList )
@@ -759,4 +816,5 @@
 				 * @returns {CKEDITOR.dom.element} The &lt;select&gt; element of this UI
 				 * element.
+				 * @example
 				 */
 				getInputElement : function()