docs: Update documentation

Author: patel-vansh

user_guide_src/source/changelogs/v4.8.0.rst

@@ -60,6 +60,7 @@ Method Signature Changes
 - **Config:** ``CodeIgniter\Config\Services::request()`` no longer accepts any parameter.
 - **Database:** The following methods have had their signatures updated to remove deprecated parameters:
     - ``CodeIgniter\Database\Forge::_createTable()`` no longer accepts the deprecated ``$ifNotExists`` parameter. The method signature is now ``_createTable(string $table, array $attributes)``.
+    - ``CodeIgniter\Database\BaseBuilder::increment()`` and ``decrement()`` as well as driver-specific builders now accept a string or array for the first parameter, allowing multiple columns to be incremented/decremented in a single call. The method signatures are now ``increment(string|array $column, int $value = 1)`` and ``decrement(string|array $column, int $value = 1)``.
 
 Property Scope Changes
 ======================
@@ -200,6 +201,8 @@ Database
 Query Builder
 -------------
 
+- Added support for incrementing/decrementing multiple columns in a single call to ``BaseBuilder::increment()`` and ``decrement()`` as well as driver-specific builders. See :ref:`query-builder-increment-decrement-multiple-columns` for details.
+
 Forge
 -----
 

user_guide_src/source/database/query_builder.rst

@@ -2033,22 +2033,26 @@ Class Reference
 
     .. php:method:: increment($column[, $value = 1])
 
-        :param string $column: The name of the column to increment
-        :param int $value: The amount to increment in the column
+        :param array|string $column: The name of the column(s) to increment. If multiple, then should be an array of column names with their values.
+        :param int $value: The amount to increment in the column (will be ignored if $column is an array)
 
         Increments the value of a field by the specified amount. If the field
         is not a numeric field, like a ``VARCHAR``, it will likely be replaced
         with ``$value``.
 
+        .. note:: Prior to v4.8.0, only single columns could be incremented.
+
     .. php:method:: decrement($column[, $value = 1])
 
-        :param string $column: The name of the column to decrement
-        :param int $value:  The amount to decrement in the column
+        :param array|string $column: The name of the column(s) to decrement. If multiple, then should be an array of column names with their values.
+        :param int $value:  The amount to decrement in the column (will be ignored if $column is an array)
 
         Decrements the value of a field by the specified amount. If the field
         is not a numeric field, like a ``VARCHAR``, it will likely be replaced
         with ``$value``.
 
+        .. note:: Prior to v4.8.0, only single columns could be decremented.
+
     .. php:method:: truncate()
 
         :returns:   ``true`` on success, ``false`` on failure, string on test mode