Merge branch '2.8' into 3.3

* 2.8:
  Fixes and simplifications
  Improve routing debug page
  Improved the example to generate URLs in the console
  minor #8704 Client's history clear alternative (takman1)
  use the ref role instead of URLs

Author: javiereguiluz

console/request_context.rst

@@ -72,11 +72,13 @@ from the ``router`` service and override its settings::
     {
         protected function execute(InputInterface $input, OutputInterface $output)
         {
-            $context = $this->getContainer()->get('router')->getContext();
+            $router = $this->getContainer()->get('router');
+            $context = $router->getContext();
             $context->setHost('example.com');
             $context->setScheme('https');
             $context->setBaseUrl('my/path');
 
-            // ... your code here
+            $url = $router->generate('route-name', array('param-name' => 'param-value'));
+            // ...
         }
     }

form/disabling_validation.rst

@@ -21,7 +21,6 @@ for example whether an uploaded file was too large or whether non-existing
 fields were submitted.
 
 The submission of extra form fields can be controlled with the
-`allow_extra_fields config option`_ and the maximum upload file size should be
-handled via your PHP and web server configuration.
-
-.. _`allow_extra_fields config option`: https://symfony.com/doc/current/reference/forms/types/form.html#allow-extra-fields
+:ref:`allow_extra_fields config option <form-option-allow-extra-fields>` and
+the maximum upload file size should be handled via your PHP and web server
+configuration.

reference/forms/types/form.rst

@@ -50,6 +50,8 @@ Field Options
 
 .. include:: /reference/forms/types/options/action.rst.inc
 
+.. _form-option-allow-extra-fields:
+
 allow_extra_fields
 ~~~~~~~~~~~~~~~~~~
 

routing/debug.rst

@@ -18,12 +18,16 @@ your application:
 
 .. code-block:: text
 
-    homepage              ANY       /
-    contact               GET       /contact
-    contact_process       POST      /contact
-    article_show          ANY       /articles/{_locale}/{year}/{title}.{_format}
-    blog                  ANY       /blog/{page}
-    blog_show             ANY       /blog/{slug}
+    ------------------ -------- -------- ------ ----------------------------------------------
+     Name               Method   Scheme   Host   Path
+    ------------------ -------- -------- ------ ----------------------------------------------
+     homepage           ANY      ANY      ANY    /
+     contact            GET      ANY      ANY    /contact
+     contact_process    POST     ANY      ANY    /contact
+     article_show       ANY      ANY      ANY    /articles/{_locale}/{year}/{title}.{_format}
+     blog               ANY      ANY      ANY    /blog/{page}
+     blog_show          ANY      ANY      ANY    /blog/{slug}
+    ------------------ -------- -------- ------ ----------------------------------------------
 
 You can also get very specific information on a single route by including
 the route name after the command: