You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by er...@apache.org on 2014/07/28 11:30:59 UTC
[09/13] git commit: [flex-asjs] [refs/heads/VF2JS] - Added README.txt
files to a number of the FlexJS examples.
Added README.txt files to a number of the FlexJS examples.
Project: http://git-wip-us.apache.org/repos/asf/flex-asjs/repo
Commit: http://git-wip-us.apache.org/repos/asf/flex-asjs/commit/3148857a
Tree: http://git-wip-us.apache.org/repos/asf/flex-asjs/tree/3148857a
Diff: http://git-wip-us.apache.org/repos/asf/flex-asjs/diff/3148857a
Branch: refs/heads/VF2JS
Commit: 3148857aaaebba43d356dc5382946ff883048cd2
Parents: a853702
Author: Peter Ent <pe...@apache.org>
Authored: Wed Jul 23 14:15:38 2014 -0400
Committer: Erik de Bruin <er...@ixsoftware.nl>
Committed: Mon Jul 28 11:28:12 2014 +0200
----------------------------------------------------------------------
examples/DataBindingTest/src/README.txt | 52 ++++++++++++++++++++++++
examples/DataGridExample/src/README.txt | 46 +++++++++++++++++++++
examples/DateChooserExample/src/README.txt | 43 ++++++++++++++++++++
examples/DesktopMap/README.txt | 28 ++++++++++++-
examples/EffectsExample/src/README.txt | 35 ++++++++++++++++
examples/FlexJSTest_Panel/src/README.txt | 45 ++++++++++++++++++++
examples/FlexJSTest_SVG/src/README.txt | 45 ++++++++++++++++++++
examples/FlexJSTest_basic/src/README.txt | 47 +++++++++++++++++++++
examples/FlexJSTest_createjs/src/README.txt | 22 ++++++++++
examples/FormExample/src/README.txt | 45 ++++++++++++++++++++
examples/ImageTest/src/README.txt | 40 ++++++++++++++++++
examples/LanguageTests/src/README.txt | 26 ++++++++++++
examples/ListsTest/src/README.txt | 47 +++++++++++++++++++++
examples/StatesTest/src/README.txt | 47 +++++++++++++++++++++
examples/StockQuote/src/README.txt | 49 ++++++++++++++++++++++
examples/TodoListSampleApp/src/README.txt | 22 ++++++++++
16 files changed, 638 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/DataBindingTest/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/DataBindingTest/src/README.txt b/examples/DataBindingTest/src/README.txt
new file mode 100644
index 0000000..afe521b
--- /dev/null
+++ b/examples/DataBindingTest/src/README.txt
@@ -0,0 +1,52 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The DataBindingTest example shows a Flex application that can communicate with
+a third-party data source (in this case, yahoo.finance) and display the values
+returned using data binding.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+The DataBindingTest example also shows how the model-view-controller (MVC) pattern
+can be used to separate the parts of the application. This is facilitated by
+the use of FlexJS beads added to the main application that provide the
+data connection (via HTTPService) and interacting with the rest of the application
+via events.
+
+COMPONENTS and BEADS
+
+- Button
+- CheckBox
+- ComboBox
+- Container
+- Label
+- RadioButton
+- TextArea
+- TextInput
+
+- Data binding: the text properties of TextArea and Label are linked with results
+from the remote server calls.
+
+NOTES
+
+The cross-compilation to JavaScript often results in non-fatal warnings. Some of these warnings
+should be addressed in future releases of the Falcon JX compiler.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/DataGridExample/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/DataGridExample/src/README.txt b/examples/DataGridExample/src/README.txt
new file mode 100644
index 0000000..77a0b8e
--- /dev/null
+++ b/examples/DataGridExample/src/README.txt
@@ -0,0 +1,46 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The DataGridExample demonstrates the FlexJS DataGrid which is a composite
+component that is built from a set of List components; each List is a column
+in the DataGrid. The header is provided by the ButtonBar component.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+The data for the DataGrid is found in the application's model and is connected
+using a ConstantBinding bead which ties a property of a model to a property
+in a component, in this case, the DataGrid's dataProvider property.
+
+COMPONENTS and BEADS
+
+- DataGrid
+- List
+- ButtonBar
+
+- ConstantBinding
+
+NOTES
+
+The column headers - buttons in a ButtonBar - do not align correctly over each
+column.
+
+The columns scroll independently.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/DateChooserExample/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/DateChooserExample/src/README.txt b/examples/DateChooserExample/src/README.txt
new file mode 100644
index 0000000..4d147d7
--- /dev/null
+++ b/examples/DateChooserExample/src/README.txt
@@ -0,0 +1,43 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The DateChooserExample demonstrates the DateChooser and DateField components. The
+DataChooser displays a calendar in place while the DateField displays a calendar
+in a pop-up.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+Selecting a date from the DateChooser sets the date in the DateField.
+
+COMPONENTS and BEADS
+
+- DateChooser
+- DateField
+- Label
+
+NOTES
+
+In the ActionScript/SWF version, each button/date in the DateChooser has a hit area
+that's smaller than the button itself.
+
+In the ActionScript/SWF version, the last-selected date in the DateField pop-up
+calendar may remain selected.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/DesktopMap/README.txt
----------------------------------------------------------------------
diff --git a/examples/DesktopMap/README.txt b/examples/DesktopMap/README.txt
index ca46f87..30ff2ea 100644
--- a/examples/DesktopMap/README.txt
+++ b/examples/DesktopMap/README.txt
@@ -1,4 +1,23 @@
-DesktopMap Example
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
This sample FlexJS application shows how you can integrate a 3rd party library, such as Google Maps, into the
world of FlexJS.
@@ -13,3 +32,10 @@ event when the load and initialization of the API is complete.
You will need a Google API developer key. When you have it, replace --put your Google API dev token here-- with
your developer token in the MyInitialView.mxml <basic:Map> tag.
+COMPONENTS and BEADS
+
+- Container
+- DropDownList
+- Label
+- TextButton
+- TextInput
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/EffectsExample/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/EffectsExample/src/README.txt b/examples/EffectsExample/src/README.txt
new file mode 100644
index 0000000..defca90
--- /dev/null
+++ b/examples/EffectsExample/src/README.txt
@@ -0,0 +1,35 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The EffectsExample demonstrates the Move and Fade effects. This Flex application
+can be run as an ActionScript SWF or cross-compiled into a JavaScript/HTML
+application using the Falcon JX compiler.
+
+COMPONENTS and BEADS
+
+- Container
+- Image
+- Label
+- TextButton
+
+- Move
+- Fade
+
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/FlexJSTest_Panel/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/FlexJSTest_Panel/src/README.txt b/examples/FlexJSTest_Panel/src/README.txt
new file mode 100644
index 0000000..8ba1421
--- /dev/null
+++ b/examples/FlexJSTest_Panel/src/README.txt
@@ -0,0 +1,45 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The FlexJSTest_Panel application demonstrates some FlexJS common components,
+incuding Panel. The application uses a Panel to contain a sub-set of FlexJS
+components, listed below.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+COMPONENTS and BEADS
+
+- Label
+- NumericStepper
+- Panel
+- Slider
+- TextButton
+
+- NonVirtualVerticalLayout
+
+NOTES
+
+Changing the Slider updates a Label. Changing the NumericStepper changes another Label.
+
+The ActionScript version has some layout issues, chiefly the Panel background is not being
+displayed. The JavaScript version is not updating the Labels when either the Slider or
+NumericStepper is changed.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/FlexJSTest_SVG/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/FlexJSTest_SVG/src/README.txt b/examples/FlexJSTest_SVG/src/README.txt
new file mode 100644
index 0000000..5329185
--- /dev/null
+++ b/examples/FlexJSTest_SVG/src/README.txt
@@ -0,0 +1,45 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The FlexJSTest_SVG example shows how to use SVG to skin components when run in
+the HTML/JavaScript environment.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+The FlexJSTest_SVG application may be run in ActionScript, which uses standard Flash
+drawing to produce the button skin. When run in JavaScript however, SVG is used to
+make the skin.
+
+To make the skin, a new classification of TextButton was created in the
+org.apache.flex.svg package. On the ActionScript side, the svg.TextButton simply
+extends the normal TextButton. On the JavaScript side, the svg.TextButton class
+uses an SVG file (svg.assets.TextButton_skin.svg).
+
+COMPONENTS and BEADS
+
+- Label
+- TextButton
+
+NOTES
+
+Maybe a more standard or common way or place to specify skins could be developed so
+specialized packages would not always be needed.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/FlexJSTest_basic/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/FlexJSTest_basic/src/README.txt b/examples/FlexJSTest_basic/src/README.txt
new file mode 100644
index 0000000..adf23bc
--- /dev/null
+++ b/examples/FlexJSTest_basic/src/README.txt
@@ -0,0 +1,47 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The FlexJSTest_basic demonstrates a number of the common components in the FlexJS
+SDK (listed below).
+
+This Flex application may be run either as an ActionScript SWF or cross-compiled
+into JavsScript/HTML using the Falcon JX compiler and run without using the
+Flash Player.
+
+This application also uses the same financial data as the DataBindingTest,
+accessed using HTTPService, although it uses the ConstantBinding bead to
+display the remote data instead of data binding.
+
+COMPONENTS and BEADS
+
+- CheckBox
+- ComboBox
+- DropDownList
+- Label
+- List
+- RadioButton
+- TextArea
+- TextButton
+
+NOTES
+
+In ActionScript, the hit area for radio and check boxes is limited to the
+radio or check itself and not the label.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/FlexJSTest_createjs/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/FlexJSTest_createjs/src/README.txt b/examples/FlexJSTest_createjs/src/README.txt
new file mode 100644
index 0000000..3e8e2ba
--- /dev/null
+++ b/examples/FlexJSTest_createjs/src/README.txt
@@ -0,0 +1,22 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+This sample is currently not working.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/FormExample/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/FormExample/src/README.txt b/examples/FormExample/src/README.txt
new file mode 100644
index 0000000..f38df7f
--- /dev/null
+++ b/examples/FormExample/src/README.txt
@@ -0,0 +1,45 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The FormExample application demonstrates several FlexJS components and how they
+can be aligned in a column, much like you would see in a form.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+The components are placed into a Container with a VerticalColumnLayout bead. This bead
+examines each of the children in the Container and aligns them in two columns.
+
+COMPONENTS and BEADS
+
+- Container
+- DateField
+- Label
+- TextInput
+
+- NonVirtualVerticalLayout
+- NumericOnlyTextInputBead
+- VerticalColumnLayout
+
+NOTES
+
+The cross-compilation to JavaScript often results in non-fatal warnings. Some of these warnings
+should be addressed in future releases of the Falcon JX compiler.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/ImageTest/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/ImageTest/src/README.txt b/examples/ImageTest/src/README.txt
new file mode 100644
index 0000000..e6a0c71
--- /dev/null
+++ b/examples/ImageTest/src/README.txt
@@ -0,0 +1,40 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The ImageTest example is a simple demonstration of the FlexJS Image component.
+You can use this test to see if your image loads properly.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+All of the images are placed into a Container and then given various sizes.
+
+COMPONENTS and BEADS
+
+- Container
+- Image
+
+- NonVirtualVerticalLayout
+
+NOTES
+
+The cross-compilation to JavaScript often results in non-fatal warnings. Some of these warnings
+should be addressed in future releases of the Falcon JX compiler.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/LanguageTests/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/LanguageTests/src/README.txt b/examples/LanguageTests/src/README.txt
new file mode 100644
index 0000000..89f12b2
--- /dev/null
+++ b/examples/LanguageTests/src/README.txt
@@ -0,0 +1,26 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The LanguageTests example is used to test the ActionScript and cross-compiler,
+FalconJX.
+
+Compile the project using ANT and the build.xml script and then run the resulting
+index.html file in browser.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/ListsTest/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/ListsTest/src/README.txt b/examples/ListsTest/src/README.txt
new file mode 100644
index 0000000..dc48ab4
--- /dev/null
+++ b/examples/ListsTest/src/README.txt
@@ -0,0 +1,47 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The ListsTests example demonstrates the FlexJS List component using custom data
+and a custom itemRenderer.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+The data for the list is found in the application model and is bound to the list
+via ConstantBinding bead which maps the application data model's products property
+to the List's dataProvider property.
+
+The display of each element of the list is through a custom itemRenderer,
+ProductItemRenderer, which can found in the example's source tree. The itemRenderer
+uses and Image component to display an image and a Label to give a title.
+
+COMPONENTS and BEADS
+
+- Image
+- Label
+- List
+
+- ConstantBinding
+
+NOTES
+
+More control of the itemRenderer via styles would be a nice addition. ItemRenderers
+based on row or data would require a custom itemRendererFactory bead.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/StatesTest/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/StatesTest/src/README.txt b/examples/StatesTest/src/README.txt
new file mode 100644
index 0000000..9ea5dc1
--- /dev/null
+++ b/examples/StatesTest/src/README.txt
@@ -0,0 +1,47 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The StatesTest sample demonstrates how to use Flex states to alter the visual
+display. This application is based on the DataBindingTest.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+In this example, states are used to display some or all of the stock quote details.
+
+COMPONENTS and BEADS
+
+- Container
+- DropDownList
+- Label
+- RadioButton
+- TextArea
+- TextButton
+- TextInput
+
+- NonVirtualVerticalLayout
+- NumericOnlyTextInputBead
+- VerticalColumnLayout
+
+NOTES
+
+The cross-compilation to JavaScript often results in non-fatal warnings. Some of these warnings
+should be addressed in future releases of the Falcon JX compiler.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/StockQuote/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/StockQuote/src/README.txt b/examples/StockQuote/src/README.txt
new file mode 100644
index 0000000..44d8015
--- /dev/null
+++ b/examples/StockQuote/src/README.txt
@@ -0,0 +1,49 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+The StockQuote example is very closely related to the DataBindingTest and shows
+a number of FlexJS components and beads, including the HTTPService used to
+obtain the stock information.
+
+This Flex application may be run as a Flash SWF or cross-compiled (using Falcon JX)
+into JavaScript and HTML and run without Flash.
+
+COMPONENTS and BEADS
+
+- CheckBox
+- Container
+- DropDownList
+- Label
+- Panel
+- RadioButton
+- TextArea
+- TextButton
+- TextInput
+
+- ConstantBinding
+- NonVirtualHorizontalLayout
+- NonVirtualVerticalLayout
+- SimpleBinding
+
+NOTES
+
+Some work needs to be done with the layout; both ActionScript and JavaScript platforms
+are different and each requires some work.
http://git-wip-us.apache.org/repos/asf/flex-asjs/blob/3148857a/examples/TodoListSampleApp/src/README.txt
----------------------------------------------------------------------
diff --git a/examples/TodoListSampleApp/src/README.txt b/examples/TodoListSampleApp/src/README.txt
new file mode 100644
index 0000000..b3d96b9
--- /dev/null
+++ b/examples/TodoListSampleApp/src/README.txt
@@ -0,0 +1,22 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+This sample is currently under construction.