WordPress 4.7.1-scripts

[autoinstalls/wordpress.git] / wp-admin / includes / ms-deprecated.php

diff --git a/wp-admin/includes/ms-deprecated.php b/wp-admin/includes/ms-deprecated.php
index 5038ad376f3f05e330e39f4c6c3f7d14b569534a..81546bd1470a22a4285c5cc9141dfed2a3c6661b 100644 (file)
--- a/wp-admin/includes/ms-deprecated.php
+++ b/wp-admin/includes/ms-deprecated.php
@@ -1,8 +1,9 @@
 <?php
 /**
- * Deprecated multisite admin functions from past WordPress versions and WordPress MU.
- * You shouldn't use these functions and look for the alternatives instead. The functions
- * will be removed in a later version.
+ * Multisite: Deprecated admin functions from past versions and WordPress MU
+ *
+ * These functions should not be used and will be removed in a later version.
+ * It is suggested to use for the alternatives instead when available.
  *
  * @package WordPress
  * @subpackage Deprecated
@@ -10,79 +11,95 @@
  */
 
 /**
+ * Outputs the WPMU menu.
+ *
  * @deprecated 3.0.0
  */
 function wpmu_menu() {
-       _deprecated_function(__FUNCTION__, '3.0' );
+       _deprecated_function(__FUNCTION__, '3.0.0' );
        // Deprecated. See #11763.
 }
 
 /**
-  * Determines if the available space defined by the admin has been exceeded by the user.
-  *
-  * @deprecated 3.0.0
-  * @see is_upload_space_available()
+ * Determines if the available space defined by the admin has been exceeded by the user.
+ *
+ * @deprecated 3.0.0 Use is_upload_space_available()
+ * @see is_upload_space_available()
  */
 function wpmu_checkAvailableSpace() {
-       _deprecated_function(__FUNCTION__, '3.0', 'is_upload_space_available()' );
+       _deprecated_function(__FUNCTION__, '3.0.0', 'is_upload_space_available()' );
 
        if ( !is_upload_space_available() )
                wp_die( __('Sorry, you must delete files before you can upload any more.') );
 }
 
 /**
+ * WPMU options.
+ *
  * @deprecated 3.0.0
  */
 function mu_options( $options ) {
-       _deprecated_function(__FUNCTION__, '3.0' );
+       _deprecated_function(__FUNCTION__, '3.0.0' );
        return $options;
 }
 
 /**
- * @deprecated 3.0.0
+ * Deprecated functionality for activating a network-only plugin.
+ *
+ * @deprecated 3.0.0 Use activate_plugin()
  * @see activate_plugin()
  */
 function activate_sitewide_plugin() {
-       _deprecated_function(__FUNCTION__, '3.0', 'activate_plugin()' );
+       _deprecated_function(__FUNCTION__, '3.0.0', 'activate_plugin()' );
        return false;
 }
 
 /**
- * @deprecated 3.0.0
+ * Deprecated functionality for deactivating a network-only plugin.
+ *
+ * @deprecated 3.0.0 Use deactivate_sitewide_plugin()
  * @see deactivate_sitewide_plugin()
  */
 function deactivate_sitewide_plugin( $plugin = false ) {
-       _deprecated_function(__FUNCTION__, '3.0', 'deactivate_plugin()' );
+       _deprecated_function(__FUNCTION__, '3.0.0', 'deactivate_plugin()' );
 }
 
 /**
- * @deprecated 3.0.0
+ * Deprecated functionality for determining if the current plugin is network-only.
+ *
+ * @deprecated 3.0.0 Use is_network_only_plugin()
  * @see is_network_only_plugin()
  */
 function is_wpmu_sitewide_plugin( $file ) {
-       _deprecated_function(__FUNCTION__, '3.0', 'is_network_only_plugin()' );
+       _deprecated_function(__FUNCTION__, '3.0.0', 'is_network_only_plugin()' );
        return is_network_only_plugin( $file );
 }
 
 /**
- * @deprecated 3.4.0
+ * Deprecated functionality for getting themes network-enabled themes.
+ *
+ * @deprecated 3.4.0 Use WP_Theme::get_allowed_on_network()
  * @see WP_Theme::get_allowed_on_network()
  */
 function get_site_allowed_themes() {
-       _deprecated_function( __FUNCTION__, '3.4', 'WP_Theme::get_allowed_on_network()' );
+       _deprecated_function( __FUNCTION__, '3.4.0', 'WP_Theme::get_allowed_on_network()' );
        return array_map( 'intval', WP_Theme::get_allowed_on_network() );
 }
 
 /**
- * @deprecated 3.4.0
+ * Deprecated functionality for getting themes allowed on a specific site.
+ *
+ * @deprecated 3.4.0 Use WP_Theme::get_allowed_on_site()
  * @see WP_Theme::get_allowed_on_site()
  */
 function wpmu_get_blog_allowedthemes( $blog_id = 0 ) {
-       _deprecated_function( __FUNCTION__, '3.4', 'WP_Theme::get_allowed_on_site()' );
+       _deprecated_function( __FUNCTION__, '3.4.0', 'WP_Theme::get_allowed_on_site()' );
        return array_map( 'intval', WP_Theme::get_allowed_on_site( $blog_id ) );
 }
 
 /**
- * @deprecated
+ * Deprecated functionality for determining whether a file is deprecated.
+ *
+ * @deprecated 3.5.0
  */
-function ms_deprecated_blogs_file() {}
\ No newline at end of file
+function ms_deprecated_blogs_file() {}