From 74ad156f8f86ba8d258c5c2522f98a3e8d4bd914 Mon Sep 17 00:00:00 2001
From: xue <>
Date: Fri, 25 Nov 2005 04:16:06 +0000
Subject:

---
 framework/Web/UI/WebControls/TStatements.php | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

(limited to 'framework/Web/UI/WebControls/TStatements.php')

diff --git a/framework/Web/UI/WebControls/TStatements.php b/framework/Web/UI/WebControls/TStatements.php
index 5c1ffe1e..0474acf1 100644
--- a/framework/Web/UI/WebControls/TStatements.php
+++ b/framework/Web/UI/WebControls/TStatements.php
@@ -3,9 +3,9 @@
  * TStatements class file
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
- * @link http://www.xisc.com/
- * @copyright Copyright &copy; 2004-2005, Qiang Xue
- * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @link http://www.pradosoft.com/
+ * @copyright Copyright &copy; 2005 PradoSoft
+ * @license http://www.pradosoft.com/license/
  * @version $Revision: $  $Date: $
  * @package System.Web.UI.WebControls
  */
@@ -13,13 +13,14 @@
 /**
  * TStatements class
  *
- * TStatements executes a set of PHP statements and renders the display
- * generated by the statements. The execution happens during rendering stage.
- * You can set the statements via the property <b>Statements</b>.
- * You should also specify the context object by <b>Context</b> property
- * which is used as the object in which the statements is evaluated.
- * If the <b>Context</b> property is not set, the TStatements component
- * itself will be assumed as the context.
+ * TStatements executes one or several PHP statements and renders the display
+ * generated during the execution. The execution happens during the rendering stage.
+ * The PHP statements being executed can be set via the property
+ * {@link setStatements Statements}. The context of the statemenets executed
+ * is the TStatements object itself.
+ *
+ * Note, since TStatements allows execution of arbitrary PHP statements,
+ * make sure {@link setStatements Statements} does not come directly from user input.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @version $Revision: $  $Date: $
@@ -28,6 +29,9 @@
  */
 class TStatements extends TControl
 {
+	/**
+	 * @var string PHP statements
+	 */
 	private $_s='';
 
 	/**
@@ -39,8 +43,7 @@ class TStatements extends TControl
 	}
 
 	/**
-	 * Sets the statements of the TStatements
-	 * @param string the statements to be set
+	 * @param string the PHP statements to be executed
 	 */
 	public function setStatements($value)
 	{
-- 
cgit v1.2.3