summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--includes/common.inc4
1 files changed, 4 insertions, 0 deletions
diff --git a/includes/common.inc b/includes/common.inc
index c684d4167..50f20e685 100644
--- a/includes/common.inc
+++ b/includes/common.inc
@@ -6899,6 +6899,10 @@ function drupal_schema_fields_sql($table, $prefix = NULL) {
/**
* Saves (inserts or updates) a record to the database based upon the schema.
*
+ * Do not use drupal_write_record() within hook_update_N() functions, since the
+ * database schema cannot be relied upon when a user is running a series of
+ * updates. Instead, use db_insert() or db_update() to save the record.
+ *
* @param $table
* The name of the table; this must be defined by a hook_schema()
* implementation.