minor #3734 Make doc clearer for the replace filter (fabpot)

This PR was merged into the 2.x branch.

Discussion
----------

Make doc clearer for the replace filter

Closes #3733

Commits
-------

c25a1ef Make doc clearer

doc/filters/replace.rst

@@ -1,26 +1,23 @@
 ``replace``
 ===========
 
-The ``replace`` filter formats a given string by replacing the placeholders
-(placeholders are free-form):
+The ``replace`` filter replaces placeholders in a string (the placeholder
+format is free-form):
 
 .. code-block:: twig
 
-    {{ "I like %this% and %that%."|replace({'%this%': foo, '%that%': "bar"}) }}
-
-    {# outputs I like foo and bar
-       if the foo parameter equals to the foo string. #}
+    {{ "I like %this% and %that%."|replace({'%this%': fruit, '%that%': "oranges"}) }}
+    {# if the "fruit" variable is set to "apples", #}
+    {# it outputs "I like apples and oranges" #}
 
     {# using % as a delimiter is purely conventional and optional #}
-
-    {{ "I like this and --that--."|replace({'this': foo, '--that--': "bar"}) }}
-
-    {# outputs I like foo and bar #}
+    {{ "I like this and --that--."|replace({'this': fruit, '--that--': "oranges"}) }}
+    {# outputs "I like apples and oranges" #}
 
 Arguments
 ---------
 
-* ``from``: The placeholder values
+* ``from``: The placeholder values as a hash
 
 .. seealso::