Add @since tags to all methods in public namespace

* enhance the app development experience - you can look up the
  method introduction right inside the code without searching
  via git blame
* easier to write apps for multiple versions

3 files changed, 14 insertions, 0 deletions

diff --git a/lib/public/http/client/iclient.php b/lib/public/http/client/iclient.php
index 88c61bc3cd5..ab907dcfb82 100644
--- a/lib/public/http/client/iclient.php
+++ b/lib/public/http/client/iclient.php
@@ -25,6 +25,7 @@ namespace OCP\Http\Client;
  * Interface IClient
  *
  * @package OCP\Http
+ * @since 8.1.0
  */
 interface IClient {
 
@@ -54,6 +55,7 @@ interface IClient {
 	 *              'debug' => true,
 	 * @return IResponse
 	 * @throws \Exception If the request could not get completed
+	 * @since 8.1.0
 	 */
 	public function get($uri, array $options = []);
 
@@ -77,6 +79,7 @@ interface IClient {
 	 *              'verify' => true, // bool or string to CA file
 	 *              'debug' => true,
 	 * @return IResponse
+	 * @since 8.1.0
 	 */
 	public function head($uri, $options = []);
 
@@ -105,6 +108,7 @@ interface IClient {
 	 *              'verify' => true, // bool or string to CA file
 	 *              'debug' => true,
 	 * @return IResponse
+	 * @since 8.1.0
 	 */
 	public function post($uri, array $options = []);
 
@@ -133,6 +137,7 @@ interface IClient {
 	 *              'verify' => true, // bool or string to CA file
 	 *              'debug' => true,
 	 * @return IResponse
+	 * @since 8.1.0
 	 */
 	public function put($uri, array $options = []);
 
@@ -161,6 +166,7 @@ interface IClient {
 	 *              'verify' => true, // bool or string to CA file
 	 *              'debug' => true,
 	 * @return IResponse
+	 * @since 8.1.0
 	 */
 	public function delete($uri, array $options = []);
 
@@ -189,6 +195,7 @@ interface IClient {
 	 *              'verify' => true, // bool or string to CA file
 	 *              'debug' => true,
 	 * @return IResponse
+	 * @since 8.1.0
 	 */
 	public function options($uri, array $options = []);
 }
diff --git a/lib/public/http/client/iclientservice.php b/lib/public/http/client/iclientservice.php
index 98cf035c71a..2a8bff7bc69 100644
--- a/lib/public/http/client/iclientservice.php
+++ b/lib/public/http/client/iclientservice.php
@@ -25,10 +25,12 @@ namespace OCP\Http\Client;
  * Interface IClientService
  *
  * @package OCP\Http
+ * @since 8.1.0
  */
 interface IClientService {
 	/**
 	 * @return IClient
+	 * @since 8.1.0
 	 */
 	public function newClient();
 }
diff --git a/lib/public/http/client/iresponse.php b/lib/public/http/client/iresponse.php
index 041d9f454e8..3a717d1650c 100644
--- a/lib/public/http/client/iresponse.php
+++ b/lib/public/http/client/iresponse.php
@@ -25,26 +25,31 @@ namespace OCP\Http\Client;
  * Interface IResponse
  *
  * @package OCP\Http
+ * @since 8.1.0
  */
 interface IResponse {
 	/**
 	 * @return string
+	 * @since 8.1.0
 	 */
 	public function getBody();
 
 	/**
 	 * @return int
+	 * @since 8.1.0
 	 */
 	public function getStatusCode();
 
 	/**
 	 * @param $key
 	 * @return string
+	 * @since 8.1.0
 	 */
 	public function getHeader($key);
 
 	/**
 	 * @return array
+	 * @since 8.1.0
 	 */
 	public function getHeaders();
 }