Merge branch '4.1'

* 4.1:
  Improve is_granted documentation
  Fix phpunit command
  Replace extra ...
  [Messenger] Fix messenger.routing send_and_handle config
  Mentioned the 60 second timeout of processes
  fix #310430: DomCrawler component selectButton() docs update

Author: javiereguiluz

components/dom_crawler.rst

@@ -402,9 +402,13 @@ Forms
 ~~~~~
 
 Special treatment is also given to forms. A ``selectButton()`` method is
-available on the Crawler which returns another Crawler that matches a button
-(``input[type=submit]``, ``input[type=image]``, or a ``button``) with the
-given text. This method is especially useful because you can use it to return
+available on the Crawler which returns another Crawler that matches ``<button>``
+or ``<input type="submit">`` or ``<input type="button">`` elements (or an
+``<img>`` element inside them). The string given as argument is looked for in
+the ``id``, ``alt``, ``name``, and ``value`` attributes and the text content of
+those elements.
+
+This method is especially useful because you can use it to return
 a :class:`Symfony\\Component\\DomCrawler\\Form` object that represents the
 form that the button lives in::
 

components/process.rst

@@ -330,8 +330,8 @@ instead::
 Process Timeout
 ---------------
 
-You can limit the amount of time a process takes to complete by setting a
-timeout (in seconds)::
+By default processes have a timeout of 60 seconds, but you can change it passing
+a different timeout (in seconds) to the ``setTimeout()`` method::
 
     use Symfony\Component\Process\Process;
 

messenger.rst

@@ -325,7 +325,7 @@ A class of messages can also be routed to multiple senders by specifying a list:
             ),
         ));
 
-By specifying a ``null`` sender, you can also route a class of messages to a sender
+By specifying the ``send_and_handle`` option, you can also route a class of messages to a sender
 while still having them passed to their respective handler:
 
 .. configuration-block::
@@ -336,7 +336,9 @@ while still having them passed to their respective handler:
         framework:
             messenger:
                 routing:
-                    'My\Message\ThatIsGoingToBeSentAndHandledLocally': [amqp, ~]
+                    'My\Message\ThatIsGoingToBeSentAndHandledLocally':
+                         senders: [amqp]
+                         send_and_handle: true
 
     .. code-block:: xml
 
@@ -352,9 +354,8 @@ while still having them passed to their respective handler:
 
             <framework:config>
                 <framework:messenger>
-                    <framework:routing message-class="My\Message\ThatIsGoingToBeSentAndHandledLocally">
+                    <framework:routing message-class="My\Message\ThatIsGoingToBeSentAndHandledLocally" send-and-handle="true">
                         <framework:sender service="amqp" />
-                        <framework:sender service="" />
                     </framework:routing>
                 </framework:messenger>
             </framework:config>
@@ -366,7 +367,10 @@ while still having them passed to their respective handler:
         $container->loadFromExtension('framework', array(
             'messenger' => array(
                 'routing' => array(
-                    'My\Message\ThatIsGoingToBeSentAndHandledLocally' => array('amqp', null),
+                    'My\Message\ThatIsGoingToBeSentAndHandledLocally' => array(
+                        'senders' => array('amqp'),
+                        'send_and_handle' => true,
+                    ),
                 ),
             ),
         ));

reference/twig_reference.rst

@@ -298,15 +298,19 @@ is_granted
     {{ is_granted(role, object = null, field = null) }}
 
 ``role``
-    **type**: ``string``
+    **type**: ``string``, ``string[]``
 ``object`` *(optional)*
     **type**: ``object``
 ``field`` *(optional)*
     **type**: ``string``
 
-Returns ``true`` if the current user has the required role. Optionally,
-an object can be pasted to be used by the voter. More information can be
-found in :ref:`security-template`.
+Returns ``true`` if the current user has the given role. If several roles are
+passed in an array, returns ``true`` if the user has all of them or at least one
+of them, depending on the value of this option:
+:ref:`security.access_decision_manager.strategy <security-voters-change-strategy>`.
+
+Optionally, an object can be passed to be used by the voter. More information
+can be found in :ref:`security-template`.
 
 logout_path
 ~~~~~~~~~~~

service_container/autowiring.rst

@@ -19,7 +19,7 @@ An Autowiring Example
 ---------------------
 
 Imagine you're building an API to publish statuses on a Twitter feed, obfuscated
-with `ROT13`_... a fun encoder that shifts all characters 13 letters forward in
+with `ROT13`_, a fun encoder that shifts all characters 13 letters forward in
 the alphabet.
 
 Start by creating a ROT13 transformer class::

testing.rst

@@ -31,6 +31,14 @@ command:
 
     $ ./bin/phpunit
 
+.. note::
+
+    The ``./bin/phpunit`` command is created by :doc:`Symfony Flex </setup/flex>`
+    when installing the ``phpunit-bridge`` package. If the command is missing, you
+    can remove the package (``composer remove symfony/phpunit-bridge``) and install
+    it again. Another solution is to remove the project's ``symfony.lock`` file and
+    run ``composer install`` to force the execution of all Symfony Flex recipes.
+
 PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
 Symfony application.