From c4279b69ac0f2fa30fdd661083cb753965ae2850 Mon Sep 17 00:00:00 2001
From: xue <>
Date: Thu, 5 Jan 2006 03:56:16 +0000
Subject: Added documentation.

---
 framework/Web/UI/WebControls/TDataBoundControl.php  | 11 ++++++++---
 framework/Web/UI/WebControls/TDataSourceControl.php | 21 ++++++++++++++++++---
 framework/Web/UI/WebControls/TDataSourceView.php    | 21 ++++++++++++++++++---
 3 files changed, 44 insertions(+), 9 deletions(-)

diff --git a/framework/Web/UI/WebControls/TDataBoundControl.php b/framework/Web/UI/WebControls/TDataBoundControl.php
index 9eca4434..399013a2 100644
--- a/framework/Web/UI/WebControls/TDataBoundControl.php
+++ b/framework/Web/UI/WebControls/TDataBoundControl.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * TBulletedList class file
+ * TDataBoundControl class file
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.pradosoft.com/
@@ -11,14 +11,19 @@
  */
 
 /**
- * TBulletedList class
+ * TDataBoundControl class.
+ *
+ * TDataBoundControl is the based class for controls that need to populate
+ * data from data sources. It provides basic properties and methods that allow
+ * the derived controls to associate with data sources and retrieve data from them.
+ *
+ * TBC...
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @version $Revision: $  $Date: $
  * @package System.Web.UI.WebControls
  * @since 3.0
  */
-
 abstract class TDataBoundControl extends TWebControl
 {
 	private $_initialized=false;
diff --git a/framework/Web/UI/WebControls/TDataSourceControl.php b/framework/Web/UI/WebControls/TDataSourceControl.php
index b46338b1..f8944dbb 100644
--- a/framework/Web/UI/WebControls/TDataSourceControl.php
+++ b/framework/Web/UI/WebControls/TDataSourceControl.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * TBulletedList class file
+ * IDataSource, TDataSourceControl, TReadOnlyDataSource class file
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.pradosoft.com/
@@ -11,14 +11,13 @@
  */
 
 /**
- * TBulletedList class
+ * IDataSource class
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @version $Revision: $  $Date: $
  * @package System.Web.UI.WebControls
  * @since 3.0
  */
-
 interface IDataSource
 {
 	public function getView($viewName);
@@ -26,6 +25,14 @@ interface IDataSource
 	public function onDataSourceChanged($param);
 }
 
+/**
+ * TDataSourceControl class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Revision: $  $Date: $
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
 abstract class TDataSourceControl extends TControl implements IDataSource
 {
 	public function getView($viewName);
@@ -76,6 +83,14 @@ abstract class TDataSourceControl extends TControl implements IDataSource
 	}
 }
 
+/**
+ * TDataSourceControl class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Revision: $  $Date: $
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
 class TReadOnlyDataSource extends TDataSourceControl
 {
 	private $_dataSource;
diff --git a/framework/Web/UI/WebControls/TDataSourceView.php b/framework/Web/UI/WebControls/TDataSourceView.php
index 36b4ef2d..a41555d1 100644
--- a/framework/Web/UI/WebControls/TDataSourceView.php
+++ b/framework/Web/UI/WebControls/TDataSourceView.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * TBulletedList class file
+ * TDataSourceSelectParameters, TDataSourceView, TReadOnlyDataSourceView class file
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @link http://www.pradosoft.com/
@@ -11,14 +11,13 @@
  */
 
 /**
- * TBulletedList class
+ * TDataSourceSelectParameters class
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @version $Revision: $  $Date: $
  * @package System.Web.UI.WebControls
  * @since 3.0
  */
-
 class TDataSourceSelectParameters extends TComponent
 {
 	private $_retrieveTotalRowCount=false;
@@ -73,6 +72,14 @@ class TDataSourceSelectParameters extends TComponent
 	}
 }
 
+/**
+ * TDataSourceView class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Revision: $  $Date: $
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
 abstract class TDataSourceView extends TComponent
 {
 	private $_owner;
@@ -168,6 +175,14 @@ abstract class TDataSourceView extends TComponent
 	}
 }
 
+/**
+ * TReadOnlyDataSourceView class
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Revision: $  $Date: $
+ * @package System.Web.UI.WebControls
+ * @since 3.0
+ */
 class TReadOnlyDataSourceView extends TDataSourceView
 {
 	private $_dataSource=null;
-- 
cgit v1.2.3