- Patch #276876 by mr.baileys: remove case sensitivity from variable names (get/set/del) through extra documentation.

1 files changed, 15 insertions, 3 deletions

diff --git a/includes/bootstrap.inc b/includes/bootstrap.inc
index 209a6abe8..45835e830 100644
--- a/includes/bootstrap.inc
+++ b/includes/bootstrap.inc
@@ -760,7 +760,11 @@ function variable_initialize($conf = array()) {
 }
 
 /**
- * Return a persistent variable.
+ * Returns a persistent variable.
+ *
+ * Case-sensitivity of the variable_* functions depends on the database
+ * collation used. To avoid problems, always use lower case for persistent
+ * variable names.
  *
  * @param $name
  *   The name of the variable to return.
@@ -780,7 +784,11 @@ function variable_get($name, $default = NULL) {
 }
 
 /**
- * Set a persistent variable.
+ * Sets a persistent variable.
+ *
+ * Case-sensitivity of the variable_* functions depends on the database
+ * collation used. To avoid problems, always use lower case for persistent
+ * variable names.
  *
  * @param $name
  *   The name of the variable to set.
@@ -802,7 +810,11 @@ function variable_set($name, $value) {
 }
 
 /**
- * Unset a persistent variable.
+ * Unsets a persistent variable.
+ *
+ * Case-sensitivity of the variable_* functions depends on the database
+ * collation used. To avoid problems, always use lower case for persistent
+ * variable names.
  *
  * @param $name
  *   The name of the variable to undefine.