Added some docblocks to Requests.php

application/models/tables/Requests.php

@@ -24,6 +24,11 @@ class Requests extends Nmc_Db_Table
         return self::$_instance;
     }
 
+    /**
+     * Fetch a row
+     *
+     * @return Request
+     */
     public function fetchNew()
     {
         $new = parent::fetchNew();
@@ -31,6 +36,14 @@ class Requests extends Nmc_Db_Table
         return $new;
     }
 
+    /**
+     * Fetch all requests initiated by the given user.
+     * Option to include or hide completed requests.
+     *
+     * @param Person $user
+     * @param int $completedRequests
+     * @return Nmc_Db_Table_Rowset
+     */
     public function getRequestsForUser(Person $user,
                                        $completedRequests = self::COMPLETED_REQUESTS_NO)
     {
@@ -41,6 +54,14 @@ class Requests extends Nmc_Db_Table
         return $requests;
     }
 
+    /**
+     * Fetches all requests.
+     * Option to include or hide completed requests.
+     *
+     * @param string $where
+     * @param int $completedRequests
+     * @return Nmc_Db_Table_Rowset
+     */
     public function fetchAllSorted($where = null,
                                    $completedRequests = self::COMPLETED_REQUESTS_NO)
     {
@@ -91,6 +112,12 @@ class Requests extends Nmc_Db_Table
         return $requests;
     }
 
+    /**
+     * Fetch all requests currently pending at the given action
+     *
+     * @param ApprovalAction $action
+     * @return Nmc_Db_Table_Rowset
+     */
     public function fetchAllWithCurrentAction(ApprovalAction $action) {
         $db = $this->getAdapter();
         $select = new Zend_Db_Select($db);