Correctly document new twig functions

Author: wouterj

reference/twig_reference.rst

@@ -111,7 +111,8 @@ asset
 
 Returns a public path to ``path``, which takes into account the base path
 set for the package and the URL path. More information in
-:ref:`book-templating-assets`. For asset versioning, see :ref:`ref-framework-assets-version`.
+:ref:`book-templating-assets`. For asset versioning,
+see :ref:`ref-framework-assets-version`.
 
 assets_version
 ~~~~~~~~~~~~~~
@@ -129,25 +130,50 @@ Returns the current version of the package, more information in
 absolute_url
 ~~~~~~~~~~~~
 
+.. versionadded:: 2.7
+    The ``absolute_url()`` function was introduced in Symfony 2.7.
+
 .. code-block:: jinja
 
-    {{ absolute_url(asset(path, packageName)) }}
+    {{ absolute_url(path) }}
 
 ``path``
     **type**: ``string``
-``packageName``
-    **type**: ``string`` | ``null`` **default**: ``null``
 
-Returns the absolute URL that corresponds to the given asset path and package.
-More information in :ref:`book-templating-assets`. For configuring the base URLs,
-:ref:`ref-framework-assets-base-urls`.
+Returns the absolute URL from the passed relative path. Assume the following
+code was used to render ``http://example.com/sub/list.html``:
+
+.. code-block:: jinja
+
+    {{ absolute_url('/human.txt') }}
+    {# http://example.com/human.txt #}
+
+    {{ absolute_url('something.png') }}
+    {# http://example.com/sub/something.png #}
+
+relative_path
+~~~~~~~~~~~~~
+
+.. versionadded:: 2.7
+    The ``relative_path()`` function was introduced in Symfony 2.7.
+
+.. code-block:: jinja
+
+    {{ relative_path(path) }}
 
-The absolute URLs generated with this function ignore the asset versioning.
-Combine it with the ``assets_version()`` function to append the version number:
+``path``
+    **type**: ``string``
+
+Returns the relative path from the passed absolute URL. Assume the following
+code was used to render ``http://example.com/sub/list.html``:
 
 .. code-block:: jinja
 
-    {{ absolute_url(asset('logo.png')) ~ '?' ~ assets_version('images') }}
+    {{ relative_path('http://example.com/human.txt') }}
+    {# ../human.txt #}
+
+    {{ relative_path('http://example.com/sub/something.png') }}
+    {# something.png #}
 
 form
 ~~~~