Add PHPDoc and fix some CS

Admin/Admin.php

@@ -45,6 +45,12 @@
 use Doctrine\Common\Util\ClassUtils;
 use Sonata\AdminBundle\Datagrid\Pager;
 
+/**
+ * Class Admin
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 abstract class Admin implements AdminInterface, DomainObjectInterface
 {
     const CONTEXT_MENU       = 'menu';

Admin/AdminExtension.php

@@ -20,6 +20,12 @@
 
 use Knp\Menu\ItemInterface as MenuItemInterface;
 
+/**
+ * Class AdminExtension
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 abstract class AdminExtension implements AdminExtensionInterface
 {
     /**

Admin/AdminExtensionInterface.php

@@ -1,4 +1,5 @@
 <?php
+
 /*
  * This file is part of the Sonata package.
  *
@@ -21,7 +22,10 @@
 use Knp\Menu\ItemInterface as MenuItemInterface;
 
 /**
+ * Interface AdminExtensionInterface
  *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
  */
 interface AdminExtensionInterface
 {
@@ -41,7 +45,7 @@ public function configureListFields(ListMapper $list);
     public function configureDatagridFilters(DatagridMapper $filter);
 
     /**
-     * @param ShowMapper $filter
+     * @param ShowMapper $show
      */
     public function configureShowFields(ShowMapper $show);
 

Admin/AdminHelper.php

@@ -1,4 +1,5 @@
 <?php
+
 /*
  * This file is part of the Sonata package.
  *
@@ -18,6 +19,12 @@
 use Sonata\AdminBundle\Util\FormViewIterator;
 use Sonata\AdminBundle\Util\FormBuilderIterator;
 
+/**
+ * Class AdminHelper
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class AdminHelper
 {
     protected $pool;

Admin/AdminInterface.php

@@ -28,6 +28,12 @@
 use Symfony\Component\Translation\TranslatorInterface;
 use Symfony\Component\HttpFoundation\Request;
 
+/**
+ * Interface AdminInterface
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface AdminInterface
 {
     /**

Admin/FieldDescriptionCollection.php

@@ -1,4 +1,5 @@
 <?php
+
 /*
  * This file is part of the Sonata package.
  *
@@ -8,8 +9,15 @@
  * file that was distributed with this source code.
  *
  */
+
 namespace Sonata\AdminBundle\Admin;
 
+/**
+ * Class FieldDescriptionCollection
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class FieldDescriptionCollection implements \ArrayAccess, \Countable
 {
     protected $elements = array();

Admin/FieldDescriptionInterface.php

@@ -11,9 +11,14 @@
 
 namespace Sonata\AdminBundle\Admin;
 
+/**
+ * Interface FieldDescriptionInterface
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface FieldDescriptionInterface
 {
-
     /**
      * set the field name
      *

Admin/Pool.php

@@ -13,6 +13,12 @@
 
 use Symfony\Component\DependencyInjection\ContainerInterface;
 
+/**
+ * Class Pool
+ *
+ * @package Sonata\AdminBundle\Admin
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class Pool
 {
     protected $container = null;

Block/AdminListBlockService.php

@@ -14,16 +14,15 @@
 use Sonata\BlockBundle\Block\BlockContextInterface;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Bundle\FrameworkBundle\Templating\EngineInterface;
-use Sonata\AdminBundle\Form\FormMapper;
-use Sonata\CoreBundle\Validator\ErrorElement;
 use Sonata\AdminBundle\Admin\Pool;
-use Sonata\BlockBundle\Model\BlockInterface;
 use Sonata\BlockBundle\Block\BaseBlockService;
 use Symfony\Component\OptionsResolver\OptionsResolverInterface;
 
 /**
+ * Class AdminListBlockService
  *
- * @author     Thomas Rabaix <[email protected]>
+ * @package Sonata\AdminBundle\Block
+ * @author  Thomas Rabaix <[email protected]>
  */
 class AdminListBlockService extends BaseBlockService
 {

Block/AdminSearchBlockService.php

@@ -18,19 +18,16 @@
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Bundle\FrameworkBundle\Templating\EngineInterface;
 
-use Sonata\AdminBundle\Form\FormMapper;
-use Sonata\CoreBundle\Validator\ErrorElement;
 use Sonata\AdminBundle\Admin\Pool;
-
-use Sonata\BlockBundle\Model\BlockInterface;
 use Sonata\BlockBundle\Block\BaseBlockService;
-use Symfony\Component\OptionsResolver\OptionsResolver;
 use Symfony\Component\OptionsResolver\OptionsResolverInterface;
 use Symfony\Component\Security\Core\Exception\AccessDeniedException;
 
 /**
+ * Class AdminSearchBlockService
  *
- * @author     Thomas Rabaix <[email protected]>
+ * @package Sonata\AdminBundle\Block
+ * @author  Thomas Rabaix <[email protected]>
  */
 class AdminSearchBlockService extends BaseBlockService
 {

Block/AdminStatsBlockService.php

@@ -14,14 +14,14 @@
 use Sonata\BlockBundle\Block\BlockContextInterface;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Bundle\FrameworkBundle\Templating\EngineInterface;
-use Sonata\CoreBundle\Validator\ErrorElement;
 use Sonata\AdminBundle\Admin\Pool;
-use Sonata\BlockBundle\Model\BlockInterface;
 use Sonata\BlockBundle\Block\BaseBlockService;
 use Symfony\Component\OptionsResolver\OptionsResolverInterface;
 
 /**
+ * Class AdminStatsBlockService
  *
+ * @package Sonata\AdminBundle\Block
  * @author  Thomas Rabaix <[email protected]>
  */
 class AdminStatsBlockService extends BaseBlockService

Builder/BuilderInterface.php

@@ -14,6 +14,12 @@
 use Sonata\AdminBundle\Admin\FieldDescriptionInterface;
 use Sonata\AdminBundle\Admin\AdminInterface;
 
+/**
+ * Interface BuilderInterface
+ *
+ * @package Sonata\AdminBundle\Builder
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface BuilderInterface
 {
     /**

Builder/DatagridBuilderInterface.php

@@ -15,9 +15,14 @@
 use Sonata\AdminBundle\Admin\AdminInterface;
 use Sonata\AdminBundle\Datagrid\DatagridInterface;
 
+/**
+ * Interface DatagridBuilderInterface
+ *
+ * @package Sonata\AdminBundle\Builder
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface DatagridBuilderInterface extends BuilderInterface
 {
-
     /**
      * @abstract
      *

Builder/FormContractorInterface.php

@@ -15,9 +15,14 @@
 use Symfony\Component\Form\FormBuilder;
 use Symfony\Component\Form\FormFactoryInterface;
 
+/**
+ * Interface FormContractorInterface
+ *
+ * @package Sonata\AdminBundle\Builder
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface FormContractorInterface extends BuilderInterface
 {
-
     /**
      * @abstract
      *

Builder/ListBuilderInterface.php

@@ -15,6 +15,12 @@
 use Sonata\AdminBundle\Admin\AdminInterface;
 use Sonata\AdminBundle\Admin\FieldDescriptionCollection;
 
+/**
+ * Interface ListBuilderInterface
+ *
+ * @package Sonata\AdminBundle\Builder
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface ListBuilderInterface extends BuilderInterface
 {
     /**

Builder/RouteBuilderInterface.php

@@ -14,9 +14,14 @@
 use Sonata\AdminBundle\Admin\AdminInterface;
 use Sonata\AdminBundle\Route\RouteCollection;
 
+/**
+ * Interface RouteBuilderInterface
+ *
+ * @package Sonata\AdminBundle\Builder
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface RouteBuilderInterface
 {
-
     /**
      * @param \Sonata\AdminBundle\Admin\AdminInterface  $admin
      * @param \Sonata\AdminBundle\Route\RouteCollection $collection

Builder/ShowBuilderInterface.php

@@ -15,6 +15,12 @@
 use Sonata\AdminBundle\Admin\AdminInterface;
 use Sonata\AdminBundle\Admin\FieldDescriptionCollection;
 
+/**
+ * Interface ShowBuilderInterface
+ *
+ * @package Sonata\AdminBundle\Builder
+ * @author  Thomas Rabaix <[email protected]>
+ */
 interface ShowBuilderInterface extends BuilderInterface
 {
     /**

Command/CreateClassCacheCommand.php

@@ -14,12 +14,16 @@
 use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Output\Output;
 use Symfony\Component\ClassLoader\ClassCollectionLoader;
 
+/**
+ * Class CreateClassCacheCommand
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class CreateClassCacheCommand extends ContainerAwareCommand
 {
-
     /**
      * {@inheritDoc}
      */

Command/ExplainAdminCommand.php

@@ -15,11 +15,15 @@
 use Symfony\Component\Console\Input\InputArgument;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Output\Output;
 
+/**
+ * Class ExplainAdminCommand
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class ExplainAdminCommand extends ContainerAwareCommand
 {
-
     /**
      * {@inheritDoc}
      */

Command/GenerateAdminCommand.php

@@ -30,8 +30,11 @@
 use Symfony\Component\Console\Question\ConfirmationQuestion;
 
 /**
- * @author Marek Stipek <[email protected]>
- * @author Simon Cosandey <[email protected]>
+ * Class GenerateAdminCommand
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Marek Stipek <[email protected]>
+ * @author  Simon Cosandey <[email protected]>
  */
 class GenerateAdminCommand extends ContainerAwareCommand
 {

Command/GenerateObjectAclCommand.php

@@ -16,10 +16,14 @@
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Output\Output;
-
 use Sonata\AdminBundle\Util\ObjectAclManipulatorInterface;
 
+/**
+ * Class GenerateObjectAclCommand
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class GenerateObjectAclCommand extends ContainerAwareCommand
 {
     /**

Command/ListAdminCommand.php

@@ -14,8 +14,13 @@
 use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Output\Output;
 
+/**
+ * Class ListAdminCommand
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class ListAdminCommand extends ContainerAwareCommand
 {
     /**

Command/SetupAclCommand.php

@@ -14,10 +14,14 @@
 use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Output\Output;
-
 use Sonata\AdminBundle\Util\AdminAclManipulatorInterface;
 
+/**
+ * Class SetupAclCommand
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class SetupAclCommand extends ContainerAwareCommand
 {
     /**

Command/Validators.php

@@ -11,6 +11,12 @@
 
 namespace Sonata\AdminBundle\Command;
 
+/**
+ * Class Validators
+ *
+ * @package Sonata\AdminBundle\Command
+ * @author  Thomas Rabaix <[email protected]>
+ */
 class Validators
 {
     /**