fixed some phpdocs, added some missing

src/Silex/Controller.php

@@ -18,7 +18,7 @@ use Symfony\Component\Routing\Route;
 /**
  * A wrapper for a controller, mapped to a route.
  *
- * @author Igor Wiedler igor@wiedler.ch
+ * @author Igor Wiedler <igor@wiedler.ch>
  */
 class Controller
 {

src/Silex/ControllerCollection.php

@@ -20,7 +20,7 @@ use Symfony\Component\Routing\RouteCollection;
  * until flush() is called, at which point all controllers are frozen and
  * added to the RouteCollection.
  *
- * @author Igor Wiedler igor@wiedler.ch
+ * @author Igor Wiedler <igor@wiedler.ch>
  */
 class ControllerCollection
 {

src/Silex/ControllerResolver.php

@@ -16,7 +16,7 @@ use Symfony\Component\HttpKernel\Log\LoggerInterface;
 use Symfony\Component\HttpFoundation\Request;
 
 /**
- * ControllerResolver.
+ * Adds Application as a valid argument for controllers.
  *
  * @author Fabien Potencier <fabien@symfony.com>
  */

src/Silex/Exception/ControllerFrozenException.php

@@ -14,7 +14,7 @@ namespace Silex\Exception;
 /**
  * Exception, is thrown when a frozen controller is modified
  *
- * @author Igor Wiedler igor@wiedler.ch
+ * @author Igor Wiedler <igor@wiedler.ch>
  */
 class ControllerFrozenException extends \RuntimeException
 {

src/Silex/Extension/DoctrineExtension.php

@@ -17,6 +17,11 @@ use Doctrine\DBAL\DriverManager;
 use Doctrine\DBAL\Configuration;
 use Doctrine\Common\EventManager;
 
+/**
+ * Doctrine DBAL extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class DoctrineExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/FormExtension.php

@@ -19,6 +19,11 @@ use Symfony\Component\Form\Extension\Core\CoreExtension;
 use Symfony\Component\Form\Extension\Validator\ValidatorExtension as FormValidatorExtension;
 use Symfony\Component\Form\Extension\Csrf\CsrfExtension;
 
+/**
+ * Symfony Form component extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class FormExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/HttpCacheExtension.php

@@ -17,6 +17,11 @@ use Silex\HttpCache;
 use Symfony\Component\HttpKernel\HttpCache\Esi;
 use Symfony\Component\HttpKernel\HttpCache\Store;
 
+/**
+ * Symfony HttpKernel component extension for HTTP cache.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class HttpCacheExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/MonologExtension.php

@@ -19,6 +19,11 @@ use Silex\ExtensionInterface;
 
 use Symfony\Component\HttpKernel\Exception\HttpException;
 
+/**
+ * Monolog extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class MonologExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/SessionExtension.php

@@ -18,6 +18,11 @@ use Symfony\Component\HttpFoundation\SessionStorage\NativeSessionStorage;
 use Symfony\Component\HttpFoundation\Session;
 use Symfony\Component\HttpKernel\KernelEvents;
 
+/**
+ * Symfony HttpFoundation component extension for sessions.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class SessionExtension implements ExtensionInterface
 {
     private $app;

src/Silex/Extension/SwiftmailerExtension.php

@@ -14,6 +14,11 @@ namespace Silex\Extension;
 use Silex\Application;
 use Silex\ExtensionInterface;
 
+/**
+ * Swiftmailer extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class SwiftmailerExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/SymfonyBridgesExtension.php

@@ -14,6 +14,11 @@ namespace Silex\Extension;
 use Silex\Application;
 use Silex\ExtensionInterface;
 
+/**
+ * Symfony bridges extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class SymfonyBridgesExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/TranslationExtension.php

@@ -18,6 +18,11 @@ use Symfony\Component\Translation\Translator;
 use Symfony\Component\Translation\MessageSelector;
 use Symfony\Component\Translation\Loader\ArrayLoader;
 
+/**
+ * Symfony Translation component extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class TranslationExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/TwigExtension.php

@@ -18,6 +18,11 @@ use Symfony\Bridge\Twig\Extension\RoutingExtension as TwigRoutingExtension;
 use Symfony\Bridge\Twig\Extension\TranslationExtension as TwigTranslationExtension;
 use Symfony\Bridge\Twig\Extension\FormExtension as TwigFormExtension;
 
+/**
+ * Twig extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class TwigExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/UrlGeneratorExtension.php

@@ -16,6 +16,11 @@ use Silex\ExtensionInterface;
 
 use Symfony\Component\Routing\Generator\UrlGenerator;
 
+/**
+ * Symfony Routing component extension for URL generation.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class UrlGeneratorExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/Extension/ValidatorExtension.php

@@ -19,6 +19,11 @@ use Symfony\Component\Validator\Mapping\ClassMetadataFactory;
 use Symfony\Component\Validator\Mapping\Loader\StaticMethodLoader;
 use Symfony\Component\Validator\ConstraintValidatorFactory;
 
+/**
+ * Symfony Validator component extension.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 class ValidatorExtension implements ExtensionInterface
 {
     public function register(Application $app)

src/Silex/ExtensionInterface.php

@@ -11,7 +11,17 @@
 
 namespace Silex;
 
+/**
+ * Interface that must implement all Silex extensions.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ */
 interface ExtensionInterface
 {
+    /**
+     * Registers an extension.
+     *
+     * @param Application $app An Application instance
+     */
     function register(Application $app);
 }

src/Silex/RedirectableUrlMatcher.php

@@ -16,6 +16,8 @@ use Symfony\Component\Routing\Matcher\RedirectableUrlMatcher as BaseRedirectable
 use Symfony\Component\Routing\Matcher\RedirectableUrlMatcherInterface;
 
 /**
+ * Implements the RedirectableUrlMatcherInterface for Silex.
+ *
  * @author Fabien Potencier <fabien@symfony.com>
  */
 class RedirectableUrlMatcher extends BaseRedirectableUrlMatcher

src/Silex/SilexEvents.php

@@ -12,6 +12,8 @@
 namespace Silex;
 
 /**
+ * The Silex events.
+ *
  * @author Igor Wiedler <igor@wiedler.ch>
  */
 final class SilexEvents