flex-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From p...@apache.org
Subject git commit: [flex-asjs] [refs/heads/develop] - Asdoc for components.
Date Tue, 04 Feb 2014 14:55:17 GMT
Updated Branches:
  refs/heads/develop 89ba62acc -> 6cd5ef3d0


Asdoc for components.


Project: http://git-wip-us.apache.org/repos/asf/flex-asjs/repo
Commit: http://git-wip-us.apache.org/repos/asf/flex-asjs/commit/6cd5ef3d
Tree: http://git-wip-us.apache.org/repos/asf/flex-asjs/tree/6cd5ef3d
Diff: http://git-wip-us.apache.org/repos/asf/flex-asjs/diff/6cd5ef3d

Branch: refs/heads/develop
Commit: 6cd5ef3d07e11a945f9d16def9194391b0a21786
Parents: 89ba62a
Author: Peter Ent <pent@apache.org>
Authored: Tue Feb 4 09:55:06 2014 -0500
Committer: Peter Ent <pent@apache.org>
Committed: Tue Feb 4 09:55:06 2014 -0500

----------------------------------------------------------------------
 .../apache/flex/html/staticControls/Alert.as    | 103 +++++++++++++++++++
 .../flex/html/staticControls/ButtonBar.as       |  25 +++++
 .../apache/flex/html/staticControls/ComboBox.as |  53 ++++++++++
 .../flex/html/staticControls/ControlBar.as      |  29 ++++++
 .../apache/flex/html/staticControls/Image.as    |  29 +++++-
 .../org/apache/flex/html/staticControls/List.as |  82 ++++++++++++++-
 .../flex/html/staticControls/NumericStepper.as  |  66 ++++++++++++
 .../apache/flex/html/staticControls/Panel.as    |  52 ++++++++++
 .../flex/html/staticControls/RadioButton.as     |  76 +++++++++++++-
 .../flex/html/staticControls/SimpleAlert.as     |  57 ++++++++++
 .../flex/html/staticControls/SimpleList.as      |  18 ++++
 .../apache/flex/html/staticControls/Slider.as   |  65 ++++++++++++
 .../apache/flex/html/staticControls/Spinner.as  |  65 ++++++++++++
 .../apache/flex/html/staticControls/TitleBar.as |  68 ++++++++++++
 14 files changed, 777 insertions(+), 11 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Alert.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Alert.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Alert.as
index b3cf5e2..068b86b 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Alert.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Alert.as
@@ -22,13 +22,74 @@ package org.apache.flex.html.staticControls
 	import org.apache.flex.core.IPopUp;
 	import org.apache.flex.core.UIBase;
 	
