From 4f346f4be150109055f12ad72622552d507419fe Mon Sep 17 00:00:00 2001
From: Qiang Xue <qiang.xue@gmail.com>
Date: Wed, 1 Jan 2014 20:33:52 -0500
Subject: [PATCH] doc fix.

---
 framework/yii/db/QueryTrait.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/framework/yii/db/QueryTrait.php b/framework/yii/db/QueryTrait.php
index a963869..029b675 100644
--- a/framework/yii/db/QueryTrait.php
+++ b/framework/yii/db/QueryTrait.php
@@ -136,6 +136,9 @@ trait QueryTrait
 	 * (e.g. `['id' => SORT_ASC, 'name' => SORT_DESC]`).
 	 * The method will automatically quote the column names unless a column contains some parenthesis
 	 * (which means the column contains a DB expression).
+	 * Note that if your order-by is an expression containing commas, you should always use an array
+	 * to represent the order-by information. Otherwise, the method will not be able to correctly determine
+	 * the order-by columns.
 	 * @return static the query object itself
 	 * @see addOrderBy()
 	 */
@@ -205,4 +208,4 @@ trait QueryTrait
 		$this->offset = $offset;
 		return $this;
 	}
-}
\ No newline at end of file
+}