summaryrefslogtreecommitdiff
path: root/includes/database
diff options
context:
space:
mode:
authorDries Buytaert <dries@buytaert.net>2010-09-18 01:34:37 +0000
committerDries Buytaert <dries@buytaert.net>2010-09-18 01:34:37 +0000
commit80d21ffbb2cfd8db3b81a10c6a3b757f5cc76f27 (patch)
tree61cbe274bc03c92cf7e46c02899b4ff91685f9e3 /includes/database
parentec97ffd7daeb42b21d4cc1a3bf4af7febcb8fc79 (diff)
downloadbrdo-80d21ffbb2cfd8db3b81a10c6a3b757f5cc76f27.tar.gz
brdo-80d21ffbb2cfd8db3b81a10c6a3b757f5cc76f27.tar.bz2
- Patch #909230 by chx: better db_query() docs.
Diffstat (limited to 'includes/database')
-rw-r--r--includes/database/database.inc7
1 files changed, 5 insertions, 2 deletions
diff --git a/includes/database/database.inc b/includes/database/database.inc
index 53d626df2..31a4fa645 100644
--- a/includes/database/database.inc
+++ b/includes/database/database.inc
@@ -2184,9 +2184,12 @@ function db_autoload($class) {
/**
* Executes an arbitrary query string against the active database.
*
+ * Use this function for SELECT queries if it is just a simple query string.
+ * If the caller or other modules need to change the query, use db_select()
+ * instead.
+ *
* Do not use this function for INSERT, UPDATE, or DELETE queries. Those should
- * be handled via the appropriate query builder factory. Use this function for
- * SELECT queries that do not require a query builder.
+ * be handled via db_insert(), db_update() and db_delete() respectively.
*
* @param $query
* The prepared statement query to run. Although it will accept both named and