Index: includes/database/database.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/database/database.inc,v
retrieving revision 1.136
diff -u -r1.136 database.inc
--- includes/database/database.inc	18 Sep 2010 01:34:37 -0000	1.136
+++ includes/database/database.inc	18 Sep 2010 08:04:34 -0000
@@ -101,6 +101,16 @@
  * considerably more secure against SQL injection than trying to remember
  * which values need quotation marks and string escaping and which don't.
  *
+ * Note that the above SELECT statements could also be implemented using db_select() like the following fetching 10 node:
+ * @code
+ * $n = 10;
+ * $query = db_select('node');
+ * $query->addField('node', 'nid');
+ * $query->addField('node', 'title');
+ * $query->addField('node', 'created');
+ * $query->range(0,$n);
+ * $result = $query->execute();
+ * @endcode
  * INSERT, UPDATE, and DELETE queries need special care in order to behave
  * consistently across all different databases. Therefore, they use a special
  * object-oriented API for defining a query structurally. For example, rather