fixed missing documentation

Author: JanMalte

lib/Redmine/Api/AbstractApi.php

@@ -38,31 +38,49 @@ public function lastCallFailed()
     }
 
     /**
-     * {@inheritDoc}
+     * Perform the client get() method.
+     *
+     * @param string $path
+     *
+     * @return array
      */
     protected function get($path)
     {
         return $this->client->get($path);
     }
 
     /**
-     * {@inheritDoc}
+     * Perform the client post() method.
+     *
+     * @param string $path
+     * @param string $data
+     *
+     * @return string|false
      */
     protected function post($path, $data)
     {
         return $this->client->post($path, $data);
     }
 
     /**
-     * {@inheritDoc}
+     * Perform the client put() method.
+     *
+     * @param string $path
+     * @param string $data
+     *
+     * @return string|false
      */
     protected function put($path, $data)
     {
         return $this->client->put($path, $data);
     }
 
     /**
-     * {@inheritDoc}
+     * Perform the client delete() method.
+     *
+     * @param string $path
+     *
+     * @return array
      */
     protected function delete($path)
     {

lib/Redmine/Api/Issue.php

@@ -196,7 +196,7 @@ public function removeWatcher($id, $watcher_user_id)
     /**
      * @param  int    $id
      * @param  string $status
-     * @return void
+     * @return SimpleXMLElement
      */
     public function setIssueStatus($id, $status)
     {
@@ -210,7 +210,7 @@ public function setIssueStatus($id, $status)
     /**
      * @param  int    $id
      * @param  string $note
-     * @return void
+     * @return SimpleXMLElement
      */
     public function addNoteToIssue($id, $note)
     {

lib/Redmine/Client.php

@@ -308,7 +308,9 @@ public function setImpersonateUser($username = null)
     }
 
     /**
-     * @return mixed
+     * Get the impersonate user.
+     *
+     * @return string|null
      */
     public function getImpersonateUser()
     {
@@ -392,6 +394,7 @@ protected function runRequest($path, $method = 'GET', $data = '')
             default: // GET
                 break;
         }
+        /* @var $response boolean|string */
         $response = curl_exec($curl);
         $this->responseCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
         $contentType = curl_getinfo($curl, CURLINFO_CONTENT_TYPE);