Fix some PHPDoc for better IDE autocompletion

Form/FormMapper.php

@@ -27,9 +27,9 @@ class FormMapper extends BaseGroupedMapper
     protected $formBuilder;
 
     /**
-     * @param \Sonata\AdminBundle\Builder\FormContractorInterface $formContractor
-     * @param \Symfony\Component\Form\FormBuilderInterface        $formBuilder
-     * @param \Sonata\AdminBundle\Admin\AdminInterface            $admin
+     * @param FormContractorInterface $formContractor
+     * @param FormBuilderInterface    $formBuilder
+     * @param AdminInterface          $admin
      */
     public function __construct(FormContractorInterface $formContractor, FormBuilderInterface $formBuilder, AdminInterface $admin)
     {
@@ -38,9 +38,7 @@ class FormMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param array $keys field names
-     *
-     * @return \Sonata\AdminBundle\Form\FormMapper
+     * {@inheritdoc}
      */
     public function reorder(array $keys)
     {
@@ -55,7 +53,7 @@ class FormMapper extends BaseGroupedMapper
      * @param array  $options
      * @param array  $fieldDescriptionOptions
      *
-     * @return \Sonata\AdminBundle\Form\FormMapper
+     * @return $this
      */
     public function add($name, $type = null, array $options = array(), array $fieldDescriptionOptions = array())
     {
@@ -143,9 +141,7 @@ class FormMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param string $name
-     *
-     * @return FormBuilderInterface
+     * {@inheritdoc}
      */
     public function get($name)
     {
@@ -153,9 +149,7 @@ class FormMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param string $key
-     *
-     * @return boolean
+     * {@inheritdoc}
      */
     public function has($key)
     {
@@ -163,9 +157,7 @@ class FormMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param string $key
-     *
-     * @return \Sonata\AdminBundle\Form\FormMapper
+     * {@inheritdoc}
      */
     public function remove($key)
     {

Mapper/BaseGroupedMapper.php

@@ -232,7 +232,7 @@ abstract class BaseGroupedMapper extends BaseMapper
     }
 
     /**
-     * Add the fieldname to the current group
+     * Add the field name to the current group
      *
      * @param string $fieldName
      */

Mapper/BaseMapper.php

@@ -19,14 +19,13 @@ use Sonata\AdminBundle\Builder\BuilderInterface;
  */
 abstract class BaseMapper
 {
-
     protected $admin;
 
     protected $builder;
 
     /**
-     * @param \Sonata\AdminBundle\Builder\BuilderInterface $builder
-     * @param \Sonata\AdminBundle\Admin\AdminInterface     $admin
+     * @param BuilderInterface   $builder
+     * @param AdminInterface     $admin
      */
     public function __construct(BuilderInterface $builder, AdminInterface $admin)
     {
@@ -35,7 +34,7 @@ abstract class BaseMapper
     }
 
     /**
-     * @return \Sonata\AdminBundle\Admin\AdminInterface
+     * @return AdminInterface
      */
     public function getAdmin()
     {

Show/ShowMapper.php

@@ -25,9 +25,9 @@ class ShowMapper extends BaseGroupedMapper
     protected $list;
 
     /**
-     * @param \Sonata\AdminBundle\Builder\ShowBuilderInterface     $showBuilder
-     * @param \Sonata\AdminBundle\Admin\FieldDescriptionCollection $list
-     * @param \Sonata\AdminBundle\Admin\AdminInterface             $admin
+     * @param ShowBuilderInterface       $showBuilder
+     * @param FieldDescriptionCollection $list
+     * @param AdminInterface             $admin
      */
     public function __construct(ShowBuilderInterface $showBuilder, FieldDescriptionCollection $list, AdminInterface $admin)
     {
@@ -42,7 +42,7 @@ class ShowMapper extends BaseGroupedMapper
      * @param mixed $type
      * @param array $fieldDescriptionOptions
      *
-     * @return \Sonata\AdminBundle\Show\ShowMapper
+     * @return $this
      */
     public function add($name, $type = null, array $fieldDescriptionOptions = array())
     {
@@ -80,9 +80,7 @@ class ShowMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param string $name
-     *
-     * @return array
+     * {@inheritdoc}
      */
     public function get($name)
     {
@@ -90,9 +88,7 @@ class ShowMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param string $key
-     *
-     * @return bool
+     * {@inheritdoc}
      */
     public function has($key)
     {
@@ -100,9 +96,7 @@ class ShowMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param string $key
-     *
-     * @return \Sonata\AdminBundle\Show\ShowMapper
+     * {@inheritdoc}
      */
     public function remove($key)
     {
@@ -113,9 +107,7 @@ class ShowMapper extends BaseGroupedMapper
     }
 
     /**
-     * @param array $keys field names
-     *
-     * @return \Sonata\AdminBundle\Show\ShowMapper
+     * {@inheritdoc}
      */
     public function reorder(array $keys)
     {