diff --git a/lib/private/legacy/appconfig.php b/lib/private/legacy/appconfig.php
index 4634f2c695..68f63974e8 100644
--- a/lib/private/legacy/appconfig.php
+++ b/lib/private/legacy/appconfig.php
@@ -24,6 +24,8 @@
 /**
  * This class provides an easy way for apps to store config values in the
  * database.
+ *
+ * @deprecated use \OC::$server->getAppConfig() to get an \OCP\IAppConfig instance
  */
 class OC_Appconfig {
 	/**
diff --git a/lib/private/legacy/config.php b/lib/private/legacy/config.php
index 899c19532f..4d6fefc4e1 100644
--- a/lib/private/legacy/config.php
+++ b/lib/private/legacy/config.php
@@ -37,6 +37,8 @@
 /**
  * This class is responsible for reading and writing config.php, the very basic
  * configuration file of ownCloud.
+ *
+ * @deprecated use \OC::$server->getConfig() to get an \OCP\Config instance
  */
 class OC_Config {
 
diff --git a/lib/private/legacy/log.php b/lib/private/legacy/log.php
index 027cb89e97..99c9254e90 100644
--- a/lib/private/legacy/log.php
+++ b/lib/private/legacy/log.php
@@ -14,6 +14,9 @@
  */
 
 OC_Log::$object = new \OC\Log();
+/**
+ * @deprecated use \OC::$server->getLogger() to get an \OCP\ILogger instance
+ */
 class OC_Log {
 	public static $object;
 
diff --git a/lib/private/legacy/preferences.php b/lib/private/legacy/preferences.php
index 060274085f..4b68b0e69a 100644
--- a/lib/private/legacy/preferences.php
+++ b/lib/private/legacy/preferences.php
@@ -21,10 +21,11 @@
  *
  */
 
+OC_Preferences::$object = new \OC\Preferences(OC_DB::getConnection());
 /**
  * This class provides an easy way for storing user preferences.
+ * @deprecated use \OC\Preferences instead
  */
-OC_Preferences::$object = new \OC\Preferences(OC_DB::getConnection());
 class OC_Preferences{
 	public static $object;
 	/**
diff --git a/lib/private/legacy/search.php b/lib/private/legacy/search.php
index 8c348c9586..19aba2a8b8 100644
--- a/lib/private/legacy/search.php
+++ b/lib/private/legacy/search.php
@@ -22,6 +22,7 @@
 
 /**
  * provides an interface to all search providers
+ *
  * @deprecated use \OCP\ISearch / \OC\Search instead
  */
 class OC_Search {
diff --git a/lib/private/legacy/search/provider.php b/lib/private/legacy/search/provider.php
index b296aeb23d..b183caf551 100644
--- a/lib/private/legacy/search/provider.php
+++ b/lib/private/legacy/search/provider.php
@@ -19,6 +19,7 @@
 
 /**
  * Class OC_Search_Provider
+ *
  * @deprecated use \OCP\Search\Provider instead
  */
 abstract class OC_Search_Provider extends \OCP\Search\Provider {
diff --git a/lib/private/legacy/search/provider/file.php b/lib/private/legacy/search/provider/file.php
index e610281131..079ce85bf5 100644
--- a/lib/private/legacy/search/provider/file.php
+++ b/lib/private/legacy/search/provider/file.php
@@ -17,6 +17,9 @@
  *
  */
 
+/**
+ * @deprecated use \OC\Search\Provider\File instead
+ */
 class OC_Search_Provider_File extends \OC\Search\Provider\File {
 
 }
diff --git a/lib/private/legacy/search/result.php b/lib/private/legacy/search/result.php
index f3e6ecbb99..d5aa3391dc 100644
--- a/lib/private/legacy/search/result.php
+++ b/lib/private/legacy/search/result.php
@@ -17,8 +17,10 @@
  *
  */
 
+/**
+ * @deprecated use \OCP\Search\Result instead
+ */
 class OC_Search_Result extends \OCP\Search\Result {
-    
 	/**
 	 * Create a new search result
 	 * @param string $id unique identifier from application: '[app_name]/[item_identifier_in_app]'
diff --git a/lib/private/legacy/updater.php b/lib/private/legacy/updater.php
index eea7bb129c..190748066c 100644
--- a/lib/private/legacy/updater.php
+++ b/lib/private/legacy/updater.php
@@ -6,6 +6,11 @@
  * See the COPYING-README file.
  */
 
+/**
+ * provides an interface to all search providers
+ *
+ * @deprecated use \OC\Updater instead
+ */
 class OC_Updater {
 	public static function check() {
 		$updater = new \OC\Updater();