Merge pull request #8015 from cakephp/5.x-signatures

Fix up some common signatures.

Author: markstory

en/orm/deleting-data.rst

@@ -6,7 +6,7 @@ Deleting Data
 .. php:class:: Table
     :noindex:
 
-.. php:method:: delete(Entity $entity, $options = [])
+.. php:method:: delete(EntityInterface $entity, array $options = [])
 
 Once you've loaded an entity you can delete it by calling the originating
 table's delete method::
@@ -65,7 +65,7 @@ these options enabled would be::
 Bulk Deletes
 ------------
 
-.. php:method:: deleteMany($entities, $options = [])
+.. php:method:: deleteMany(iterable $entities, array $options = [])
 
 If you have an array of entities you want to delete you can use ``deleteMany()``
 to delete them in a single transaction::
@@ -86,7 +86,7 @@ In these cases it is more performant to use a bulk-delete to remove many rows at
 once::
 
     // Delete all the spam
-    function destroySpam()
+    public function destroySpam()
     {
         return $this->deleteAll(['is_spam' => true]);
     }
@@ -103,7 +103,7 @@ function returns the number of deleted records as an integer.
 Strict Deletes
 --------------
 
-.. php:method:: deleteOrFail($entity, $options = [])
+.. php:method:: deleteOrFail(EntityInterface $entity, array $options = [])
 
 Using this method will throw an
 :php:exc:`Cake\\ORM\\Exception\\PersistenceFailedException` if:

en/orm/saving-data.rst

@@ -1136,7 +1136,7 @@ would not normally be able to.
 Strict Saving
 =============
 
-.. php:method:: saveOrFail($entity, $options = [])
+.. php:method:: saveOrFail(EntityInterface $entity, array $options = [])
 
 Using this method will throw an
 :php:exc:`Cake\\ORM\\Exception\\PersistenceFailedException` if:
@@ -1222,7 +1222,7 @@ Instead, assign the primary key and then patch in the remaining entity data::
 Saving Multiple Entities
 ========================
 
-.. php:method:: saveMany($entities, $options = [])
+.. php:method:: saveMany(iterable $entities, array $options = [])
 
 Using this method you can save multiple entities atomically. ``$entities`` can
 be an array of entities created using ``newEntities()`` / ``patchEntities()``.

en/views/helpers/form.rst

@@ -1596,7 +1596,7 @@ use::
 Creating Date & Time Related Controls
 -------------------------------------
 
-.. php:method:: dateTime($fieldName, $options = [])
+.. php:method:: dateTime(string $fieldName, array $options = [])
 
 * ``$fieldName`` - A string that will be used as a prefix for the HTML ``name``
   attribute of the ``select`` elements.
@@ -1630,7 +1630,7 @@ Output:
 Creating Date Controls
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. php:method:: date($fieldName, $options = [])
+.. php:method:: date(string $fieldName, array $options = [])
 
 * ``$fieldName`` - A field name that will be used as a prefix for the HTML
   ``name`` attribute of the ``select`` elements.
@@ -1652,7 +1652,7 @@ Output:
 Creating Time Controls
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. php:method:: time($fieldName, $options = [])
+.. php:method:: time(string $fieldName, array $options = [])
 
 * ``$fieldName`` - A field name that will be used as a prefix for the HTML
   ``name`` attribute of the ``select`` elements.
@@ -2333,7 +2333,7 @@ Generating Entire Forms
 Creating Multiple Controls
 --------------------------
 
-.. php:method:: controls(array $fields = [], $options = [])
+.. php:method:: controls(array $fields = [], array $options = [])
 
 * ``$fields`` - An array of fields to generate. Allows setting
   custom types, labels and other options for each specified field.

en/views/helpers/html.rst

@@ -532,7 +532,7 @@ and also wanted to include **webroot/js/Blog.plugins.js**, you would::
 Creating Inline Javascript Blocks
 ---------------------------------
 
-.. php:method:: scriptBlock($code, $options = [])
+.. php:method:: scriptBlock(string $code, array $options = [])
 
 To generate Javascript blocks from PHP view code, you can use one of the script
 block methods. Scripts can either be output in place, or buffered into a block::
@@ -543,7 +543,7 @@ block methods. Scripts can either be output in place, or buffered into a block::
     // Buffer a script block to be output later.
     $this->Html->scriptBlock('alert("hi")', ['block' => true]);
 
-.. php:method:: scriptStart($options = [])
+.. php:method:: scriptStart(array $options = [])
 .. php:method:: scriptEnd()
 
 You can use the ``scriptStart()`` method to create a capturing block that will