[swiftmailer] Document whitelist option to email redirect

[TerjeBr]

The redirectPlugin in switfmailer allows you to specify a white-list of regex's that matches email addresses that are still sent to, when redirecting all email to one address.

Code was added in PR switfmailer/SwiftmailerBundle#19

[wouterj]

This has become a very long sentence, let's try to make it a bit shorter. What do you think about?

Suppose you want all emails to be sent to ``[email protected]``, except
from the emails sent to ``[email protected]``. In this case, you
can use the ``delivery_whitelist`` option:

.. configuration-block::

    .. code-block:: yaml

        # app/config/config_dev.yml
        swiftmailer:
            delivery_address: [email protected]
            delivery_whitelist:
                # all email addresses matching this regex will *not* be
                # redirected to [email protected]
                - "/@mydomain.com$/"

                # all emails sent to [email protected] won't
                # be redirected to [email protected] too
                - "/^[email protected]$/"

    .. code-block:: xml

        <?xml version="1.0" charset="UTF-8" ?>
        <container xmlns="http://symfony.com/schema/dic/services"
            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
        >
            <swiftmailer:config delivery-address="[email protected]">
                <!-- all email adress matching this regex will *not* be redirected
                    to [email protected] -->
                <swiftmailer:delivery-whitelist-pattern>/@mydomain.com$/</swiftmaler:delivery-whitelist-pattern>

                <!-- all emails sent to [email protected] won't be
                    redirectd to [email protected] too -->
                <swiftmailer:delivery-whitelist-pattern>/^[email protected]$/</swiftmailer:delivery-whitelist-pattern>
            </swiftmailer:config>

[wouterj]

could you please reformat this to only add line breaks after the first word that crosses the 72th character? I.e:

Suppose you normally in your dev environment want to have all email redirected
to a specific address, (like in the above scenario to ``dev@example,com``).
But then you may want email sent to some specific email addresses to go through
after all, and not be redirected (even if it is in the dev environment).  This
can be done by adding the ``delivery_whitelist`` option:

[TerjeBr]

done

[javiereguiluz]

In the Symfony documentation, the titles follow some special notation. That's why this should be reworded as follows (unless @xabbuh suggest other rewording):

Original:
Sending to a Specified Address, but with exceptions

New:
Sending to a Specified Address but with Exceptions

[TerjeBr]

Anything else before this can get the label finished?

[wouterj]

you should show a full XML config example here (I believe I've put an example in one of my comments in this PR)

[wouterj]

Sorry @TerjeBr, 2 more issues. After that, I'll flag it as finished and @weaverryan wil ltake a look at it.

[TerjeBr]

Ok. Done that.

[wouterj]

Thanks! I've labelled it with finished now, I hope Ryan won't test your patience for too long :)

[weaverryan]

Cool feature - I did not know about this. I've merged this into the 2.3 branch. Thanks @TerjeBr!