Merge branch '4.2'

* 4.2:
  Update console.rst: reversing constants (logical purpose)
  Replacing of size to date in File Date section
  Added new UnexpectedValueException

Author: javiereguiluz

components/finder.rst

@@ -343,7 +343,7 @@ Restrict files by last modified dates with the
 
 Restrict by a date range by chaining calls or passing an array::
 
-    $finder->date('>= 2018-01-01')->size('<= 2018-12-31');
+    $finder->date('>= 2018-01-01')->date('<= 2018-12-31');
 
     // same as above
     $finder->date(array('>= 2018-01-01', '<= 2018-12-31'));

console.rst

@@ -92,7 +92,7 @@ available in the ``configure()`` method::
         {
             $this
                 // ...
-                ->addArgument('password', $this->requirePassword ? InputArgument::OPTIONAL : InputArgument::REQUIRED, 'User password')
+                ->addArgument('password', $this->requirePassword ? InputArgument::REQUIRED : InputArgument::OPTIONAL, 'User password')
             ;
         }
     }

validation/custom_constraint.rst

@@ -76,7 +76,11 @@ The validator class is also simple, and only has one required method ``validate(
             }
 
             if (!is_string($value)) {
-                throw new UnexpectedTypeException($value, 'string');
+                // throw this exception if your validator cannot handle the passed type so that it can be marked as invalid
+                throw new UnexpectedValueException($value, 'string');
+
+                // separate multiple types using pipes
+                // throw new UnexpectedValueException($value, 'string|int');
             }
 
             if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
@@ -94,6 +98,9 @@ message as its argument and returns an instance of
 :class:`Symfony\\Component\\Validator\\Violation\\ConstraintViolationBuilderInterface`.
 The ``addViolation()`` method call finally adds the violation to the context.
 
+.. versionadded:: 4.2
+    The ``UnexpectedValueException`` was introduced in Symfony 4.2.
+
 Using the new Validator
 -----------------------