Merge pull request #7009 from kenjis/fix-docs-add-deprecated

docs: add deprecated directives

Author: kenjis

user_guide_src/source/database/query_builder.rst

@@ -1799,6 +1799,9 @@ Class Reference
 
     .. php:method:: setInsertBatch($key[, $value = ''[, $escape = null]])
 
+        .. deprecated:: 4.3.0
+           Use :php:meth:`CodeIgniter\\Database\\BaseBuilder::setData()` instead.
+
         :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
@@ -1866,40 +1869,43 @@ Class Reference
 
     .. php:method:: updateFields($set, [$addToDefault = false, [$ignore = null]])
 
+        .. versionadded:: 4.3.0
+
         :param mixed $set: Row of columns or array of rows, a row is an array or object
         :param bool $addToDefault: Adds an additional column than those in dataset
         :param bool $ignore: An array of columns to ignore from those in $set
         :returns:   ``BaseBuilder`` instance (method chaining)
         :rtype:     ``BaseBuilder``
 
-        .. versionadded:: 4.3.0
-
         Used with ``updateBatch()`` and ``upsertBatch()`` methods. This defines the fields which will be updated.
 
     .. php:method:: onConstraint($set)
 
+        .. versionadded:: 4.3.0
+
         :param mixed $set: A set of fields or field used has keys or constraints
         :returns:   ``BaseBuilder`` instance (method chaining)
         :rtype:     ``BaseBuilder``
 
-        .. versionadded:: 4.3.0
-
         Used with ``updateBatch()`` and ``upsertBatch()`` methods. This takes a comma delimited string of columns, and array, associative array, or RawSql.
 
     .. php:method:: setData($set, [$escape = null, [$alias = '']])
 
+        .. versionadded:: 4.3.0
+
         :param mixed $set: Row of columns or array of rows, a row is an array or object
         :param bool $escape: Whether to escape values
         :param bool $alias: A table alias for dataset
         :returns:   ``BaseBuilder`` instance (method chaining)
         :rtype:     ``BaseBuilder``
 
-        .. versionadded:: 4.3.0
-
         Used for ``*Batch()`` methods to set data for insert, update, upsert.
 
     .. php:method:: setUpdateBatch($key[, $value = ''[, $escape = null]])
 
+        .. deprecated:: 4.3.0
+           Use :php:meth:`CodeIgniter\\Database\\BaseBuilder::setData()` instead.
+
         :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

user_guide_src/source/general/common_functions.rst

@@ -349,20 +349,20 @@ Miscellaneous Functions
 
 .. php:function:: request()
 
+    .. versionadded:: 4.3.0
+
     :returns:    The shared Request object.
     :rtype:    IncomingRequest|CLIRequest
 
-    .. versionadded:: 4.3.0
-
     This function is a wrapper for ``Services::request()``.
 
 .. php:function:: response()
 
+    .. versionadded:: 4.3.0
+
     :returns:    The shared Response object.
     :rtype:    Response
 
-    .. versionadded:: 4.3.0
-
     This function is a wrapper for ``Services::response()``.
 
 .. php:function:: route_to($method[, ...$params])

user_guide_src/source/helpers/form_helper.rst

@@ -521,11 +521,11 @@ The following functions are available:
 
 .. php:function:: validation_errors()
 
+    .. versionadded:: 4.3.0
+
     :returns:   The validation errors
     :rtype:    array
 
-    .. versionadded:: 4.3.0
-
     Returns the validation errors. First, this function checks the validation errors
     that are stored in the session. To store the errors in the session, you need to use ``withInput()`` with :php:func:`redirect() <redirect>`.
 
@@ -538,12 +538,12 @@ The following functions are available:
 
 .. php:function:: validation_list_errors($template = 'list')
 
+    .. versionadded:: 4.3.0
+
     :param    string    $template: Validation template name
     :returns:    Rendered HTML of the validation errors
     :rtype:    string
 
-    .. versionadded:: 4.3.0
-
     Returns the rendered HTML of the validation errors.
 
     The parameter ``$template`` is a Validation template name.
@@ -557,13 +557,13 @@ The following functions are available:
 
 .. php:function:: validation_show_error($field, $template = 'single')
 
+    .. versionadded:: 4.3.0
+
     :param    string    $field: Field name
     :param    string    $template: Validation template name
     :returns:    Rendered HTML of the validation error
     :rtype:    string
 
-    .. versionadded:: 4.3.0
-
     Returns a single error for the specified field in formatted HTML.
 
     The parameter ``$template`` is a Validation template name.

user_guide_src/source/libraries/cookies.rst

@@ -326,6 +326,8 @@ Class Reference
 
     .. php:method:: withNeverExpiring()
 
+        .. deprecated:: 4.2.6
+
         .. important:: This method is deprecated. It will be removed in future releases.
 
         :param string $name: