Merge branch '5.x' into 5.next

othercorey · othercorey · commit 8f9fce86c5d1 · 2024-08-12T03:50:37.000-05:00
diff --git a/README.md b/README.md
@@ -106,7 +106,7 @@ Building the PDF is a non-trivial task.
 2. Run `make latex-en`.
 3. Run `make pdf-en`.
 
-At this point the completed PDF should be in `build/latex/en/CakePHPCookbook.pdf`.
+At this point the completed PDF should be in `build/latex/en/CakePHPBook.pdf`.
 
 Contributing
 ------------
diff --git a/config/conf.py b/config/conf.py
@@ -63,7 +63,7 @@
 # (source start file, target name, title, author,
 # documentclass [howto/manual]).
 latex_documents = [
-    ('pdf-contents', 'CakePHPCookbook.tex', u'CakePHP Cookbook Documentation',
+    ('pdf-contents', 'CakePHPBook.tex', u'CakePHP Book',
      u'Cake Software Foundation', 'manual'),
 ]
 
@@ -72,15 +72,15 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    ('index', 'cakephpcookbook', u'CakePHP Cookbook Documentation',
+    ('index', 'cakephpbook', u'CakePHP Book',
      [u'CakePHP'], 1)
 ]
 
 
 # -- Options for Epub output -------------------------------------------------
 
 # Bibliographic Dublin Core info.
-epub_title = u'CakePHP Cookbook'
+epub_title = u'CakePHP Book'
 epub_author = u'Cake Software Foundation, Inc.'
 epub_publisher = u'Cake Software Foundation, Inc.'
 epub_copyright = u'%d, Cake Software Foundation, Inc.' % datetime.datetime.now().year
@@ -98,7 +98,7 @@
 epub_identifier = 'https://cakephp.org'
 
 # A unique identification for the text.
-epub_uid = 'cakephpcookbook1393624653'
+epub_uid = 'cakephpbook1393624653'
 
 # A list of files that should not be packed into the epub file.
 epub_exclude_files = [
diff --git a/en/appendices/5-0-migration-guide.rst b/en/appendices/5-0-migration-guide.rst
@@ -182,6 +182,8 @@ I18n
 
 - ``FrozenDate`` was renamed to `Date` and ``FrozenTime`` was renamed to `DateTime`.
 - ``Time`` now extends ``Cake\Chronos\ChronosTime`` and is therefore immutable.
+- ``Date`` objects do not extend ``DateTimeInterface`` anymore - therefore you can't compare them with ``DateTime`` objects.
+  See the `cakephp/chronos release documentation <https://github.com/cakephp/chronos/releases/tag/3.0.2>`__ for more information.
 - ``Date::parseDateTime()`` was removed.
 - ``Date::parseTime()`` was removed.
 - ``Date::setToStringFormat()`` and ``Date::setJsonEncodeFormat()`` no longer accept an array.
diff --git a/en/development/routing.rst b/en/development/routing.rst
@@ -637,6 +637,10 @@ the ``$options`` argument::
         $routes->connect('/{controller}');
     });
 
+Note the additional route parameters will be added to all the connected routes defined
+inside the prefix block. You will need to use all the parameters in the url array to 
+build the route later, if you don't use them you'll get a ``MissingRouteException``.
+
 Multi word prefixes are by default converted using dasherize inflection, ie ``MyPrefix``
 would be mapped to ``my-prefix`` in the URL. Make sure to set a path for such prefixes
 if you want to use a different format like for example underscoring::
diff --git a/en/index.rst b/en/index.rst
@@ -19,7 +19,7 @@ contribute any additions, deletions, or corrections to the documentation.
     Enjoy the CakePHP cookbook almost anywhere. Available as both a PDF and
     EPUB, you can now read it on more devices, as well as offline.
 
-    - `PDF <../_downloads/en/CakePHPCookbook.pdf>`_
+    - `PDF <../_downloads/en/CakePHPBook.pdf>`_
     - `EPUB <../_downloads/en/CakePHP.epub>`_
     - `Original Source <https://github.com/cakephp/docs>`_
 
diff --git a/en/views/helpers/time.rst b/en/views/helpers/time.rst
@@ -29,7 +29,7 @@ posts using the TimeHelper::
     echo $this->Time->format(
       $post->created,
       \IntlDateFormatter::FULL,
-      null,
+      false,
       $user->time_zone
     );
     // Will display 'Saturday, August 22, 2011 at 11:53:00 PM GMT'
diff --git a/es/index.rst b/es/index.rst
@@ -19,7 +19,7 @@ o corrección de la documentación.
     Disfruta del manual de CakePHP en cualquier sitio. Disponible tanto en PDF
     como en EPUB, puedes leerlo en más dispositivos y de manera offline.
 
-    - `PDF <../_downloads/es/CakePHPCookbook.pdf>`_
+    - `PDF <../_downloads/es/CakePHPBook.pdf>`_
     - `EPUB <../_downloads/es/CakePHP.epub>`_
     - `Original Source <https://github.com/cakephp/docs>`_
 
diff --git a/fr/index.rst b/fr/index.rst
@@ -22,7 +22,7 @@ la documentation.
     EPUB, vous pouvez maintenant lire les docs sur plus d'appareils et
     hors-ligne.
 
-    - `PDF <../_downloads/fr/CakePHPCookbook.pdf>`_.
+    - `PDF <../_downloads/fr/CakePHPBook.pdf>`_.
     - `EPUB <../_downloads/fr/CakePHP.epub>`_.
     - `Source originale <https://github.com/cakephp/docs>`_.
 
diff --git a/fr/views/helpers/time.rst b/fr/views/helpers/time.rst
@@ -31,7 +31,7 @@ pouvons corriger la date et le temps de nos posts en utilisant le TimeHelper::
     echo $this->Time->format(
       $post->created,
       \IntlDateFormatter::FULL,
-      null,
+      false,
       $user->time_zone
     );
     // Affichera 'Saturday, August 22, 2011 at 11:53:00 PM GMT'
diff --git a/ja/index.rst b/ja/index.rst
@@ -20,7 +20,7 @@ CakePHP クックブックは、オープンに開発されている、コミュ
     どこでも CakePHP のレシピをお楽しみいただけます。PDF と EPUB をご用意しましたので、
     多くのデバイス上でオフラインでドキュメントを読むことができます。
 
-    - `PDF (英語) <../_downloads/en/CakePHPCookbook.pdf>`_
+    - `PDF (英語) <../_downloads/en/CakePHPBook.pdf>`_
     - `EPUB <../_downloads/ja/CakePHP.epub>`_
     - `オリジナルソース <https://github.com/cakephp/docs>`_
 
diff --git a/ja/installation.rst b/ja/installation.rst
@@ -481,7 +481,7 @@ server ディレクティブの例は、次の通りです。
 
 .. note::
     最近の PHP-FPM の設定では、アドレス 127.0.0.1 の TCP 9000 ポートの代わりに unix php-fpm
-    ソケッットを待ち受けるように設定します。もし、上記の設定で 502 bad gateway エラーになった場合、
+    ソケットを待ち受けるように設定します。もし、上記の設定で 502 bad gateway エラーになった場合、
     TCP ポートの代わりに unix ソケットパスを使用するために ``fastcgi_pass`` を更新してください
     (例: fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;)。
 
diff --git a/ja/tutorials-and-examples/blog-auth-example/auth.rst b/ja/tutorials-and-examples/blog-auth-example/auth.rst
@@ -256,7 +256,7 @@ composerを使ってAuthenticationプラグインをインストールします
 デフォルトでは、認証情報はリクエストデータの ``email`` と ``password`` フィールドから
 抽出されます。認証結果は ``authentication`` という名前のリクエスト属性に注入されます。
 この結果はいつでもコントローラのアクションから
-``$this->request->getAttribute('authentication')``を使って調べることができます。
+``$this->request->getAttribute('authentication')`` を使って調べることができます。
 すべてのページは ``AuthenticationComponent`` がリクエストごとに結果をチェックしているため、
 制限されてしまいます。認証されたユーザを見つけられなかった場合は ユーザーを ``/users/login``
 のページにリダイレクトします。
diff --git a/ja/tutorials-and-examples/blog/part-two.rst b/ja/tutorials-and-examples/blog/part-two.rst
@@ -186,7 +186,7 @@ CakePHP のリバースルーティング機能を活用することができま
 この時点で、ブラウザーから http://www.example.com/articles/index を開いてみてください。
 タイトルと投稿内容のテーブル一覧がまとめられているビューが表示されるはずです。
 
-ビューの中のリンク (投稿記事のタイトルから ``/articles/view/どれかのID番号``いう表示を出します。
+ビューの中のリンク (投稿記事のタイトル) は ``/articles/view/どれかのID番号`` というリンクを表示します。
 もしそういう表示が出ない場合には、何かおかしくなってしまったか、もうすでにあなたが
 その定義作業をしてしまったから（仕事がハヤイ！）か、のどちらかです。
 そうでないなら、これから ``ArticlesController`` の中に作ってみましょう。 ::
diff --git a/ja/views/helpers/time.rst b/ja/views/helpers/time.rst
@@ -30,7 +30,7 @@ TimeHelper を使って投稿日時を補正することができます。 ::
     echo $this->Time->format(
       $post->created,
       \IntlDateFormatter::FULL,
-      null,
+      false,
       $user->time_zone
     );
     // GMT+0 のユーザーには 'Saturday, August 22, 2011 at 11:53:00 PM GMT' と
diff --git a/pt/index.rst b/pt/index.rst
@@ -20,7 +20,7 @@ quaisquer adições, exclusões ou correções para a documentação.
     Consulte o *cookbook* do CakePHP praticamente em qualquer lugar. Disponível
     como PDF e EPUB, você pode lê-lo em diversos dispositivos, e também offline.
 
-    - `PDF <../_downloads/pt/CakePHPCookbook.pdf>`_
+    - `PDF <../_downloads/pt/CakePHPBook.pdf>`_
     - `EPUB <../_downloads/pt/CakePHP.epub>`_
     - `Código-fonte Original <https://github.com/cakephp/docs>`_
 
