From 223e259ba7f018635d41529a4e046e53368f0532 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Wed, 3 Jul 2013 22:28:27 +0400
Subject: [PATCH] prioritized quoting using special syntax instead of doing it
 manually

---
 docs/guide/database-basics.md | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/docs/guide/database-basics.md b/docs/guide/database-basics.md
index 56dc61f..cfb33c4 100644
--- a/docs/guide/database-basics.md
+++ b/docs/guide/database-basics.md
@@ -133,17 +133,7 @@ $connection->createCommand()->delete('tbl_user', 'status = 0')->execute();
 Quoting table and column names
 ------------------------------
 
-If you are building query string dynamically make sure you're properly quoting table and column names using
-[[\yii\db\Connection::quoteTableName()]] and [[\yii\db\Connection::quoteColumnName()]]:
-
-```php
-$column = $connection->quoteColumnName($column);
-$table = $connection->quoteTableName($table);
-$sql = "SELECT COUNT($column) FROM $table";
-$rowCount = $connection->createCommand($sql)->queryScalar();
-```
-
-Alternatively you can use special syntax when writing SQL:
+Most of the time you would use the following syntax for quoting table and column names:
 
 ```php
 $sql = "SELECT COUNT({{$column}}) FROM [[$table]]";
@@ -153,6 +143,15 @@ $rowCount = $connection->createCommand($sql)->queryScalar();
 In the code above `{{X}}` will be converted to properly quoted column name while `[[Y]]` will be converted to properly
 quoted table name.
 
+The alternative is to quote table and column names manually using [[\yii\db\Connection::quoteTableName()]] and
+[[\yii\db\Connection::quoteColumnName()]]:
+
+```php
+$column = $connection->quoteColumnName($column);
+$table = $connection->quoteTableName($table);
+$sql = "SELECT COUNT($column) FROM $table";
+$rowCount = $connection->createCommand($sql)->queryScalar();
+```
 
 Prepared statements
 -------------------