From 80d21ffbb2cfd8db3b81a10c6a3b757f5cc76f27 Mon Sep 17 00:00:00 2001
From: Dries Buytaert <dries@buytaert.net>
Date: Sat, 18 Sep 2010 01:34:37 +0000
Subject: [PATCH] - Patch #909230 by chx: better db_query() docs.
---
includes/database/database.inc | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/includes/database/database.inc b/includes/database/database.inc
index 53d626df2660..31a4fa64523d 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
--
GitLab