From: Aaron Schulz <aschulz@wikimedia.org>
Date: Thu, 16 Feb 2017 14:53:37 +0000 (-0800)
Subject: Add update()/insert() comments to IDatabase
X-Git-Tag: 1.31.0-rc.0~4074^2
X-Git-Url: http://git.cyclocoop.org/%7B%24admin_url%7Dmembres/cotisations/gestion/rappel_supprimer.php?a=commitdiff_plain;h=87b554ec4376301f7e1b87e1dd17894be7ec75b3;p=lhc%2Fweb%2Fwiklou.git

Add update()/insert() comments to IDatabase

Change-Id: I926554e24c06eb002de92f950725c6a3912ee06f
---

diff --git a/includes/libs/rdbms/database/IDatabase.php b/includes/libs/rdbms/database/IDatabase.php
index 591c797bb2..ec4ce8b3c2 100644
--- a/includes/libs/rdbms/database/IDatabase.php
+++ b/includes/libs/rdbms/database/IDatabase.php
@@ -908,6 +908,8 @@ interface IDatabase {
 	 * @param array $values An array of values to SET. For each array element,
 	 *   the key gives the field name, and the value gives the data to set
 	 *   that field to. The data will be quoted by IDatabase::addQuotes().
+	 *   Values with integer keys form unquoted SET statements, which can be used for
+	 *   things like "field = field + 1" or similar computed values.
 	 * @param array $conds An array of conditions (WHERE). See
 	 *   IDatabase::select() for the details of the format of condition
 	 *   arrays. Use '*' to update all rows.
@@ -1151,6 +1153,8 @@ interface IDatabase {
 	 * @param array $set An array of values to SET. For each array element, the
 	 *   key gives the field name, and the value gives the data to set that
 	 *   field to. The data will be quoted by IDatabase::addQuotes().
+	 *   Values with integer keys form unquoted SET statements, which can be used for
+	 *   things like "field = field + 1" or similar computed values.
 	 * @param string $fname Calling function name (use __METHOD__) for logs/profiling
 	 * @throws Exception
 	 * @return bool