Inline documentation for hooks in wp-admin/user/admin.php.

Props leewillis77 for the initial patch. Props kpdesign.
Fixes #25825.

Built from https://develop.svn.wordpress.org/trunk@26344


git-svn-id: http://core.svn.wordpress.org/trunk@26245 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/user/admin.php

@@ -17,6 +17,16 @@ if ( ! is_multisite() ) {
 }
 
 $redirect_user_admin_request = ( ( $current_blog->domain != $current_site->domain ) || ( $current_blog->path != $current_site->path ) );
+/**
+ * Filter whether a user should be redirected to the Global Dashboard in Multisite.
+ *
+ * Users not assigned to any sites in the network will be redirected to the Global
+ * Dashboard after logging in.
+ *
+ * @since 3.2.0
+ *
+ * @param bool $redirect_user_admin_request Whether the request should be redirected.
+ */
 $redirect_user_admin_request = apply_filters( 'redirect_user_admin_request', $redirect_user_admin_request );
 if ( $redirect_user_admin_request ) {
 	wp_redirect( user_admin_url() );