Docs: Make a few syntactical improvements to the DocBlock for `_wp_get_current_user()`, introduced in [36651].

Includes a cross reference from the DocBlock for `wp_get_current_user()`, which itself is pluggable, but the new internal function is not.

See #19615. See #32246.

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


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

wp-includes/pluggable.php

@@ -60,6 +60,7 @@ if ( !function_exists('wp_get_current_user') ) :
  *
  * @since 2.0.3
  *
+ * @see _wp_get_current_user()
  * @global WP_User $current_user Checks if the current user is set.
  *
  * @return WP_User Current WP_User instance.

wp-includes/user.php

@@ -2408,19 +2408,19 @@ function wp_get_users_with_no_role() {
 }
 
 /**
- * Retrieve the current user object.
+ * Retrieves the current user object.
  *
  * Will set the current user, if the current user is not set. The current user
  * will be set to the logged-in person. If no user is logged-in, then it will
  * set the current user to 0, which is invalid and won't have any permissions.
  *
- * This function is used by the pluggable functions {@see wp_get_current_user()}
+ * This function is used by the pluggable functions wp_get_current_user() and
- * and {@see get_currentuserinfo()}, which is deprecated, for backward compatibility.
+ * get_currentuserinfo(), which is deprecated, for backward compatibility.
  *
  * @since 4.5.0
  * @access private
  *
- * @see https://core.trac.wordpress.org/ticket/19615
+ * @see wp_get_current_user()
  * @global WP_User $current_user Checks if the current user is set.
  *
  * @return WP_User Current WP_User instance.

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.5-beta1-36704';
+$wp_version = '4.5-beta1-36705';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.