diff --git a/lib/base.php b/lib/base.php
index 99c2764d22c8db9841ce5d810a4d4101c0533d8d..ab1d8e982310652f8d349dfdd3b17d49b25894aa 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 f77b43be2e00f413fb8530f0fd79a94cad27e2e5..8c348c9586970258c6b2c0d4038d79c876b31a55 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 5efe205ced9d66e8c0a3592f1d072bbb47da4b69..cdef4d8fe652d0c5da1f12200db389d61d648561 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 b1264e0c3ad2c90e71f4c9332eebcc2b06b8acca..2e265bb5e8e0ef103062248f7a9c9ddccddaf6bb 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
  */