Update Documentation

Author: sclubricants

system/Database/BaseBuilder.php

@@ -1993,6 +1993,8 @@ protected function _insertBatch(string $table, array $keys, array $values): stri
      * @param mixed $key
      *
      * @return $this|null
+     *
+     * @deprecated
      */
     public function setInsertBatch($key, string $value = '', ?bool $escape = null)
     {
@@ -2285,7 +2287,7 @@ protected function validateUpdate(): bool
     /**
      * Sets data and calls batchExecute to run queryies
      *
-     * @param array|object|null $set         a dataset or select query
+     * @param array|object|null        $set         a dataset or select query
      * @param array|RawSql|string|null $constraints
      *
      * @return false|int|string[] Number of rows affected or FALSE on failure, SQL array when testMode
@@ -2385,6 +2387,8 @@ protected function _updateBatch(string $table, array $keys, array $values): stri
      * @return $this
      *
      * @throws DatabaseException
+     *
+     * @deprecated
      */
     public function setUpdateBatch($key, string $index = '', ?bool $escape = null)
     {

user_guide_src/source/changelogs/v4.3.0.rst

@@ -46,8 +46,6 @@ Others
 - ``CITestStreamFilter::$buffer = ''`` no longer causes the filter to be registered to listen for streams. Now there
   is a ``CITestStreamFilter::registration()`` method for this. See :ref:`upgrade-430-stream-filter` for details.
 - The data structure returned by ``BaseConnection::getForeignKeyData()`` has been changed.
-- The second parameter ``$index`` of ``BaseBuilder::updateBatch()`` has changed to ``$constraints``. It now accepts an array, string, or ``RawSql``.
-- The ``$set`` parameter of ``BaseBuilder::insertBatch()`` and ``BaseBuilder::updateBatch()`` now accepts an object of a single row of data.
 
 .. _v430-interface-changes:
 
@@ -92,6 +90,9 @@ Others
 - The return type of ``CodeIgniter\Database\Database::loadForge()`` has been changed to ``Forge``.
 - The return type of ``CodeIgniter\Database\Database::loadUtils()`` has been changed to ``BaseUtils``.
 - Parameter ``$column`` has changed in ``Table::dropForeignKey()`` to ``$foreignName``.
+- The second parameter ``$index`` of ``BaseBuilder::updateBatch()`` has changed to ``$constraints``. It now accepts an array, string, or ``RawSql``.
+- The ``$set`` parameter of ``BaseBuilder::insertBatch()`` and ``BaseBuilder::updateBatch()`` now accepts an object of a single row of data.
+- The second and third parameters of ``BaseBuilder::_updateBatch()`` has changed. Instead of ``$values, $index``, it is now ``$keys, $values``.
 
 Enhancements
 ************
@@ -176,6 +177,7 @@ Deprecations
 
 - ``RouteCollection::localizeRoute()`` is deprecated.
 - ``RouteCollection::fillRouteParams()`` is deprecated. Use ``RouteCollection::buildReverseRoute()`` instead.
+- ``BaseBuilder::setUpdateBatch()`` and ``BaseBuilder::setInsertBatch()`` are depreciated. Use ``BaseBuilder::setData()`` instead.
 
 Bugs Fixed
 **********

user_guide_src/source/database/query_builder.rst

@@ -1588,16 +1588,6 @@ Class Reference
             ``INSERT`` queries will be executed, each trying to insert
             up to ``$batch_size`` rows.
 
-    .. php:method:: setInsertBatch($key[, $value = ''[, $escape = null]])
-
-        :param mixed $key: Field name or an array of field/value pairs
-        :param string $value: Field value, if $key is a single field
-        :param bool $escape: Whether to escape values
-        :returns:   ``BaseBuilder`` instance (method chaining)
-        :rtype:     ``BaseBuilder``
-
-        Adds field/value pairs to be inserted in a table later via ``insertBatch()``.
-
     .. php:method:: update([$set = null[, $where = null[, $limit = null]]])
 
         :param array $set: An associative array of field/value pairs
@@ -1660,16 +1650,6 @@ Class Reference
 
         This allows setting an alias for the psuedo table generated with ``setData()``.
 
-    .. php:method:: setUpdateBatch($key[, $value = ''[, $escape = null]])
-
-        :param mixed $key: Field name or an array of field/value pairs
-        :param string $value: Field value, if $key is a single field
-        :param bool    $escape: Whether to escape values
-        :returns:   ``BaseBuilder`` instance (method chaining)
-        :rtype:     ``BaseBuilder``
-
-        Adds field/value pairs to be updated in a table later via ``updateBatch()``.
-
     .. php:method:: replace([$set = null])
 
         :param array $set: An associative array of field/value pairs