+	/**
+	 *  The Alert class is a component that displays a message and one or more buttons
+	 *  in a view that pops up over all other controls and views. The Alert component
+	 *  uses the AlertView bead to display a modal dialog with a title and a variety
+	 *  of buttons configured through the flag property of its show() static function.
+	 *  The Alert component uses the following beads:
+	 * 
+	 *  IBeadModel: the data model for the Alert.
+	 *  IBeadView: the bead used to create the parts of the Alert.
+	 *  IBeadController: the bead used to handle input events.
+	 *  IBorderBead: if present, draws a border around the Alert.
+	 *  IBackgroundBead: if present, places a solid color background below the Alert.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class Alert extends UIBase implements IPopUp
 	{
+		/**
+		 *  The bitmask button flag to show the YES button.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public static const YES:uint    = 0x000001;
+		
+		/**
+		 *  The bitmask button flag to show the NO button.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public static const NO:uint     = 0x000002;
+		
+		/**
+		 *  The bitmask button flag to show the OK button.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public static const OK:uint     = 0x000004;
+		
+		/**
+		 *  The bitmask button flag to show the Cancel button.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public static const CANCEL:uint = 0x000008;
 		
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function Alert()
 		{
 			super();
@@ -39,6 +100,15 @@ package org.apache.flex.html.staticControls
 		// note: only passing parent to this function as I don't see a way to identify
 		// the 'application' or top level view without supplying a place to start to
 		// look for it.
+		/**
+		 *  This static method is a convenience function to quickly create and display an Alert.
The
+		 *  text and parent paramters are required, the others will default.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		static public function show( text:String, parent:Object, title:String="", flags:uint=Alert.OK
) : void
 		{
 			var alert:Alert = new Alert();
@@ -49,11 +119,28 @@ package org.apache.flex.html.staticControls
 			alert.show(parent);
 		}
 		
+		/**
+		 *  Shows the Alert anchored to the given parent object which is usally a root component
such
+		 *  as a UIView..
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function show(parent:Object) : void
 		{
 			parent.addElement(this);
 		}
 		
+		/**
+		 *  The tile of the Alert.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get title():String
 		{
 			return IAlertModel(model).title;
@@ -63,6 +150,14 @@ package org.apache.flex.html.staticControls
 			IAlertModel(model).title = value;
 		}
 		
+		/**
+		 *  The message to display in the Alert body.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get message():String
 		{
 			return IAlertModel(model).message;
@@ -72,6 +167,14 @@ package org.apache.flex.html.staticControls
 			IAlertModel(model).message = value;
 		}
 		
+		/**
+		 *  The buttons to display on the Alert as bit-mask values.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get flags():uint
 		{
 			return IAlertModel(model).flags;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ButtonBar.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ButtonBar.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ButtonBar.as
index ee7c0e3..d5e4351 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ButtonBar.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ButtonBar.as
@@ -18,8 +18,33 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.html.staticControls
 {
+	/**
+	 *  The ButtonBar class is a component that displays a set of Buttons. The ButtonBar
+	 *  is actually a List with a default horizontal layout and an itemRenderer that 
+	 *  produces Buttons. The ButtonBar uses the following beads:
+	 * 
+	 *  IBeadModel: the data model for the ButtonBar, including the dataProvider.
+	 *  IBeadView: constructs the parts of the component.
+	 *  IBeadController: handles input events.
+	 *  IBeadLayout: sizes and positions the component parts.
+	 *  IDataProviderItemRendererMapper: produces itemRenderers.
+	 *  IItemRenderer: the class or class factory to use.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class ButtonBar extends List
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function ButtonBar()
 		{
 			super();

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ComboBox.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ComboBox.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ComboBox.as
index d70e644..c0ba134 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ComboBox.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ComboBox.as
@@ -23,13 +23,48 @@ package org.apache.flex.html.staticControls
 	
 	[Event(name="change", type="org.apache.flex.events.Event")]
 	
+	/**
+	 *  The ComboBox class is a component that displays an input field and
+	 *  pop-up List with selections. Selecting an item from the pop-up List
+	 *  places that item into the input field of the ComboBox. The ComboBox
+	 *  uses the following bead types:
+	 * 
+	 *  IBeadModel: the data model, which includes the dataProvider, selectedItem, and
+	 *  so forth.
+	 *  IBeadView:  the bead that constructs the visual parts of the component.
+	 *  IBeadController: the bead that handles input and output.
+	 *  IPopUp: the bead responsible for displaying the selection list.
+	 *  IDataProviderItemRendererMapper: the bead responsible for creating the itemRenders.
+	 *  IItemRenderer: the class or factory used to display an item in the component.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class ComboBox extends UIBase
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function ComboBox()
 		{
 			super();
 		}
 		
+		/**
+		 *  The data for display by the ComboBox.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get dataProvider():Object
 		{
 			return IComboBoxModel(model).dataProvider;
@@ -39,6 +74,15 @@ package org.apache.flex.html.staticControls
 			IComboBoxModel(model).dataProvider = value;
 		}
 		
+		/**
+		 *  The index of the currently selected item. Changing this item changes
+		 *  the selectedItem value.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get selectedIndex():int
 		{
 			return IComboBoxModel(model).selectedIndex;
@@ -48,6 +92,15 @@ package org.apache.flex.html.staticControls
 			IComboBoxModel(model).selectedIndex = value;
 		}
 		
+		/**
+		 *  The item that is currently selected. Changing this item changes
+		 *  the selectedIndex.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get selectedItem():Object
 		{
 			return IComboBoxModel(model).selectedItem;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ControlBar.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ControlBar.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ControlBar.as
index 8f0a46b..ad284bc 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ControlBar.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/ControlBar.as
@@ -24,8 +24,34 @@ package org.apache.flex.html.staticControls
 	import org.apache.flex.core.IContainer;
 	import org.apache.flex.core.ValuesManager;
 
+	/**
+	 *  The ControlBar class is used within a Panel as a place to position
+	 *  additional controls. The ControlBar appears at the bottom of the Panel
+	 *  and is not part of the Panel's scrollable content area. The ControlBar
+	 *  is a Container and implements the IChrome interface, indicating that is
+	 *  outside of the Container's content area. The ControlBar uses the following
+	 *  beads:
+	 * 
+	 *  IBeadModel: the data model for the component.
+	 *  IMeasurementBead: helps determine the overlay size of the ControlBar for layout.
+	 *  IBorderBead: if present, displays a border around the component.
+	 *  IBackgroundBead: if present, displays a solid background below the ControlBar.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class ControlBar extends Container implements IContainer, IChrome
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function ControlBar()
 		{
 			super();
@@ -33,6 +59,9 @@ package org.apache.flex.html.staticControls
 			className = "ControlBar";
 		}
 		
+		/**
+		 * @private
+		 */
 		override public function addedToParent():void
 		{
 			super.addedToParent();	

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Image.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Image.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Image.as
index eebfe40..27a2071 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Image.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Image.as
@@ -21,18 +21,45 @@ package org.apache.flex.html.staticControls
 	import org.apache.flex.core.IImageModel;
 	import org.apache.flex.core.UIBase;
 	
+	/**
+	 *  The Image class is a component that displays a bitmap. The Image uses
+	 *  the following beads:
+	 * 
+	 *  IBeadModel: the data model for the Image, including the source property.
+	 *  IBeadView: constructs the visual elements of the component.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class Image extends UIBase
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function Image()
 		{
 			super();
 		}
 		
+		/**
+		 *  The location of the bitmap, usually a URL.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get source():String
 		{
 			return IImageModel(model).source;
 		}
-		
 		public function set source(value:String):void
 		{
 			IImageModel(model).source = value;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/List.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/List.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/List.as
index ab3a7d7..fc80196 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/List.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/List.as
@@ -29,19 +29,46 @@ package org.apache.flex.html.staticControls
     [Event(name="change", type="org.apache.flex.events.Event")]
     
 	/**
-	 *  Label probably should extend TextField directly,
-	 *  but the player's APIs for TextLine do not allow
-	 *  direct instantiation, and we might want to allow
-	 *  Labels to be declared and have their actual
-	 *  view be swapped out.
+	 *  The List class is a component that displays multiple data items. The List uses
+	 *  the following bead types:
+	 * 
+	 *  IBeadModel: the data model, which includes the dataProvider, selectedItem, and
+	 *  so forth.
+	 *  IBeadView:  the bead that constructs the visual parts of the list.
+	 *  IBeadController: the bead that handles input and output.
+	 *  IBeadLayout: the bead responsible for the size and position of the itemRenderers.
+	 *  IDataProviderItemRendererMapper: the bead responsible for creating the itemRenders.
+	 *  IItemRenderer: the class or factory used to display an item in the list.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
 	 */
 	public class List extends UIBase
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function List()
 		{
 			super();
 		}
 		
+		/**
+		 *  The name of field within the data used for display. Each item of the
+		 *  data should have a property with this name.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get labelField():String
 		{
 			return ISelectionModel(model).labelField;
@@ -51,6 +78,14 @@ package org.apache.flex.html.staticControls
 			ISelectionModel(model).labelField = value;
 		}
 		
+		/**
+		 *  The data being display by the List.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
         public function get dataProvider():Object
         {
             return ISelectionModel(model).dataProvider;
@@ -60,6 +95,15 @@ package org.apache.flex.html.staticControls
             ISelectionModel(model).dataProvider = value;
         }
 
+		/**
+		 *  The index of the currently selected item. Changing this value
+		 *  also changes the selectedItem property.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
         public function get selectedIndex():int
 		{
 			return ISelectionModel(model).selectedIndex;
@@ -69,6 +113,14 @@ package org.apache.flex.html.staticControls
 			ISelectionModel(model).selectedIndex = value;
 		}
 
+		/**
+		 *  The index of the item currently below the pointer.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
         public function get rollOverIndex():int
 		{
 			return IRollOverModel(model).rollOverIndex;
@@ -78,6 +130,15 @@ package org.apache.flex.html.staticControls
 			IRollOverModel(model).rollOverIndex = value;
 		}
 		
+		/**
+		 *  The item currently selected. Changing this value also 
+		 *  changes the selectedIndex property.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get selectedItem():Object
 		{
 			return ISelectionModel(model).selectedItem;
@@ -87,6 +148,14 @@ package org.apache.flex.html.staticControls
 			ISelectionModel(model).selectedItem = value;
 		}
 		
+		/**
+		 *  The class or factory used to display each item.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		private var _itemRenderer:IFactory;
 		public function get itemRenderer():IFactory
 		{
@@ -97,6 +166,9 @@ package org.apache.flex.html.staticControls
 			_itemRenderer = value;
 		}
 		
+		/**
+		 * @private
+		 */
 		override public function addedToParent():void
 		{
             super.addedToParent();

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/NumericStepper.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/NumericStepper.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/NumericStepper.as
index c587ff3..573a6fb 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/NumericStepper.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/NumericStepper.as
@@ -21,13 +21,44 @@ package org.apache.flex.html.staticControls
 	import org.apache.flex.core.IRangeModel;
 
 	[Event(name="valueChanged", type="org.apache.flex.events.Event")]
+	
+	/**
+	 *  The NumericStepper class is a component that displays a numeric
+	 *  value and up/down controls (using a Spinner) to increase and decrease the value by
+	 *  specific amounts. The NumericStepper uses the following beads:
+	 * 
+	 *  IBeadModel: the data model for the component of type IRangeModel.
+	 *  IBeadView: constructs the parts of the component.
+	 *  IBeadController: handles the input events.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class NumericStepper extends Container
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function NumericStepper()
 		{
 			super();
 		}
 		
+		/**
+		 *  The current value of the control.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get value():Number
 		{
 			return IRangeModel(model).value;
@@ -37,6 +68,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).value = newValue;
 		}
 		
+		/**
+		 *  The minimum value the control will display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get minimum():Number
 		{
 			return IRangeModel(model).minimum;
@@ -46,6 +85,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).minimum = value;
 		}
 		
+		/**
+		 *  The maximum value the control will display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get maximum():Number
 		{
 			return IRangeModel(model).maximum;
@@ -55,6 +102,16 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).maximum = value;
 		}
 		
+		/**
+		 *  The amount to increase or descrease the value. The value
+		 *  will not exceed the minimum or maximum value. The final
+		 *  value is affected by the snapInterval.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get stepSize():Number
 		{
 			return IRangeModel(model).stepSize;
@@ -64,6 +121,15 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).stepSize = value;
 		}
 		
+		/**
+		 *  The modulus for the value. If this property is set,
+		 *  the value displayed with a muliple of the snapInterval.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get snapInterval():Number
 		{
 			return IRangeModel(model).snapInterval;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Panel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Panel.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Panel.as
index 90b637e..59ffccd 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Panel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Panel.as
@@ -22,13 +22,45 @@ package org.apache.flex.html.staticControls
 
 	[Event(name="close", type="org.apache.flex.events.Event")]
 	
+	/**
+	 *  The Panel class is a Container component capable of parenting other
+	 *  components. The Panel has a TitleBar and an optional ControlBar. The Panel
+	 *  uses the following bead types:
+	 * 
+	 *  IBeadModel: the data model for the Panel that includes the title and whether
+	 *  or not to display the close button.
+	 *  IBeadView: creates the parts of the Panel.
+	 *  IBorderBead: if present, draws a border around the Panel.
+	 *  IBackgroundBead: if present, provides a colored background for the Panel.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class Panel extends Container
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function Panel()
 		{
 			super();
 		}
 		
+		/**
+		 *  The string to display in the TitleBar.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get title():String
 		{
 			return IPanelModel(model).title;
@@ -38,6 +70,14 @@ package org.apache.flex.html.staticControls
 			IPanelModel(model).title = value;
 		}
 		
+		/**
+		 *  The HTML string to display in the TitleBar.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get htmlTitle():String
 		{
 			return IPanelModel(model).htmlTitle;
@@ -47,6 +87,9 @@ package org.apache.flex.html.staticControls
 			IPanelModel(model).htmlTitle = value;
 		}
 		
+		/**
+		 * Whether or not to show a Close button in the TitleBar.
+		 */
 		public function get showCloseButton():Boolean
 		{
 			return IPanelModel(model).showCloseButton;
@@ -56,6 +99,15 @@ package org.apache.flex.html.staticControls
 			IPanelModel(model).showCloseButton = value;
 		}
 		
+		/**
+		 *  The items in the ControlBar. Setting this property automatically
+		 *  causes the ControlBar to display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		private var _controlBar:Array;
 		public function get controlBar():Array
 		{

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/RadioButton.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/RadioButton.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/RadioButton.as
index 8f31816..fd8abf4 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/RadioButton.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/RadioButton.as
@@ -29,8 +29,29 @@ package org.apache.flex.html.staticControls
 	
 	[Event(name="change", type="org.apache.flex.events.Event")]
 
+	/**
+	 *  The RadioButton class is a component that displays a selectable Button. RadioButtons
+	 *  are typically used in groups, identified by the groupName property. RadioButton use
+	 *  the following beads:
+	 * 
+	 *  IBeadModel: the data model, which includes the groupName.
+	 *  IBeadView:  the bead that constructs the visual parts of the RadioButton..
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class RadioButton extends UIButtonBase implements IStrand
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function RadioButton(upState:DisplayObject=null, overState:DisplayObject=null, downState:DisplayObject=null,
hitTestState:DisplayObject=null)
 		{
 			super(upState, overState, downState, hitTestState);
@@ -42,16 +63,31 @@ package org.apache.flex.html.staticControls
 		
 		private var _groupName:String;
 		
+		/**
+		 *  The name of the group. Only one RadioButton in a group is selected.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get groupName() : String
 		{
 			return IValueToggleButtonModel(model).groupName;
 		}
-		
 		public function set groupName(value:String) : void
 		{
 			IValueToggleButtonModel(model).groupName = value;
 		}
 		
+		/**
+		 *  The string used as a label for the RadioButton.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get text():String
 		{
 			return IValueToggleButtonModel(model).text;
@@ -61,11 +97,20 @@ package org.apache.flex.html.staticControls
 			IValueToggleButtonModel(model).text = value;
 		}
 		
+		/**
+		 *  Whether or not the RadioButton instance is selected. Setting this property
+		 *  causes the currently selected RadioButton in the same group to lose the
+		 *  selection.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get selected():Boolean
 		{
 			return IValueToggleButtonModel(model).selected;
 		}
-		
 		public function set selected(selValue:Boolean):void
 		{
 			IValueToggleButtonModel(model).selected = selValue;
@@ -83,21 +128,36 @@ package org.apache.flex.html.staticControls
 			}
 		}
 		
+		/**
+		 *  The value associated with the RadioButton. For example, RadioButtons with labels,
+		 *  "Red", "Green", and "Blue" might have the values 0, 1, and 2 respectively.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get value():Object
 		{
 			return IValueToggleButtonModel(model).value;
 		}
-		
 		public function set value(newValue:Object):void
 		{
 			IValueToggleButtonModel(model).value = newValue;
 		}
 		
+		/**
+		 *  The group's currently selected value.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get selectedValue():Object 
 		{
 			return IValueToggleButtonModel(model).selectedValue;
 		}
-		
 		public function set selectedValue(newValue:Object):void 
 		{
 			// a radio button is really selected when its value matches that of the group's value
@@ -105,6 +165,9 @@ package org.apache.flex.html.staticControls
 			IValueToggleButtonModel(model).selectedValue = newValue;
 		}
 				
+		/**
+		 * @private
+		 */
 		override public function addedToParent():void
 		{
             super.addedToParent();
@@ -129,7 +192,10 @@ package org.apache.flex.html.staticControls
 			
 			dict[this] = this;
 		}
-				
+			
+		/**
+		 * @private
+		 */
 		private function internalMouseHandler(event:Event) : void
 		{
 			// prevent radiobutton from being turned off by a click

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleAlert.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleAlert.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleAlert.as
index cf4cc8c..8add7d6 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleAlert.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleAlert.as
@@ -25,8 +25,32 @@ package org.apache.flex.html.staticControls
 	
 	[Event(name="close", type="org.apache.flex.events.Event")]
 	
+	/**
+	 *  The SimpleAlert class is a component that displays a message and an OK button. The
+	 *  SimpleAlert converts directly to window.alert() for HTML. SimpleAlert uses
+	 *  the following beads:
+	 * 
+	 *  IBeadModel: the data model, which includes the message.
+	 *  IBeadView:  the bead that constructs the visual parts of the Alert.
+	 *  IBeadController: the bead responsible for handling input events.
+	 *  IBorderBead: a bead, if present, that draws a border around the control.
+	 *  IBackgroundBead: a bead, if present, that creates a solid-color background.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class SimpleAlert extends UIBase implements IPopUp
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function SimpleAlert()
 		{
 			super();
@@ -34,6 +58,14 @@ package org.apache.flex.html.staticControls
 			className = "SimpleAlert";
 		}
 		
+		/**
+		 *  The message to display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		private function get message():String
 		{
 			return IAlertModel(model).message;
@@ -43,6 +75,14 @@ package org.apache.flex.html.staticControls
 			IAlertModel(model).message = value;
 		}
 		
+		/**
+		 *  The HTML message to display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		private function get htmlMessage():String
 		{
 			return IAlertModel(model).htmlMessage;
@@ -52,11 +92,28 @@ package org.apache.flex.html.staticControls
 			IAlertModel(model).htmlMessage = value;
 		}
 		
+		/**
+		 *  This function causes the SimpleAlert to appear. The parent is used for ActionScript
and
+		 *  identifies the IPopUpParent that manages the alert.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function show(parent:Object) : void
 		{
 			parent.addElement(this);
 		}
 		
+		/**
+		 *  A convenience function to compose and display the alert.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		static public function show(message:String, parent:Object):SimpleAlert
 		{
 			var alert:SimpleAlert = new SimpleAlert();

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleList.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleList.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleList.as
index 9f19a72..951ab46 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleList.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/SimpleList.as
@@ -18,8 +18,26 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.html.staticControls
 {
+	/**
+	 *  The SimpleList class is a component that displays data in a vertical column. This
+	 *  component differs from List in that it displays only string values and converts to
+	 *  the <select> HTML element.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class SimpleList extends List
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function SimpleList()
 		{
 			super();

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Slider.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Slider.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Slider.as
index f73109d..e30d881 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Slider.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Slider.as
@@ -23,8 +23,31 @@ package org.apache.flex.html.staticControls
 	
 	[Event(name="valueChanged", type="org.apache.flex.events.Event")]
 	
+	/**
+	 *  The Slider class is a component that displays a range of values using a
+	 *  track and a thumb control. The Slider uses the following bead types:
+	 * 
+	 *  IBeadModel: the data model, typically an IRangeModel, that holds the Slider values.
+	 *  IBeadView:  the bead that constructs the visual parts of the Slider.
+	 *  IBeadController: the bead that handles input.
+	 *  IThumbValue: the bead responsible for the display of the thumb control.
+	 *  ITrackView: the bead responsible for the display of the track.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class Slider extends UIBase
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function Slider()
 		{
 			super();
@@ -38,6 +61,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).snapInterval = 1;
 		}
 		
+		/**
+		 *  The current value of the Slider.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get value():Number
 		{
 			return IRangeModel(model).value;
@@ -47,6 +78,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).value = newValue;
 		}
 		
+		/**
+		 *  The minimum value of the Slider.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get minimum():Number
 		{
 			return IRangeModel(model).minimum;
@@ -56,6 +95,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).minimum = value;
 		}
 		
+		/**
+		 *  The maximum value of the Slider.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get maximum():Number
 		{
 			return IRangeModel(model).maximum;
@@ -65,6 +112,15 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).maximum = value;
 		}
 		
+		/**
+		 *  The modulus of the Slider value. The thumb will be positioned
+		 *  at the nearest multiple of this value.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get snapInterval():Number
 		{
 			return IRangeModel(model).snapInterval;
@@ -74,6 +130,15 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).snapInterval = value;
 		}
         
+		/**
+		 *  The amount to move the thumb when the track is selected. This value is
+		 *  adjusted to fit the nearest snapInterval.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
         public function get stepSize():Number
         {
             return IRangeModel(model).stepSize;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Spinner.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Spinner.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Spinner.as
index d0eb443..d4c67a9 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Spinner.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/Spinner.as
@@ -23,8 +23,30 @@ package org.apache.flex.html.staticControls
 	
 	[Event(name="valueChanged", type="org.apache.flex.events.Event")]
 	
+	/**
+	 *  The Spinner class is a component that displays a control for incrementing a value
+	 *  and a control for decrementing a value. The NumericStepper uses a Spinner as part
+	 *  of the component. Spinner uses the following beads:
+	 * 
+	 *  IBeadModel: an IRangeModel to hold the properties.
+	 *  IBeadView:  the bead that constructs the visual parts of the Spinner.
+	 *  IBeadController: a bead that handles the input events.
+	 *  
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class Spinner extends UIBase
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function Spinner()
 		{
 			super();
@@ -32,6 +54,14 @@ package org.apache.flex.html.staticControls
 			className = "Spinner";
 		}
 		
+		/**
+		 *  The current value of the Spinner.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get value():Number
 		{
 			return IRangeModel(model).value;
@@ -41,6 +71,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).value = newValue;
 		}
 		
+		/**
+		 *  The minimum value of the Spinner.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get minimum():Number
 		{
 			return IRangeModel(model).minimum;
@@ -50,6 +88,14 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).minimum = value;
 		}
 		
+		/**
+		 *  The maximum value of the Spinner.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get maximum():Number
 		{
 			return IRangeModel(model).maximum;
@@ -59,6 +105,15 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).maximum = value;
 		}
 		
+		/**
+		 *  The modulus for the value. If this property is set,
+		 *  the value displayed with a muliple of the snapInterval.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get snapInterval():Number
 		{
 			return IRangeModel(model).snapInterval;
@@ -68,6 +123,16 @@ package org.apache.flex.html.staticControls
 			IRangeModel(model).snapInterval = value;
 		}
 		
+		/**
+		 *  The amount to increase or descrease the value. The value
+		 *  will not exceed the minimum or maximum value. The final
+		 *  value is affected by the snapInterval.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get stepSize():Number
 		{
 			return IRangeModel(model).stepSize;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/6cd5ef3d/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/TitleBar.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/TitleBar.as
b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/TitleBar.as
index cf1e584..574a5a8 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/TitleBar.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/html/staticControls/TitleBar.as
@@ -28,8 +28,30 @@ package org.apache.flex.html.staticControls
 	import org.apache.flex.events.Event;
 	import org.apache.flex.html.staticControls.Label;
 	
+	/**
+	 *  The TitleBar class is a Container component that displays a title and an
+	 *  optional close button. The TitleBar uses the following bead types:
+	 * 
+	 *  IBeadModel: the data model, which includes the title and showCloseButton values.
+	 *  IBeadView:  the bead that constructs the visual parts of the component.
+	 *  IBeadLayout: the bead that handles size and position of the component parts (Label and
Button).
+	 *  IMeasurementBead: a bead that helps determine the size of the TitleBar for layout.
+	 * 
+	 *  @langversion 3.0
+	 *  @playerversion Flash 10.2
+	 *  @playerversion AIR 2.6
+	 *  @productversion FlexJS 0.0
+	 */
 	public class TitleBar extends Container implements IChrome
 	{
+		/**
+		 *  constructor.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function TitleBar()
 		{
 			super();
@@ -37,6 +59,14 @@ package org.apache.flex.html.staticControls
 			className = "TitleBar";
 		}
 		
+		/**
+		 *  The title string to display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get title():String
 		{
 			return ITitleBarModel(model).title;
@@ -46,6 +76,14 @@ package org.apache.flex.html.staticControls
 			ITitleBarModel(model).title = value;
 		}
 		
+		/**
+		 *  The HTML title to display.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get htmlTitle():String
 		{
 			return ITitleBarModel(model).htmlTitle;
@@ -55,6 +93,15 @@ package org.apache.flex.html.staticControls
 			ITitleBarModel(model).htmlTitle = value;
 		}
 		
+		/**
+		 *  Whether or not to show a Button that indicates the component
+		 *  may be closed.
+		 *
+		 *  @langversion 3.0
+		 *  @playerversion Flash 10.2
+		 *  @playerversion AIR 2.6
+		 *  @productversion FlexJS 0.0
+		 */
 		public function get showCloseButton():Boolean
 		{
 			return ITitleBarModel(model).showCloseButton;
@@ -64,18 +111,27 @@ package org.apache.flex.html.staticControls
 			ITitleBarModel(model).showCloseButton = value;
 		}
 		
+		/**
+		 * @private
+		 */
 		private var _titleLabel:Label;
 		public function get titleLabel():Label
 		{
 			return _titleLabel;
 		}
 		
+		/**
+		 * @private
+		 */
 		private var _closeButton:Button;
 		public function get closeButton():Button
 		{
 			return closeButton;
 		}
 		
+		/**
+		 * @private
+		 */
 		override public function addedToParent():void
 		{
 			super.addedToParent();
@@ -104,6 +160,9 @@ package org.apache.flex.html.staticControls
 			dispatchEvent(new Event("widthChanged"));
 		}
 		
+		/**
+		 * @private
+		 */
 		private function handlePropertyChange(event:Event):void
 		{
 			if( event.type == "showCloseButtonChange" ) {
@@ -123,6 +182,9 @@ package org.apache.flex.html.staticControls
 			dispatchEvent(new Event("widthChanged"));
 		}
 		
+		/**
+		 * @private
+		 */
 		protected function createTitle() : Label
 		{
 			var label:Label = new Label();
@@ -130,6 +192,9 @@ package org.apache.flex.html.staticControls
 			return label;
 		}
 		
+		/**
+		 * @private
+		 */
 		protected function createCloseButton() : Button
 		{
 			var upState:Shape = new Shape();
@@ -164,6 +229,9 @@ package org.apache.flex.html.staticControls
 			return button;
 		}
 		
+		/**
+		 * @private
+		 */
 		private function closeButtonHandler(event:org.apache.flex.events.Event) : void
 		{
 			var newEvent:Event = new Event('close',true);


Mime
View raw message