[Routing] fix phpDoc

using inheritdoc where possible and removing api tag when parent interface has one

src/Symfony/Component/Config/Loader/DelegatingLoader.php

@@ -53,12 +53,7 @@ class DelegatingLoader extends Loader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean true if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      */
     public function supports($resource, $type = null)
     {

src/Symfony/Component/Routing/Generator/Dumper/GeneratorDumper.php

@@ -32,6 +32,9 @@ abstract class GeneratorDumper implements GeneratorDumperInterface
         $this->routes = $routes;
     }
 
+    /**
+     * {@inheritdoc}
+     */
     public function getRoutes()
     {
         return $this->routes;

src/Symfony/Component/Routing/Generator/Dumper/GeneratorDumperInterface.php

@@ -23,16 +23,12 @@ use Symfony\Component\Routing\RouteCollection;
 interface GeneratorDumperInterface
 {
     /**
-     * Dumps a set of routes to a PHP class.
-     *
-     * Available options:
-     *
-     *  * class:      The class name
-     *  * base_class: The base class name
+     * Dumps a set of routes to a string representation of executable code
+     * that can then be used to generate a URL of such a route.
      *
      * @param array $options An array of options
      *
-     * @return string A PHP class representing the generator class
+     * @return string Executable code
      */
     function dump(array $options = array());
 

src/Symfony/Component/Routing/Generator/UrlGenerator.php

@@ -50,11 +50,7 @@ class UrlGenerator implements UrlGeneratorInterface
     }
 
     /**
-     * Sets the request context.
-     *
-     * @param RequestContext $context The context
-     *
-     * @api
+     * {@inheritdoc}
      */
     public function setContext(RequestContext $context)
     {
@@ -62,9 +58,7 @@ class UrlGenerator implements UrlGeneratorInterface
     }
 
     /**
-     * Gets the request context.
-     *
-     * @return RequestContext The context
+     * {@inheritdoc}
      */
     public function getContext()
     {
@@ -72,9 +66,7 @@ class UrlGenerator implements UrlGeneratorInterface
     }
 
     /**
-     * {@inheritDoc}
-     *
-     * @api
+     * {@inheritdoc}
      */
     public function generate($name, $parameters = array(), $absolute = false)
     {

src/Symfony/Component/Routing/Loader/AnnotationClassLoader.php

@@ -160,12 +160,7 @@ abstract class AnnotationClassLoader implements LoaderInterface
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      */
     public function supports($resource, $type = null)
     {
@@ -173,18 +168,14 @@ abstract class AnnotationClassLoader implements LoaderInterface
     }
 
     /**
-     * Sets the loader resolver.
-     *
-     * @param LoaderResolverInterface $resolver A LoaderResolverInterface instance
+     * {@inheritdoc}
      */
     public function setResolver(LoaderResolverInterface $resolver)
     {
     }
 
     /**
-     * Gets the loader resolver.
-     *
-     * @return LoaderResolverInterface A LoaderResolverInterface instance
+     * {@inheritdoc}
      */
     public function getResolver()
     {

src/Symfony/Component/Routing/Loader/AnnotationDirectoryLoader.php

@@ -62,12 +62,7 @@ class AnnotationDirectoryLoader extends AnnotationFileLoader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      */
     public function supports($resource, $type = null)
     {

src/Symfony/Component/Routing/Loader/AnnotationFileLoader.php

@@ -68,12 +68,7 @@ class AnnotationFileLoader extends FileLoader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      */
     public function supports($resource, $type = null)
     {

src/Symfony/Component/Routing/Loader/ClosureLoader.php

@@ -38,12 +38,7 @@ class ClosureLoader extends Loader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      *
      * @api
      */

src/Symfony/Component/Routing/Loader/PhpFileLoader.php

@@ -48,12 +48,7 @@ class PhpFileLoader extends FileLoader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      *
      * @api
      */

src/Symfony/Component/Routing/Loader/XmlFileLoader.php

@@ -110,12 +110,7 @@ class XmlFileLoader extends FileLoader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      *
      * @api
      */

src/Symfony/Component/Routing/Loader/YamlFileLoader.php

@@ -82,12 +82,7 @@ class YamlFileLoader extends FileLoader
     }
 
     /**
-     * Returns true if this class supports the given resource.
-     *
-     * @param mixed  $resource A resource
-     * @param string $type     The resource type
-     *
-     * @return Boolean True if this class supports the given resource, false otherwise
+     * {@inheritdoc}
      *
      * @api
      */

src/Symfony/Component/Routing/Matcher/Dumper/MatcherDumper.php

@@ -33,9 +33,7 @@ abstract class MatcherDumper implements MatcherDumperInterface
     }
 
     /**
-     * Gets the routes to dump.
-     *
-     * @return RouteCollection A RouteCollection instance
+     * {@inheritdoc}
      */
     public function getRoutes()
     {

src/Symfony/Component/Routing/Matcher/Dumper/MatcherDumperInterface.php

@@ -19,21 +19,17 @@ namespace Symfony\Component\Routing\Matcher\Dumper;
 interface MatcherDumperInterface
 {
     /**
-     * Dumps a set of routes to a PHP class.
-     *
-     * Available options:
-     *
-     *  * class:      The class name
-     *  * base_class: The base class name
+     * Dumps a set of routes to a string representation of executable code
+     * that can then be used to match a request against these routes.
      *
      * @param array $options An array of options
      *
-     * @return string A PHP class representing the matcher class
+     * @return string Executable code
      */
     function dump(array $options = array());
 
     /**
-     * Gets the routes to match.
+     * Gets the routes to dump.
      *
      * @return RouteCollection A RouteCollection instance
      */

src/Symfony/Component/Routing/Matcher/RedirectableUrlMatcher.php

@@ -22,9 +22,7 @@ use Symfony\Component\Routing\Route;
 abstract class RedirectableUrlMatcher extends UrlMatcher implements RedirectableUrlMatcherInterface
 {
     /**
-     * @see UrlMatcher::match()
-     *
-     * @api
+     * {@inheritdoc}
      */
     public function match($pathinfo)
     {

src/Symfony/Component/Routing/Matcher/UrlMatcher.php

@@ -50,11 +50,7 @@ class UrlMatcher implements UrlMatcherInterface
     }
 
     /**
-     * Sets the request context.
-     *
-     * @param RequestContext $context The context
-     *
-     * @api
+     * {@inheritdoc}
      */
     public function setContext(RequestContext $context)
     {
@@ -62,9 +58,7 @@ class UrlMatcher implements UrlMatcherInterface
     }
 
     /**
-     * Gets the request context.
-     *
-     * @return RequestContext The context
+     * {@inheritdoc}
      */
     public function getContext()
     {
@@ -72,16 +66,7 @@ class UrlMatcher implements UrlMatcherInterface
     }
 
     /**
-     * Tries to match a URL with a set of routes.
-     *
-     * @param string $pathinfo The path info to be parsed (raw format, i.e. not urldecoded)
-     *
-     * @return array An array of parameters
-     *
-     * @throws ResourceNotFoundException If the resource could not be found
-     * @throws MethodNotAllowedException If the resource was found but the request method is not allowed
-     *
-     * @api
+     * {@inheritdoc}
      */
     public function match($pathinfo)
     {

src/Symfony/Component/Routing/RouteCompiler.php

@@ -21,11 +21,7 @@ class RouteCompiler implements RouteCompilerInterface
     const REGEX_DELIMITER = '#';
 
     /**
-     * Compiles the current route instance.
-     *
-     * @param Route $route A Route instance
-     *
-     * @return CompiledRoute A CompiledRoute instance
+     * {@inheritDoc}
      *
      * @throws \LogicException If a variable is referenced more than once
      */

src/Symfony/Component/Routing/Router.php

@@ -128,9 +128,7 @@ class Router implements RouterInterface
     }
 
     /**
-     * Gets the RouteCollection instance associated with this Router.
-     *
-     * @return RouteCollection A RouteCollection instance
+     * {@inheritdoc}
      */
     public function getRouteCollection()
     {
@@ -142,9 +140,7 @@ class Router implements RouterInterface
     }
 
     /**
-     * Sets the request context.
-     *
-     * @param RequestContext $context The context
+     * {@inheritdoc}
      */
     public function setContext(RequestContext $context)
     {
@@ -155,9 +151,7 @@ class Router implements RouterInterface
     }
 
     /**
-     * Gets the request context.
-     *
-     * @return RequestContext The context
+     * {@inheritdoc}
      */
     public function getContext()
     {