flex-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From aha...@apache.org
Subject [1/2] git commit: [flex-asjs] [refs/heads/develop] - start adding more asdoc for FlexJS
Date Wed, 29 Jan 2014 23:28:01 GMT
Updated Branches:
  refs/heads/develop c9db817cb -> 0b8875a87


start adding more asdoc for FlexJS


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

Branch: refs/heads/develop
Commit: ec91173366bbac703f380cb5900c7707b8fb33c5
Parents: c9db817
Author: Alex Harui <aharui@apache.org>
Authored: Wed Jan 29 11:31:56 2014 -0800
Committer: Alex Harui <aharui@apache.org>
Committed: Wed Jan 29 15:27:53 2014 -0800

----------------------------------------------------------------------
 .../org/apache/flex/binding/ConstantBinding.as  | 104 +++++++++-
 .../org/apache/flex/binding/GenericBinding.as   |  99 +++++++++-
 .../org/apache/flex/binding/PropertyWatcher.as  |  79 +++++++-
 .../org/apache/flex/binding/SimpleBinding.as    | 111 ++++++++++-
 .../src/org/apache/flex/binding/WatcherBase.as  | 111 +++++++++--
 .../src/org/apache/flex/core/Application.as     | 188 ++++++++++++++++++-
 .../src/org/apache/flex/core/CSSTextField.as    |  34 +++-
 .../src/org/apache/flex/core/FilledRectangle.as |  45 +++++
 .../src/org/apache/flex/core/IAlertModel.as     |  83 ++++++++
 .../FlexJSUI/src/org/apache/flex/core/IBead.as  |  22 +++
 .../src/org/apache/flex/core/IBeadController.as |  15 +-
 .../src/org/apache/flex/core/IBeadLayout.as     |  15 +-
 .../src/org/apache/flex/core/IBeadModel.as      |  15 +-
 .../src/org/apache/flex/core/IBeadView.as       |  15 +-
 .../src/org/apache/flex/core/IBorderModel.as    |  18 ++
 .../src/org/apache/flex/core/IChrome.as         |  18 +-
 .../src/org/apache/flex/core/IComboBoxModel.as  |  67 +++++++
 .../src/org/apache/flex/core/IContainer.as      |  22 +++
 .../src/org/apache/flex/core/IDataGridModel.as  |  18 ++
 .../core/IDataProviderItemRendererMapper.as     |  24 ++-
 .../src/org/apache/flex/core/IDocument.as       |  20 ++
 .../src/org/apache/flex/core/IFlexInfo.as       |  18 +-
 .../src/org/apache/flex/core/IImageModel.as     |  20 ++
 .../src/org/apache/flex/core/IItemRenderer.as   |  62 ++++++
 24 files changed, 1157 insertions(+), 66 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/ConstantBinding.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/ConstantBinding.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/ConstantBinding.as
index bab1e7b..12d590c 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/ConstantBinding.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/ConstantBinding.as
@@ -22,20 +22,108 @@ package org.apache.flex.binding
 	import org.apache.flex.core.IStrand;
 	import org.apache.flex.core.IDocument;
 	
