diff --git a/core/lib/Thelia/Core/Template/Element/BaseLoop.php b/core/lib/Thelia/Core/Template/Element/BaseLoop.php
index 1293d96a6..6863f1a09 100755
--- a/core/lib/Thelia/Core/Template/Element/BaseLoop.php
+++ b/core/lib/Thelia/Core/Template/Element/BaseLoop.php
@@ -72,6 +72,12 @@ abstract class BaseLoop
         return $this->defineArgs()->addArguments($this->getDefaultArgs());
     }
 
+    /**
+     * @param \ModelCriteria $search
+     * @param null           $pagination
+     *
+     * @return array|mixed|\PropelModelPager|\PropelObjectCollection
+     */
     public function search(\ModelCriteria $search, &$pagination = null)
     {
         if($this->page !== null) {
@@ -81,6 +87,11 @@ abstract class BaseLoop
         }
     }
 
+    /**
+     * @param \ModelCriteria $search
+     *
+     * @return array|mixed|\PropelObjectCollection
+     */
     public function searchWithOffset(\ModelCriteria $search)
     {
         if($this->limit >= 0) {
@@ -91,14 +102,16 @@ abstract class BaseLoop
         return $search->find();
     }
 
+    /**
+     * @param \ModelCriteria $search
+     * @param                $pagination
+     *
+     * @return array|\PropelModelPager
+     */
     public function searchWithPagination(\ModelCriteria $search, &$pagination)
     {
         $pagination = $search->paginate($this->page, $this->limit);
 
-        //$toto = $pagination->haveToPaginate();
-        //$toto = $pagination->getNbResults();
-        //$toto2 = $pagination->count();
-
         if($this->page > $pagination->getLastPage()) {
             return array();
         } else {
@@ -128,9 +141,10 @@ abstract class BaseLoop
      *
      * you can retrieve ref value using $this->ref
      *
+     * @param $pagination
+     *
      * @return mixed
-     */
-    abstract public function exec(&$pagination);
+     */abstract public function exec(&$pagination);
 
     /**
      *
@@ -149,7 +163,7 @@ abstract class BaseLoop
      *          )
      * );
      *
-     * @return \Thelia\Core\Template\Element\LoopResult
+     * @return \Thelia\Core\Template\Loop\Argument\ArgumentCollection
      */
     abstract protected function defineArgs();
 
diff --git a/core/lib/Thelia/Core/Template/Loop/Category.php b/core/lib/Thelia/Core/Template/Loop/Category.php
index e372b2f18..55be4d69a 100755
--- a/core/lib/Thelia/Core/Template/Loop/Category.php
+++ b/core/lib/Thelia/Core/Template/Loop/Category.php
@@ -75,6 +75,9 @@ class Category extends BaseLoop
     public $random;
     public $exclude;
 
+    /**
+     * @return ArgumentCollection
+     */
     protected function defineArgs()
     {
         return new ArgumentCollection(
@@ -96,7 +99,7 @@ class Category extends BaseLoop
     }
 
     /**
-     *
+     * @param $pagination
      *
      * @return \Thelia\Core\Template\Element\LoopResult
      */