Merge pull request #6463 from kenjis/deprecate-Cookie-withNeverExpiring

docs: deprecate Cookie::withNeverExpiring()

Author: kenjis

system/Cookie/CloneableCookieInterface.php

@@ -60,6 +60,8 @@ public function withExpired();
      * Creates a new Cookie that will virtually never expire from the browser.
      *
      * @return static
+     *
+     * @deprecated See https://github.com/codeigniter4/CodeIgniter4/pull/6413
      */
     public function withNeverExpiring();
 

system/Cookie/Cookie.php

@@ -460,7 +460,7 @@ public function withExpired()
     }
 
     /**
-     * {@inheritDoc}
+     * @deprecated See https://github.com/codeigniter4/CodeIgniter4/pull/6413
      */
     public function withNeverExpiring()
     {

user_guide_src/source/changelogs/v4.2.6.rst

@@ -27,7 +27,7 @@ none.
 Deprecations
 ************
 
-none.
+- :php:meth:`CodeIgniter\\Cookie\\Cookie::withNeverExpiring()` is deprecated.
 
 Bugs Fixed
 **********

user_guide_src/source/libraries/cookies.rst

@@ -223,7 +223,7 @@ In runtime, you can manually supply a new default using the ``Cookie::setDefault
 Class Reference
 ***************
 
-.. php:namespace:: CodeIgniter\HTTP\Cookie
+.. php:namespace:: CodeIgniter\Cookie
 
 .. php:class:: Cookie
 
@@ -326,6 +326,8 @@ Class Reference
 
     .. php:method:: withNeverExpiring()
 
+        .. important:: This method is deprecated.
+
         :param string $name:
         :rtype: ``Cookie``
         :returns: new ``Cookie`` instance