+    /**
+     *  The ConstantBinding class is lightweight data-binding class that
+     *  is optimized for simple assignments of one object's constant to
+     *  another object's property.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public class ConstantBinding implements IBead, IDocument
 	{
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function ConstantBinding()
 		{
 		}
 		
+        /**
+         *  The source object who's property has the value we want.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		protected var source:Object;
+
+        /**
+         *  The host mxml document for the source and
+         *  destination objects.  The source object
+         *  is either this document for simple bindings
+         *  like {foo} where foo is a property on
+         *  the mxml documnet, or found as document[sourceID]
+         *  for simple bindings like {someid.someproperty}
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		protected var document:Object;
-		protected var destination:Object;
 
-		public var sourceID:String;
-		public var sourcePropertyName:String;
-		public var destinationPropertyName:String;
+        /**
+         *  The destination object.  It is always the same
+         *  as the strand.  ConstantBindings are attached to
+         *  the strand of the destination object.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        protected var destination:Object;
+
+        /**
+         *  If not null, the id of the mxml tag who's property
+         *  is being watched for changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        public var sourceID:String;
+
+        /**
+         *  If not null, the name of a property on the
+         *  mxml document that is being watched for changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        public var sourcePropertyName:String;
+
+        /**
+         *  The name of the property on the strand that
+         *  is set when the source property changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        public var destinationPropertyName:String;
 		
+        /**
+         *  @see org.apache.flex.core.IBead#strand
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function set strand(value:IStrand):void
 		{
 			destination = value;
@@ -43,6 +131,14 @@ package org.apache.flex.binding
 			destination[destinationPropertyName] = source[sourcePropertyName];
 		}
 		
+        /**
+         *  @see org.apache.flex.core.IDocument#setDocument
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function setDocument(document:Object, id:String = null):void
 		{
 			this.document = document;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/GenericBinding.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/GenericBinding.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/GenericBinding.as
index 4cb6f5e..8a2c8db 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/GenericBinding.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/GenericBinding.as
@@ -24,19 +24,99 @@ package org.apache.flex.binding
 	import org.apache.flex.core.IDocument;
 	import org.apache.flex.core.IStrand;
 
+    /**
+     *  The GenericBinding class is the data-binding class that applies
+     *  changes to properties of source objects to a property of the
+     *  destination object.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public class GenericBinding implements IBead, IDocument
 	{
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function GenericBinding()
 		{
 		}
 		
+        /**
+         *  The mxml document for the
+         *  binding expression.  If you bind to
+         *  {someid.someproperty} then there must
+         *  be a tag in the mxml document with
+         *  the id "someid".
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		protected var document:Object;
+        
+        /**
+         *  The object whose property will be
+         *  changed by the binding expression.  
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         protected var destination:Object;
 
+        /**
+         *  The string or array of strings that describe
+         *  the chain of properties to access to get to
+         *  the source property's value. 
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var source:Object;
+        
+        /**
+         *  The string or array of strings that describe
+         *  the chain of properties to access to assign
+         *  the source property's value to the destination
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var destinationData:Object;
-		public var destinationFunction:Function;
+
+        /**
+         *  The function used to assign
+         *  the source property's value to the destination
+         *  if the destination is not a public property
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        public var destinationFunction:Function;
 		
+        /**
+         *  @see org.apache.flex.core.IBead#strand
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function set strand(value:IStrand):void
 		{
 			destination = value;
@@ -98,11 +178,28 @@ package org.apache.flex.binding
             }
         }
 		
+        /**
+         *  @see org.apache.flex.core.IDocument#setDocument
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function setDocument(document:Object, id:String = null):void
 		{
 			this.document = document;
 		}
 		
+        /**
+         *  The method that gets called by the watcher when the value
+         *  may have changed.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function valueChanged(value:Object):void
 		{
             var val:Object = getValueFromSource();

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/PropertyWatcher.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/PropertyWatcher.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/PropertyWatcher.as
index bde39e6..1ef1440 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/PropertyWatcher.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/PropertyWatcher.as
@@ -22,8 +22,25 @@ package org.apache.flex.binding
     import org.apache.flex.events.IEventDispatcher;
     import org.apache.flex.events.ValueChangeEvent;
 
+    /**
+     *  The PropertyWatcher class is the data-binding class that watches
+     *  for changes to various properties in objects.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public class PropertyWatcher extends WatcherBase
 	{
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function PropertyWatcher(source:Object, propertyName:String, eventNames:Object, 
                                             getterFunction:Function)
 		{
@@ -34,11 +51,58 @@ package org.apache.flex.binding
             
 		}
 		
+        /**
+         *  The object who's property we are watching.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var source:Object;
+        
+        /**
+         *  The name of the property we are watching.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public var propertyName:String;
+        
+        /**
+         *  The name or array of names of events that get
+         *  dispatched when the property changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */        
         public var eventNames:Object;
+        
+        /**
+         *  A function to call to get the value
+         *  of the property changes if the property is
+         *  not public.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */                
         public var getterFunction:Function;
 		
