Merge pull request #10110 from ravage84/3.x-validateunique

Improve return value description of validateUnique()

src/ORM/Table.php

@@ -2299,11 +2299,11 @@ public function patchEntities($entities, array $data, array $options = [])
      * the same site_id. Scoping will only be used if the scoping field is present in
      * the data to be validated.
      *
-     * @param mixed $value The value of column to be checked for uniqueness
+     * @param mixed $value The value of column to be checked for uniqueness.
      * @param array $options The options array, optionally containing the 'scope' key.
-     *   May also be the validation context if there are no options.
+     *   May also be the validation context, if there are no options.
      * @param array|null $context Either the validation context or null.
-     * @return bool true if the value is unique
+     * @return bool True, if the value is unique, or false, if a non-scalar value was given.
      */
     public function validateUnique($value, array $options, array $context = null)
     {