File-level phpdoc for multisite files.

git-svn-id: http://svn.automattic.com/wordpress/trunk@13998 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/includes/ms-deprecated.php

@@ -1,59 +1,67 @@
 <?php
-
 /**
- * Deprecated multisite admin functions from past WordPress versions. You shouldn't use these
+ * Deprecated multisite admin functions from past WordPress versions and WordPress MU.
- * globals and functions and look for the alternatives instead. The functions
+ * You shouldn't use these functions and look for the alternatives instead. The functions
- * and globals will be removed in a later version.
+ * will be removed in a later version.
  *
  * @package WordPress
  * @subpackage Deprecated
+ * @since 3.0.0
  */
 
 /**
- * @deprecated 3.0
+ * @deprecated 3.0.0
  */
 function wpmu_menu() {
-	_deprecated_function(__FUNCTION__, '3.0', '' );
+	_deprecated_function(__FUNCTION__, '3.0' );
 	// deprecated. See #11763
 }
 
 /**
-  * Determines if the available space defined by the admin has been exceeded by the user. Dies if it has.
+  * Determines if the available space defined by the admin has been exceeded by the user.
-  * @deprecated 3.0
+  *
+  * @deprecated 3.0.0
+  * @see is_upload_space_available()
  */
 function wpmu_checkAvailableSpace() {
-	_deprecated_function(__FUNCTION__, '3.0', 'is_upload_space_available' );
+	_deprecated_function(__FUNCTION__, '3.0', 'is_upload_space_available()' );
 
 	if ( !is_upload_space_available() )
 		wp_die( __('Sorry, you must delete files before you can upload any more.') );
 }
 
 /**
- * @deprecated 3.0
+ * @deprecated 3.0.0
  */
 function mu_options( $options ) {
-	_deprecated_function(__FUNCTION__, '3.0', '' );
+	_deprecated_function(__FUNCTION__, '3.0' );
 	return $options;
 }
 
 /**
- * @deprecated 3.0
+ * @deprecated 3.0.0
+ * @see activate_plugin()
  */
 function activate_sitewide_plugin() {
+	_deprecated_function(__FUNCTION__, '3.0', 'activate_plugin()' );
 	return false;
 }
 
 /**
- * @deprecated 3.0
+ * @deprecated 3.0.0
+ * @see deactivate_sitewide_plugin()
  */
 function deactivate_sitewide_plugin( $plugin = false ) {
+	_deprecated_function(__FUNCTION__, '3.0', 'deactivate_plugin()' );
 	return;
 }
 
 /**
- * @deprecated 3.0 is_network_only_plugin()
+ * @deprecated 3.0.0
+ * @see is_network_only_plugin()
  */
 function is_wpmu_sitewide_plugin( $file ) {
+	_deprecated_function(__FUNCTION__, '3.0', 'is_network_only_plugin()' );
 	return is_network_only_plugin( $file );
 }
 

wp-admin/includes/ms.php

@@ -1,4 +1,11 @@
 <?php
+/**
+ * Multisite administration functions.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
 
 /**
  * Determine if uploaded file exceeds space quota.

wp-admin/ms-admin.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite administration panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( !is_multisite() )

wp-admin/ms-delete-site.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite delete site panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( !is_multisite() )

wp-admin/ms-edit.php

@@ -1,9 +1,20 @@
 <?php
+/**
+ * Action handler for Multisite administration panels.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( !is_multisite() )
 	wp_die( __( 'Multisite support is not enabled.' ) );
 
+if ( empty( $_GET['action'] ) )
+	wp_redirect( admin_url( 'ms-admin.php' ) );
+
 do_action( 'wpmuadminedit' , '');
 
 if ( isset( $_GET['id' ]) )

wp-admin/ms-options.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite network settings administration panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( ! is_multisite() )

wp-admin/ms-sites.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite sites administration panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( !is_multisite() )

wp-admin/ms-themes.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite themes administration panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( ! current_user_can( 'manage_network_themes' ) )

wp-admin/ms-upgrade-network.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite upgrade administration panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once('admin.php');
 
 if ( !is_multisite() )

wp-admin/ms-users.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Multisite users administration panel.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( !is_multisite() )

wp-admin/my-sites.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * My Sites dashboard.
+ *
+ * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
+ */
+
 require_once( './admin.php' );
 
 if ( !is_multisite() )

wp-includes/ms-default-constants.php

@@ -4,6 +4,7 @@
  *
  * @package WordPress
  * @subpackage Multisite
+ * @since 3.0.0
  */
 
 /**

wp-includes/ms-default-filters.php

@@ -10,6 +10,7 @@
  * @package WordPress
  * @subpackage Multisite
  * @see default-filters.php
+ * @since 3.0.0
  */
 
 // Users

wp-includes/ms-deprecated.php

@@ -6,6 +6,7 @@
  *
  * @package WordPress
  * @subpackage Deprecated
+ * @since 3.0.0
  */
 
 /*

wp-includes/ms-functions.php

@@ -3,6 +3,8 @@
  * Multi-site WordPress API
  *
  * @package WordPress
+ * @subpackage Multisite
+ * @since 3.0.0
  */
 
 function get_sitestats() {

wp-includes/ms-settings.php

@@ -7,6 +7,7 @@
  *
  * @package WordPress
  * @subpackage Multisite
+ * @since 3.0.0
  */
 
 // $base sanity check.