Index: includes/database.pgsql.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/Attic/database.pgsql.inc,v
retrieving revision 1.68.2.7
diff -u -r1.68.2.7 database.pgsql.inc
--- includes/database.pgsql.inc	14 Sep 2009 10:49:34 -0000	1.68.2.7
+++ includes/database.pgsql.inc	22 Oct 2009 15:37:09 -0000
@@ -97,21 +97,21 @@
  * attacks.
  *
  * @param $query
- *   A string containing an SQL query.
+ *   A string containing an SQL query, using a subset of printf() syntax for
+ *   variable substitution. Supported %-modifiers are %s, %d, %f, %n,
+ *   %b (binary data, do not enclose in ''), and %%.
  * @param ...
- *   A variable number of arguments which are substituted into the query
- *   using printf() syntax. Instead of a variable number of query arguments,
+ *   A variable number of arguments which are substituted into the query's
+ *   %-modifiers. Instead of a variable number of query arguments,
  *   you may also pass a single array containing the query arguments.
- *
- *   Valid %-modifiers are: %s, %d, %f, %b (binary data, do not enclose
- *   in '') and %%.
- *
  *   NOTE: using this syntax will cast NULL and FALSE values to decimal 0,
  *   and TRUE values to decimal 1.
  *
  * @return
- *   A database query result resource, or FALSE if the query was not
- *   executed correctly.
+ *   If using PostgreSQL: a database query result resource if successful, and
+ *   FALSE if unsuccessful. If using MySQL: FALSE if unsuccessful; TRUE for
+ *   a successful UPDATE, INSERT, DELETE or similar query; a database query
+ *   result resource for a successful SELECT, SHOW, EXPLAIN, etc. query.
  */
 function db_query($query) {
   $args = func_get_args();