Merge branch '4.4'

* 4.4:
  Sort imports alphabetically
  cleaning up some use statements, etc
  Update routing.rst
  [#11337] Added a deprecation directive
  [Routing] Route loader service tag

Author: javiereguiluz

components/routing.rst

@@ -250,8 +250,22 @@ Annotation Routing Loaders
 Last but not least there are
 :class:`Symfony\\Component\\Routing\\Loader\\AnnotationDirectoryLoader` and
 :class:`Symfony\\Component\\Routing\\Loader\\AnnotationFileLoader` to load
-route definitions from class annotations. The specific details are left
-out here.
+route definitions from class annotations::
+
+    use Doctrine\Common\Annotations\AnnotationReader;
+    use Symfony\Bundle\FrameworkBundle\Routing\AnnotatedRouteControllerLoader;
+    use Symfony\Component\Config\FileLocator;
+    use Symfony\Component\Routing\Loader\AnnotationDirectoryLoader;
+
+    $loader = new AnnotationDirectoryLoader(
+        new FileLocator(__DIR__.'/app/controllers/'),
+        new AnnotatedRouteControllerLoader(
+            new AnnotationReader()
+        )
+    );
+
+    $routes = $loader->load(__DIR__.'/app/controllers/');
+    // ...
 
 .. include:: /_includes/_annotation_loader_tip.rst.inc
 

routing/custom_route_loader.rst

@@ -211,6 +211,15 @@ of the service whose ID is ``admin_route_loader``. Your service doesn't have to
 extend or implement any special class, but the called method must return a
 :class:`Symfony\\Component\\Routing\\RouteCollection` object.
 
+If you're using :ref:`autoconfigure <services-autoconfigure>`, your class should
+implement the :class:`Symfony\\Bundle\\FrameworkBundle\\Routing\\RouteLoaderInterface`
+interface to be tagged automatically. If you're **not using autoconfigure**,
+tag it manually with ``routing.route_loader``.
+
+.. deprecated:: 4.4
+
+    Not tagging or implementing your route loader was deprecated in Symfony 4.4.
+
 .. note::
 
     The routes defined using service route loaders will be automatically