diff --git a/lib/private/legacy/appconfig.php b/lib/private/legacy/appconfig.php
index 4634f2c695d723b2c8ff528e08f716cc8129251d..68f63974e85d2c6fd0d458d34bc98b7a51136c69 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 899c19532f028f5177be4cfda751d8f66baed75d..4d6fefc4e175b796eeab1eb9f2357c3f17490e71 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 027cb89e97cbe99fd8a53902c88c0fddac21c5dd..99c9254e90f092d64aa426246e064a798136f3e1 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 060274085feb67179649aff9929774fc53df9684..4b68b0e69aa453021bc4ec4169f2fd47bb44c381 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 8c348c9586970258c6b2c0d4038d79c876b31a55..19aba2a8b8c7a2c4f1a91cf6d8f136da1c1b17be 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 b296aeb23d8e0b94d6c559114ef9929bef64a894..b183caf5511070de8af3595c7dac525b1f870153 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 e610281131d3a54ddac17d852082dd6159f92741..079ce85bf54b2050cbdba3a3d13eae30f158ae1f 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 f3e6ecbb99081750c9170277df749fad71ccaa98..d5aa3391dc8b4aa1ffd1dca518328eb7aeab0740 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 eea7bb129cfba66bff7c88bb394ced024ce1a2b9..190748066c6f6aa6ea408eeec394b7936b4b0bb4 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();