use constants to choose generated URL type

Author: xabbuh

Diff for: book/routing.rst

@@ -1499,9 +1499,13 @@ to ``generate()``:
 
     .. code-block:: html+php
 
+        <?php
+        use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+        ?>
+
         <a href="<?php echo $view['router']->generate('blog_show', array(
             'slug' => 'my-blog-post',
-        ), true) ?>">
+        ), UrlGeneratorInterface::ABSOLUTE_URL) ?>">
             Read this blog post.
         </a>
 

Diff for: book/templating.rst

@@ -992,10 +992,14 @@ correctly:
 
     .. code-block:: html+php
 
+        <?php
+        use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+        ?>
+
         <a href="<?php echo $view['router']->generate(
             '_welcome',
             array(),
-            true
+            UrlGeneratorInterface::ABSOLUTE_URL
         ) ?>">Home</a>
 
 .. index::

Diff for: cookbook/controller/service.rst

@@ -269,7 +269,12 @@ controller:
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::generateUrl` (service: ``router``)
     .. code-block:: php
 
-       $router->generate($route, $params, $absolute);
+       $router->generate($route, $params, $referenceType);
+
+    .. note::
+
+        The ``$referenceType`` argument must be one of the constants defined
+        in the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface`.
 
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::getDoctrine` (service: ``doctrine``)
 

Diff for: cookbook/templating/render_without_controller.rst

@@ -68,8 +68,12 @@ this is probably only useful if you'd like to cache this page partial (see
 
     .. code-block:: html+php
 
+        <?php
+        use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+        ?>
+
         <?php echo $view['actions']->render(
-            $view['router']->generate('acme_privacy', array(), true)
+            $view['router']->generate('acme_privacy', array(), UrlGeneratorInterface::ABSOLUTE_URL)
         ) ?>
 
 .. _cookbook-templating-no-controller-caching:

Diff for: create_framework/routing.rst

@@ -208,7 +208,13 @@ impact. Want to know how to use the generator? Insanely easy::
 The code should be self-explanatory; and thanks to the context, you can even
 generate absolute URLs::
 
-    echo $generator->generate('hello', array('name' => 'Fabien'), true);
+    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+
+    echo $generator->generate(
+        'hello',
+        array('name' => 'Fabien'),
+        UrlGeneratorInterface::ABSOLUTE_URL
+    );
     // outputs something like http://example.com/somewhere/hello/Fabien
 
 .. tip::