X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/9e77185fafaf4e60e2b73821e0e4b9b1a11fb85f..3194d1bb103c2d8db4f44feeced5e58ee2756658:/wp-admin/includes/ms-deprecated.php

diff --git a/wp-admin/includes/ms-deprecated.php b/wp-admin/includes/ms-deprecated.php
index 44e2a82b..84dcefc9 100644
--- 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,6 +11,8 @@
  */
 
 /**
+ * Outputs the WPMU menu.
+ *
  * @deprecated 3.0.0
  */
 function wpmu_menu() {
@@ -18,10 +21,10 @@ function wpmu_menu() {
 }
 
 /**
-  * 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()' );
@@ -31,6 +34,8 @@ function wpmu_checkAvailableSpace() {
 }
 
 /**
+ * WPMU options.
+ *
  * @deprecated 3.0.0
  */
 function mu_options( $options ) {
@@ -39,7 +44,9 @@ function mu_options( $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() {
@@ -48,16 +55,19 @@ function activate_sitewide_plugin() {
 }
 
 /**
- * @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()' );
-	return;
 }
 
 /**
- * @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 ) {
@@ -65,14 +75,31 @@ function is_wpmu_sitewide_plugin( $file ) {
 	return is_network_only_plugin( $file );
 }
 
+/**
+ * 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()' );
 	return array_map( 'intval', WP_Theme::get_allowed_on_network() );
 }
 
+/**
+ * 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()' );
 	return array_map( 'intval', WP_Theme::get_allowed_on_site( $blog_id ) );
 }
 
-function ms_deprecated_blogs_file() {}
\ No newline at end of file
+/**
+ * Deprecated functionality for determining whether a file is deprecated.
+ *
+ * @deprecated 3.5.0
+ */
+function ms_deprecated_blogs_file() {}