+        /**
+         *  The event handler that gets called when
+         *  the change events are dispatched.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */                
         protected function changeHandler(event:Event):void
         {
             if (event is ValueChangeEvent)
@@ -62,13 +126,8 @@ package org.apache.flex.binding
         //--------------------------------------------------------------------------
         
         /**
-         *  If the parent has changed we need to update ourselves
-         *  
-         *  @langversion 3.0
-         *  @playerversion Flash 9
-         *  @playerversion AIR 1.1
-         *  @productversion Flex 3
-         */
+         *  @private
+         */                
         override public function parentChanged(parent:Object):void
         {
             if (source && source is IEventDispatcher)
@@ -120,9 +179,9 @@ package org.apache.flex.binding
          *  the Watcher's children appropriately.
          *  
          *  @langversion 3.0
-         *  @playerversion Flash 9
-         *  @playerversion AIR 1.1
-         *  @productversion Flex 3
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         private function updateProperty():void
         {

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/SimpleBinding.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/SimpleBinding.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/SimpleBinding.as
index bab9378..4e4dce2 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/SimpleBinding.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/SimpleBinding.as
@@ -25,21 +25,120 @@ package org.apache.flex.binding
 	import org.apache.flex.core.IStrand;
 	import org.apache.flex.core.IDocument;
 
+    /**
+     *  The SimpleBinding class is lightweight data-binding class that
+     *  is optimized for simple assignments of one object's property to
+     *  another object's property.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public class SimpleBinding implements IBead, IDocument
 	{
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function SimpleBinding()
 		{
 		}
 		
+        /**
+         *  The source object that dispatches an event
+         *  when the property changes
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		protected var source:IEventDispatcher;
-		protected var document:Object;
+
+        /**
+         *  The host mxml document for the source and
+         *  destination objects.  The source object
+         *  is either this document for simple bindings
+         *  like {foo} where foo is a property on
+         *  the mxml documnet, or found as document[sourceID]
+         *  for simple bindings like {someid.someproperty}
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        protected var document:Object;
+
+        /**
+         *  The destination object.  It is always the same
+         *  as the strand.  SimpleBindings are attached to
+         *  the strand of the destination object.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		protected var destination:Object;
 
+        /**
+         *  If not null, the id of the mxml tag who's property
+         *  is being watched for changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var sourceID:String;
-		public var sourcePropertyName:String;
+
+        /**
+         *  If not null, the name of a property on the
+         *  mxml document that is being watched for changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
+        public var sourcePropertyName:String;
+        
+        /**
+         *  The event name that is dispatched when the source
+         *  property changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var eventName:String;
+        
+        /**
+         *  The name of the property on the strand that
+         *  is set when the source property changes.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var destinationPropertyName:String;
 		
+        /**
+         *  @see org.apache.flex.core.IBead#strand
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function set strand(value:IStrand):void
 		{
 			destination = value;
@@ -51,6 +150,14 @@ package org.apache.flex.binding
 			destination[destinationPropertyName] = source[sourcePropertyName];
 		}
 		
+        /**
+         *  @see org.apache.flex.core.IDocument#setDocument
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function setDocument(document:Object, id:String = null):void
 		{
 			this.document = document;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/WatcherBase.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/WatcherBase.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/WatcherBase.as
index 47d4286..8efd6c4 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/WatcherBase.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/binding/WatcherBase.as
@@ -19,7 +19,15 @@
 
 package org.apache.flex.binding
 {
-    
+    /**
+     *  The WatcherBase class is the base class for data-binding classes that watch
+     *  various properties and styles for changes.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
     public class WatcherBase
     {
         //--------------------------------------------------------------------------
@@ -48,21 +56,36 @@ package org.apache.flex.binding
         //--------------------------------------------------------------------------
         
         /**
-         *  @private
          *  The binding objects that are listening to this Watcher.
          *  The standard event mechanism isn't used because it's too heavyweight.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         protected var listeners:Array;
         
         /**
-         *  @private
-         *  Children of this watcher are watching sub values.
+         *  Children of this watcher are watching sub values.  For example, if watching 
+         *  {a.b.c} and this watcher is watching "b", then it is the watchers watching
+         *  "c" and "d" if there is an {a.b.d} being watched.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         protected var children:Array;
         
         /**
-         *  @private
-         *  The value itself.
+         *  The value of whatever it is we are watching.  For example, if watching 
+         *  {a.b.c} and this watcher is watching "b", then it is the value of "a.b".
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         public var value:Object;
         
@@ -73,17 +96,29 @@ package org.apache.flex.binding
         //--------------------------------------------------------------------------
         
         /**
-         *  @private
-         *  This is an abstract method that subclasses implement.
+         *  This is an abstract method that subclasses implement.  Implementations
+         *  handle changes in the parent chain.  For example, if watching 
+         *  {a.b.c} and this watcher is watching "b", then handle "a" changing.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         public function parentChanged(parent:Object):void
         {
         }
         
         /**
-         *  @private
          *  Add a child to this watcher, meaning that the child
-         *  is watching a sub value of ours.
+         *  is watching a sub value of ours.  For example, if watching 
+         *  {a.b.c} and this watcher is watching "b", then this method
+         *  is called to add the watcher watching "c".
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         public function addChild(child:WatcherBase):void
         {
@@ -96,9 +131,15 @@ package org.apache.flex.binding
         }
         
         /**
-         *  @private
          *  Add a binding to this watcher, meaning that the binding
-         *  is notified when our value changes.
+         *  is notified when our value changes.  Bindings are classes
+         *  that actually perform the change based on changes
+         *  detected to this portion of the chain.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         public function addBinding(binding:GenericBinding):void
         {
@@ -111,13 +152,14 @@ package org.apache.flex.binding
         }
                 
         /**
-         *  We have probably changed, so go through
-         *  and make sure our children are updated.
+         *  This method is called when the value
+         *  might have changed and goes through
+         *  and makes sure the children are updated.
          *  
          *  @langversion 3.0
-         *  @playerversion Flash 9
-         *  @playerversion AIR 1.1
-         *  @productversion Flex 3
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         public function updateChildren():void
         {
@@ -174,7 +216,13 @@ package org.apache.flex.binding
         }
         
         /**
-         *  @private
+         *  Calls a function inside a try catch block to try to
+         *  update the value.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         protected function wrapUpdate(wrappedFunction:Function):void
         {
@@ -202,7 +250,15 @@ package org.apache.flex.binding
             }
         }
         
-        // Certain errors are normal when executing an update, so we swallow them:
+        /**
+         *  Certain errors are normal when executing an update, so we swallow them.
+         *  Feel free to add more errors if needed.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public static var allowedErrors:Array = [
             1006, //   Error #1006: Call attempted on an object that is not a function.
             1009, //   Error #1009: null has no properties.
@@ -212,12 +268,27 @@ package org.apache.flex.binding
             1507 //   Error #1507: - invalid null argument.
             ];
         
+        /**
+         *  Certain errors classes are normal when executing an update, so we swallow all
+         *  errors they represent.  Feel free to add more errors if needed.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public static var allowedErrorTypes:Array = [
             { type: RangeError /*, handler: function(w:WatcherBase, wrappedFunction:Function):Object { return null }*/ }
             ];
         
         /**
-         *  @private
+         *  Notify the various bindings that the value has changed so they can update
+         *  their data binding expressions.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
          */
         public function notifyListeners():void
         {

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/Application.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/Application.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/Application.as
index a126b6f..2ca39fb 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/Application.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/Application.as
@@ -32,12 +32,52 @@ package org.apache.flex.core
     //--------------------------------------
     
     /**
-     *  Dispatched at startup.
+     *  Dispatched at startup. Attributes and sub-instances of
+     *  the MXML document have been created and assigned.
+     *  The component lifecycle is different
+     *  than the Flex SDK.  There is no creationComplete event.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
      */
     [Event(name="initialize", type="org.apache.flex.events.Event")]
     
+    /**
+     *  Dispatched at startup after the initial view has been
+     *  put on the display list.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
+    [Event(name="viewChanged", type="org.apache.flex.events.Event")]
+    
+    /**
+     *  The Application class the main class and entry point for a FlexJS
+     *  application.  This Application class is different than the
+     *  Flex SDK's mx:Application or spark:Application in that it does not contain
+     *  user interface elements.  Those UI elements go in the views.  This
+     *  Application class expects there to be a main model, a controller, and 
+     *  an initial view.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
     public class Application extends Sprite implements IStrand, IFlexInfo, IParent
     {
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function Application()
         {
             super();
@@ -62,29 +102,114 @@ package org.apache.flex.core
     	    dispatchEvent(new Event("viewChanged"));
         }
 
+        /**
+         *  The org.apache.flex.core.IValuesImpl that will
+         *  determine the default values and other values
+         *  for the application.  The most common choice
+         *  is org.apache.flex.core.SimpleCSSValuesImpl.
+         * 
+         *  @see org.apache.flex.core.SimpleCSSValuesImpl
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public var valuesImpl:IValuesImpl;
 
+        /**
+         *  The initial view.
+         * 
+         *  @see org.apache.flex.core.ViewBase
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public var initialView:ViewBase;
 
+        /**
+         *  The data model (for the initial view).
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public var model:Object;
 
+        /**
+         *  The controller.  The controller typically watches
+         *  the UI for events and updates the model accordingly.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public var controller:Object;
 
+        /**
+         *  An array of data that describes the MXML attributes
+         *  and tags in an MXML document.  This data is usually
+         *  decoded by an MXMLDataInterpreter
+         * 
+         *  @see org.apache.flex.utils.MXMLDataInterpreter
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function get MXMLDescriptor():Array
         {
             return null;
         }
 
+        /**
+         *  An method called by the compiler's generated
+         *  code to kick off the setting of MXML attribute
+         *  values and instantiation of child tags.
+         * 
+         *  The call has to be made in the generated code
+         *  in order to ensure that the constructors have
+         *  completed first.
+         * 
+         *  @see org.apache.flex.utils.MXMLDataInterpreter
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
     	public function generateMXMLAttributes(data:Array):void
         {
 			MXMLDataInterpreter.generateMXMLProperties(this, data);
         }
         
-        // beads declared in MXML are added to the strand.
-        // from AS, just call addBead()
+        /**
+         *  The array property that is used to add additional
+         *  beads to an MXML tag.  From ActionScript, just
+         *  call addBead directly.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public var beads:Array;
         
         private var _beads:Vector.<IBead>;
+        
+        /**
+         *  @see org.apache.flex.core.IStrand#addBead
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function addBead(bead:IBead):void
         {
             if (!_beads)
@@ -93,6 +218,14 @@ package org.apache.flex.core
             bead.strand = this;
         }
         
+        /**
+         *  @see org.apache.flex.core.IStrand#getBeadByType
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function getBeadByType(classOrInterface:Class):IBead
         {
             for each (var bead:IBead in _beads)
@@ -103,6 +236,14 @@ package org.apache.flex.core
             return null;
         }
         
+        /**
+         *  @see org.apache.flex.core.IStrand#removeBead
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function removeBead(value:IBead):IBead	
         {
             var n:int = _beads.length;
@@ -118,11 +259,28 @@ package org.apache.flex.core
             return null;
         }
         
+        /**
+         *  An Object containing information generated
+         *  by the compiler that is useful at startup time.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function get info():Object
         {
             return {};           
         }
         
+        /**
+         *  @see org.apache.flex.core.IParent#addElement
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function addElement(c:Object):void
         {
             if (c is IUIBase)
@@ -134,6 +292,14 @@ package org.apache.flex.core
                 addChild(c as DisplayObject);
         }
         
+        /**
+         *  @see org.apache.flex.core.IParent#addElementAt
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function addElementAt(c:Object, index:int):void
         {
             if (c is IUIBase)
@@ -145,6 +311,14 @@ package org.apache.flex.core
                 addChildAt(c as DisplayObject, index);
         }
 
+        /**
+         *  @see org.apache.flex.core.IParent#getElementIndex
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function getElementIndex(c:Object):int
         {
             if (c is IUIBase)
@@ -153,6 +327,14 @@ package org.apache.flex.core
             return getChildIndex(c as DisplayObject);
         }
         
+        /**
+         *  @see org.apache.flex.core.IParent#removeElement
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         public function removeElement(c:Object):void
         {
             if (c is IUIBase)

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/CSSTextField.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/CSSTextField.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/CSSTextField.as
index ed1c87b..dd74387 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/CSSTextField.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/CSSTextField.as
@@ -23,18 +23,46 @@ package org.apache.flex.core
 	
 	import org.apache.flex.core.ValuesManager;
 		
+    /**
+     *  The CSSTextField class implements CSS text styles in a TextField.
+     *  Not every CSS text style is currently supported.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public class CSSTextField extends TextField
 	{
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function CSSTextField()
 		{
 			super();
 		}
 		
-		// if used as the display object in a button, parent is null and
-		// the css lookup doesn't work.  This will be used if parent is 
-		// null.
+        /**
+         *  @private
+         *  The styleParent property is set if the CSSTextField
+         *  is used in a SimpleButton-based instance because
+         *  the parent property is null, defeating CSS lookup.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public var styleParent:Object;
 		
+        /**
+         *  @private
+         */
 		override public function set text(value:String):void
 		{
 			var sp:Object = parent;

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/FilledRectangle.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/FilledRectangle.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/FilledRectangle.as
index bd69c01..4318527 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/FilledRectangle.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/FilledRectangle.as
@@ -22,8 +22,25 @@ package org.apache.flex.core
 	
 	import org.apache.flex.core.UIBase;
 	
+    /**
+     *  The FilledRectangle class draws a simple filled
+     *  rectangle without a border and with square corners.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public class FilledRectangle extends UIBase
 	{
+        /**
+         *  Constructor.
+         *  
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function FilledRectangle()
 		{
 			super();
@@ -35,21 +52,49 @@ package org.apache.flex.core
 		private var _shape:flash.display.Shape;
 		
 		private var _fillColor:uint = 0x000000;
+        
+        /**
+         *  The color of the rectangle.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function get fillColor():uint
 		{
 			return _fillColor;
 		}
+        
+        /**
+         *  @private 
+         */
 		public function set fillColor(value:uint):void
 		{
 			_fillColor = value;
 		}
 		
+        /**
+         *  @private 
+         */
 		override public function addedToParent():void
 		{
 			super.addedToParent();
 			drawRect(0, 0, this.width, this.height);
 		}
 		
+        /**
+         *  Draw the rectangle.
+         *  @param Number x The x position of the top-left corner of the rectangle.
+         *  @param Number y The y position of the top-left corner.
+         *  @param Number width The width of the rectangle.
+         *  @param Number height The height of the rectangle.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		public function drawRect(x:Number, y:Number, width:Number, height:Number):void
 		{
 			_shape.graphics.clear();

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IAlertModel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IAlertModel.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IAlertModel.as
index 03707cc..3b8475c 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IAlertModel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IAlertModel.as
@@ -20,32 +20,115 @@ package org.apache.flex.core
 {
 	import org.apache.flex.events.IEventDispatcher;
 	
+    /**
+     *  The IAlertModel interface describes the minimum set of properties
+     *  available to an Alert control.  More sophisticated Alert controls
+     *  could have models that extend IAlertModel.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IAlertModel extends IEventDispatcher, IBeadModel
 	{
+        /**
+         *  The title of the Alert.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get title():String;
 		function set title(value:String):void;
 		
+        /**
+         *  The title of the Alert as HTML.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get htmlTitle():String;
 		function set htmlTitle(value:String):void;
 		
+        /**
+         *  The message to be displayed by the Alert.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get message():String;
 		function set message(value:String):void;
 		
+        /**
+         *  The message to be displayed by the Alert as HTML.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get htmlMessage():String;
 		function set htmlMessage(value:String):void;
 		
+        /**
+         *  A bitmask of Alert constants that describe
+         *  which buttons to show in the Alert..
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get flags():uint;
 		function set flags(value:uint):void;
 		
+        /**
+         *  The label for the OK button in an Alert.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get okLabel():String;
 		function set okLabel(value:String):void;
 		
+        /**
+         *  The label for the Cancel button in an Alert.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get cancelLabel():String;
 		function set cancelLabel(value:String):void;
 		
+        /**
+         *  The label for the Yes button in an Alert.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get yesLabel():String;
 		function set yesLabel(value:String):void;
 		
+        /**
+         *  The label for the No button in an Alert.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get noLabel():String;
 		function set noLabel(value:String):void;
 	}

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBead.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBead.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBead.as
index 5367708..f2a8f91 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBead.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBead.as
@@ -18,8 +18,30 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
+    /**
+     *  The IBead interface is the basic interface for plug-ins known as Beads.
+     *  In FlexJS, the recommended pattern is to break out optional functionality
+     *  into small plug-ins that can be re-used in other components, or replaced with
+     *  different implementations optimized for different things such as size,
+     *  performance, advanced features, debugging, etc.
+     * 
+     *  Beads are told what host component or "strand" they ae attached to.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IBead
 	{
+        /**
+         *  The host component for this bead.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function set strand(value:IStrand):void
 	}
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadController.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadController.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadController.as
index fa5a8f8..fe4467f 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadController.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadController.as
@@ -18,9 +18,18 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
-	/** 
-	 *  Marker interface for Controllers
-	 */
+    /**
+     *  The IBeadController interface is a "marker" interface for beads that 
+     *  are controllers.  A marker interface has no addtional APIs.
+     *  It is used to find the controller on the strand via calls to getBeadByType.
+     * 
+     *  @see org.apache.flex.core.IStrand#getBeadByType
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IBeadController extends IBead
 	{
 		

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadLayout.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadLayout.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadLayout.as
index 662c99c..0166f24 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadLayout.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadLayout.as
@@ -18,9 +18,18 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
-	/** 
-	 *  Marker interface for Layouts
-	 */
+    /**
+     *  The IBeadLayout interface is a "marker" interface for beads that 
+     *  manage the layout for a control.  A marker interface has no addtional APIs.
+     *  It is used to find the layout bead on the strand via calls to getBeadByType.
+     * 
+     *  @see org.apache.flex.core.IStrand#getBeadByType
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IBeadLayout extends IBead
 	{
 		

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadModel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadModel.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadModel.as
index b339984..0bca57b 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadModel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadModel.as
@@ -20,9 +20,18 @@ package org.apache.flex.core
 {
 	import org.apache.flex.events.IEventDispatcher;
 
-	/** 
-	 *  Marker interface for models
-	 */
+    /**
+     *  The IBeadModel interface is a "marker" interface for beads that 
+     *  represent the data model for a control.  A marker interface has no addtional APIs.
+     *  It is used to find the model bead on the strand via calls to getBeadByType.
+     * 
+     *  @see org.apache.flex.core.IStrand#getBeadByType
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IBeadModel extends IBead, IEventDispatcher
 	{
 		

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadView.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadView.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadView.as
index 57704b5..6c224ed 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadView.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBeadView.as
@@ -19,9 +19,18 @@
 package org.apache.flex.core
 {
 
-	/** 
-	 *  Marker interface for Views
-	 */
+    /**
+     *  The IBeadView interface is a "marker" interface for beads that 
+     *  represent the view for a control.  A marker interface has no addtional APIs.
+     *  It is used to find the view bead on the strand via calls to getBeadByType.
+     * 
+     *  @see org.apache.flex.core.IStrand#getBeadByType
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IBeadView extends IBead
 	{
 	}

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBorderModel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBorderModel.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBorderModel.as
index 334ffd8..02f0b56 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBorderModel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IBorderModel.as
@@ -20,8 +20,26 @@ package org.apache.flex.core
 {
     import flash.geom.Rectangle;
 
+    /**
+     *  The IBorderModel interface is the basic interface for a data model for
+     *  drawing borders.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IBorderModel extends IBead, IBeadModel
 	{
+        /**
+         *  The offsets from the edges of the host component where
+         *  the border should be drawn.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get offsets():Rectangle;
 	}
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IChrome.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IChrome.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IChrome.as
index c53a94d..2642404 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IChrome.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IChrome.as
@@ -18,12 +18,18 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
-	/**
-	 * Items that implement IChrome are designating themselves as being attached
-	 * to their parent in a way that's different from normal content. For example,
-	 * to a Container, a child being added that's an IChrome implementor will be
-	 * added outside of the content area.
-	 */
+    /**
+     *  The IChrome interface is a "marker" interface.
+	 *  Items that implement IChrome are designating themselves as being attached
+	 *  to their parent in a way that's different from normal content. For example,
+	 *  to a Container, a child being added that's an IChrome implementor will be
+	 *  added outside of the content area.
+     * 
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IChrome
 	{
 		

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IComboBoxModel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IComboBoxModel.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IComboBoxModel.as
index f68638b..0f9b1df 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IComboBoxModel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IComboBoxModel.as
@@ -20,20 +20,87 @@ package org.apache.flex.core
 {
 	import org.apache.flex.events.IEventDispatcher;
 	
+    /**
+     *  The IComboBoxModel interface describes the minimum set of properties
+     *  available to a ComboBox control.  More sophisticated ComboBox controls
+     *  could have models that extend IComboBoxModel.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IComboBoxModel extends IEventDispatcher, IBeadModel
 	{
+        /**
+         *  The text displayed in the ComboBox.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get text():String;
 		function set text(value:String):void;
 		
+        /**
+         *  The html formatted text displayed in the ComboBox.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get html():String;
 		function set html(value:String):void;
 		
+        /**
+         *  The set of choices displayed in the ComboBox's
+         *  dropdown.  The dataProvider can be a simple 
+         *  array or vector if the set of choices is not
+         *  going to be modified (except by wholesale
+         *  replacement of the dataProvider).  To use
+         *  different kinds of data sets, you may need to
+         *  provide an alternate "mapping" bead that
+         *  iterates the dataProvider, generates item
+         *  renderers and assigns a data item to the
+         *  item renderers.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get dataProvider():Object;
 		function set dataProvider(value:Object):void;
 		
+        /**
+         *  The index of the selected item in the
+         *  dataProvider.  Values less than 0 can
+         *  have specific meanings but generally mean
+         *  that no item is selected because the
+         *  user has typed in a custom entry or has
+         *  yet to make a choice.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get selectedIndex():int;
 		function set selectedIndex(value:int):void;
 		
+        /**
+         *  The data item selected in the
+         *  dataProvider.  null usually means
+         *  that the user has not selected a value
+         *  and has typed in a custom entry.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get selectedItem():Object;
 		function set selectedItem(value:Object):void;
 	}

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IContainer.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IContainer.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IContainer.as
index 630bdbc..889a888 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IContainer.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IContainer.as
@@ -18,8 +18,30 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
+    /**
+     *  The IContainer interface is used to mark certain components as Containers.
+     *  While most components are containers in the sense that they are composited
+     *  from a set of child components, the term Container is commonly used in Flex
+     *  to denote components that take an arbitrary set or sets of children and do
+     *  not try to abstract away that fact. 
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
     public interface IContainer extends IParent
 	{
+        /**
+         *  This method is called after children have been
+         *  added to the container so the container doesn't
+         *  have to re-layout as each child is added.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function childrenAdded():void;
 	}
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataGridModel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataGridModel.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataGridModel.as
index 41b8827..5ac0584 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataGridModel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataGridModel.as
@@ -18,8 +18,26 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
+    /**
+     *  The IDataGridModel interface describes the minimum set of properties
+     *  available to an DataGrid control.  More sophisticated DataGrid controls
+     *  could have models that extend IDataGridModel.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IDataGridModel extends ISelectionModel
 	{		
+        /**
+         *  The set of DataGridColumns.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get columns():Array;
 		function set columns(value:Array):void;
 	}

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataProviderItemRendererMapper.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataProviderItemRendererMapper.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataProviderItemRendererMapper.as
index 2859b5a..0ca5f31 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataProviderItemRendererMapper.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDataProviderItemRendererMapper.as
@@ -22,12 +22,30 @@ package org.apache.flex.core
 	import org.apache.flex.core.IItemRendererClassFactory;
 
     /**
-     * Classes that generate ItemRenderers based on dataProvider contents.
-     * These classes use an IItemRendererFactory to generate the actual
-     * ItemRenderer instances
+     *  The IDataProviderItemRendererMapper interface is the interface for beads
+     *  that know how to iterate through a dataProvider, generate item renderers,
+     *  and assign items from the dataProvider to those item renderers.  In FlexJS,
+     *  a wide range of data providers are allowed, from simple Arrays and Vectors
+     *  on up to sophisticated data structures that dispatch change events.
+     *  Different IDataProviderItemRendererMapper implements are often required to
+     *  iterate through those different data structures.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
      */
 	public interface IDataProviderItemRendererMapper extends IBead
 	{
+        /**
+         *  IDataProviderItemRendererMapper use an IItemRendererClassFactory
+         *  to generate instances of item renderers.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         function get itemRendererFactory():IItemRendererClassFactory;
         function set itemRendererFactory(value:IItemRendererClassFactory):void;
 	}

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDocument.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDocument.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDocument.as
index 03bdce8..78573f7 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDocument.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IDocument.as
@@ -18,8 +18,28 @@
 ////////////////////////////////////////////////////////////////////////////////
 package org.apache.flex.core
 {
+    /**
+     *  The IDocument interface is the basic interface for objects that can be
+     *  tags in an MXML document and need to know about the host document.  It is
+     *  similar to the IMXMLObject interface in the Flex SDK.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IDocument
 	{
+        /**
+         *  This method is called to notify an instance of what MXML document
+         *  it belongs to, if any, and what its assigned id is in that
+         *  document, if any.
+         *
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function setDocument(document:Object, id:String = null):void
 	}
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IFlexInfo.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IFlexInfo.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IFlexInfo.as
index 0bd8357..984ec10 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IFlexInfo.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IFlexInfo.as
@@ -19,11 +19,25 @@
 package org.apache.flex.core
 {
     /**
-     * An object of various properties and values that are not otherwise
-     * linked in by hard class references, like styles, rsls, mixins.
+     *  The IFlexInfo interface is an interface used to signal to the compiler
+     *  that it should generate a data structure that contains information
+     *  about the application such as its size, mixins, locale, etc.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
      */
 	public interface IFlexInfo
 	{
+        /**
+         *  The compiler overrides this getter to provide the data structure.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get info():Object
 	}
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IImageModel.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IImageModel.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IImageModel.as
index dc924eb..0a664dd 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IImageModel.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IImageModel.as
@@ -20,8 +20,28 @@ package org.apache.flex.core
 {
 	import org.apache.flex.events.IEventDispatcher;
 
+    /**
+     *  The IImageModel interface describes the minimum set of properties
+     *  available to an Image control.  More sophisticated Image controls
+     *  could have models that extend IImageModel.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IImageModel extends IEventDispatcher, IBeadModel
 	{
+        /**
+         *  The source URL for the image.  Embedding images is not
+         *  recommended for FlexJS as there is no embedding support
+         *  in the browsers.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get source():String;
 		function set source(value:String):void;
 	}

http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/ec911733/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IItemRenderer.as
----------------------------------------------------------------------
diff --git a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IItemRenderer.as b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IItemRenderer.as
index b5b3f68..ca604b9 100644
--- a/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IItemRenderer.as
+++ b/frameworks/as/projects/FlexJSUI/src/org/apache/flex/core/IItemRenderer.as
@@ -20,23 +20,85 @@ package org.apache.flex.core
 {
 	import org.apache.flex.events.IEventDispatcher;
 
+    /**
+     *  The IItemRenderer interface is the basic interface for item renderers.
+     *  More complex item renderers may implements extensions of this interface.
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10.2
+     *  @playerversion AIR 2.6
+     *  @productversion FlexJS 0.0
+     */
 	public interface IItemRenderer extends IEventDispatcher
 	{
+        /**
+         *  The data item to be displayed by the item renderer.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get data():Object;
 		function set data(value:Object):void;
 		
+        /**
+         *  The property on the data item that the item renderer
+         *  should renderer.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get labelField():String;
 		function set labelField(value:String):void;
 		
+        /**
+         *  The index of the data item in the data provider.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get index():int;
 		function set index(value:int):void;
 		
+        /**
+         *  <code>true</code> if the item renderer is rendering
+         *  an item that is selected.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
 		function get selected():Boolean;
 		function set selected(value:Boolean):void;
         
+        /**
+         *  <code>true</code> if the item renderer is rendering
+         *  an item that is under the mouse pointer.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         function get hovered():Boolean;
         function set hovered(value:Boolean):void;
 
+        /**
+         *  <code>true</code> if the item renderer is rendering
+         *  an item that is under the mouse pointer and the
+         *  mouse button is down.
+         * 
+         *  @langversion 3.0
+         *  @playerversion Flash 10.2
+         *  @playerversion AIR 2.6
+         *  @productversion FlexJS 0.0
+         */
         function get down():Boolean;
         function set down(value:Boolean):void;
 	}


Mime
View raw message