Merge pull request #387 from Art4/382-fix-deprecated-phpdoc-syntax

Fix deprecated phpdoc tag, add see tags

Author: Art4

src/Redmine/Api/AbstractApi.php

@@ -81,7 +81,7 @@ final public function getLastResponse(): Response
      *
      * @return bool
      *
-     * @deprecated since v2.1.0, because it does not correctly handle 2xx codes that are not 200 or 201, use `Redmine\Api\AbstractApi::getLastResponse()->getStatusCode()` instead
+     * @deprecated v2.1.0 It does not correctly handle 2xx codes that are not 200 or 201, use `Redmine\Api\AbstractApi::getLastResponse()->getStatusCode()` instead
      * @see AbstractApi::getLastResponse()->getStatusCode() for checking the status code directly
      */
     public function lastCallFailed()
@@ -102,7 +102,8 @@ public function lastCallFailed()
     /**
      * Perform the client get() method.
      *
-     * @deprecated since v2.6.0, use `\Redmine\Http\HttpClient::request()` instead
+     * @deprecated v2.6.0 Use `\Redmine\Http\HttpClient::request()` instead
+     * @see \Redmine\Http\HttpClient::request()
      *
      * @param string $path
      * @param bool   $decodeIfJson
@@ -141,7 +142,8 @@ protected function get($path, $decodeIfJson = true)
     /**
      * Perform the client post() method.
      *
-     * @deprecated since v2.6.0, use `\Redmine\Http\HttpClient::request()` instead
+     * @deprecated v2.6.0 Use `\Redmine\Http\HttpClient::request()` instead
+     * @see \Redmine\Http\HttpClient::request()
      *
      * @param string $path
      * @param string $data
@@ -247,7 +249,8 @@ protected function sanitizeParams(array $defaults, array $params)
      * Retrieves all the elements of a given endpoint (even if the
      * total number of elements is greater than 100).
      *
-     * @deprecated since v2.2.0, use `retrieveData()` instead
+     * @deprecated v2.2.0 Use `retrieveData()` instead
+     * @see AbstractApi::retrieveData()
      *
      * @param string $endpoint API end point
      * @param array  $params   optional parameters to be passed to the api (offset, limit, ...)
@@ -347,7 +350,8 @@ protected function retrieveData(string $endpoint, array $params = []): array
     /**
      * Attaches Custom Fields to a create/update query.
      *
-     * @deprecated since v2.3.0, use `\Redmine\Serializer\XmlSerializer::createFromArray()` instead
+     * @deprecated v2.3.0 Use `\Redmine\Serializer\XmlSerializer::createFromArray()` instead
+     * @see \Redmine\Serializer\XmlSerializer::createFromArray()
      *
      * @param SimpleXMLElement $xml    XML Element the custom fields are attached to
      * @param array            $fields array of fields to attach, each field needs name, id and value set

src/Redmine/Api/CustomField.php

@@ -40,7 +40,8 @@ final public function list(array $params = []): array
     /**
      * List custom fields.
      *
-     * @deprecated since v2.4.0, use list() instead.
+     * @deprecated v2.4.0 Use list() instead.
+     * @see CustomField::list()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_CustomFields#GET
      *

src/Redmine/Api/Group.php

@@ -46,7 +46,8 @@ final public function list(array $params = []): array
     /**
      * List groups.
      *
-     * @deprecated since v2.4.0, use list() instead.
+     * @deprecated v2.4.0 Use list() instead.
+     * @see Group::list()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_Groups#GET
      *

src/Redmine/Api/Issue.php

@@ -86,7 +86,8 @@ final public function list(array $params = []): array
     /**
      * List issues.
      *
-     * @deprecated since v2.4.0, use list() instead.
+     * @deprecated v2.4.0 Use list() instead.
+     * @see Issue::list()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_Issues
      * available $params :

src/Redmine/Api/IssueCategory.php

@@ -56,7 +56,8 @@ final public function listByProject($projectIdentifier, array $params = []): arr
     /**
      * List issue categories.
      *
-     * @deprecated since v2.4.0, use listByProject() instead.
+     * @deprecated v2.4.0 Use listByProject() instead.
+     * @see IssueCategory::listByProject()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_IssueCategories#GET
      *

src/Redmine/Api/IssuePriority.php

@@ -40,7 +40,8 @@ final public function list(array $params = []): array
     /**
      * List issue priorities.
      *
-     * @deprecated since v2.4.0, use list() instead.
+     * @deprecated v2.4.0 Use list() instead.
+     * @see IssuePriority::list()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_Enumerations#enumerationsissue_prioritiesformat
      *

src/Redmine/Api/IssueRelation.php

@@ -44,7 +44,8 @@ final public function listByIssueId(int $issueId, array $params = []): array
     /**
      * List relations of the given issue.
      *
-     * @deprecated since v2.4.0, use listByIssueId() instead.
+     * @deprecated v2.4.0 Use listByIssueId() instead.
+     * @see IssueRelation::listByIssueId()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_IssueRelations#GET
      *

src/Redmine/Api/IssueStatus.php

@@ -40,7 +40,8 @@ final public function list(array $params = []): array
     /**
      * List issue statuses.
      *
-     * @deprecated since v2.4.0, use list() instead.
+     * @deprecated v2.4.0 Use list() instead.
+     * @see IssueStatus::list()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_IssueStatuses#GET
      *

src/Redmine/Api/Membership.php

@@ -54,7 +54,8 @@ final public function listByProject($projectIdentifier, array $params = []): arr
     /**
      * List memberships for a given $project.
      *
-     * @deprecated since v2.4.0, use listByProject() instead.
+     * @deprecated v2.4.0 Use listByProject() instead.
+     * @see Membership::listByProject()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_Memberships#GET
      *

src/Redmine/Api/News.php

@@ -68,7 +68,9 @@ final public function list(array $params = []): array
     /**
      * List news (if no $project is given, it will return ALL the news).
      *
-     * @deprecated since v2.4.0, use list() or listByProject() instead.
+     * @deprecated v2.4.0 Use list() or listByProject() instead.
+     * @see News::list()
+     * @see News::listByProject()
      *
      * @see http://www.redmine.org/projects/redmine/wiki/Rest_News#GET
      *