diff --git a/lib/base.php b/lib/base.php
index 99c2764d22..ab1d8e9823 100644
--- a/lib/base.php
+++ b/lib/base.php
@@ -279,7 +279,7 @@ class OC {
 	 * check if the instance needs to preform an upgrade
 	 *
 	 * @return bool
-	 * @deprecated use \OCP\Util::needUpgrade instead
+	 * @deprecated use \OCP\Util::needUpgrade() instead
 	 */
 	public static function needUpgrade() {
 		return \OCP\Util::needUpgrade();
diff --git a/lib/private/legacy/search.php b/lib/private/legacy/search.php
index f77b43be2e..8c348c9586 100644
--- a/lib/private/legacy/search.php
+++ b/lib/private/legacy/search.php
@@ -22,7 +22,7 @@
 
 /**
  * provides an interface to all search providers
- * @deprecated see lib/search.php
+ * @deprecated use \OCP\ISearch / \OC\Search instead
  */
 class OC_Search {
 	/**
diff --git a/lib/private/user.php b/lib/private/user.php
index 5efe205ced..cdef4d8fe6 100644
--- a/lib/private/user.php
+++ b/lib/private/user.php
@@ -64,7 +64,7 @@ class OC_User {
 	/**
 	 * registers backend
 	 * @param string $backend name of the backend
-	 * @deprecated Add classes by calling useBackend with a class instance instead
+	 * @deprecated Add classes by calling OC_User::useBackend() with a class instance instead
 	 * @return bool
 	 *
 	 * Makes a list of backends that can be used by other modules
diff --git a/lib/public/template.php b/lib/public/template.php
index b1264e0c3a..2e265bb5e8 100644
--- a/lib/public/template.php
+++ b/lib/public/template.php
@@ -97,7 +97,7 @@ function relative_modified_date( $timestamp, $dateOnly = false ) {
 
 /**
  * Return a human readable outout for a file size.
- * @deprecated human_file_size() instead
+ * @deprecated use human_file_size() instead
  * @param integer $bytes size of a file in byte
  * @return string human readable interpretation of a file size
  */