Docs: Miscellaneous docblock corrections.

See #32246

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


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

wp-admin/includes/credits.php

@@ -48,7 +48,7 @@ function wp_credits() {
  * @access private
  * @since 3.2.0
  *
- * @param string &$display_name The contributor's display name, passed by reference.
+ * @param string $display_name  The contributor's display name, passed by reference.
  * @param string $username      The contributor's username.
  * @param string $profiles      URL to the contributor's WordPress.org profile page.
  */
@@ -62,7 +62,7 @@ function _wp_credits_add_profile_link( &$display_name, $username, $profiles ) {
  * @access private
  * @since 3.2.0
  *
- * @param string &$data External library data, passed by reference.
+ * @param string $data External library data, passed by reference.
  */
 function _wp_credits_build_object_link( &$data ) {
 	$data = '<a href="' . esc_url( $data[1] ) . '">' . esc_html( $data[0] ) . '</a>';

wp-includes/cache.php

@@ -112,7 +112,7 @@ function wp_cache_flush() {
  * @param string      $group  Optional. Where the cache contents are grouped. Default empty.
  * @param bool        $force  Optional. Whether to force an update of the local cache from the persistent
  *                            cache. Default false.
- * @param bool        &$found Optional. Whether the key was found in the cache. Disambiguates a return of false,
+ * @param bool        $found  Optional. Whether the key was found in the cache. Disambiguates a return of false,
  *                            a storable value. Passed by reference. Default null.
  * @return bool|mixed False on failure to retrieve contents or the cache
  *		              contents on success
@@ -534,7 +534,7 @@ class WP_Object_Cache {
 	 * @param string     $group  Optional. Where the cache contents are grouped. Default 'default'.
 	 * @param string     $force  Optional. Unused. Whether to force a refetch rather than relying on the local
 	 *                           cache. Default false.
-	 * @param bool       &$found Optional. Whether the key was found in the cache. Disambiguates a return of
+	 * @param bool       $found  Optional. Whether the key was found in the cache. Disambiguates a return of
 	 *                           false, a storable value. Passed by reference. Default null.
 	 * @return false|mixed False on failure to retrieve contents or the cache contents on success.
 	 */

wp-includes/class-walker-page.php

@@ -77,8 +77,8 @@ class Walker_Page extends Walker {
 	 * @param string $output       Passed by reference. Used to append additional content.
 	 * @param object $page         Page data object.
 	 * @param int    $depth        Depth of page. Used for padding.
+	 * @param array  $args         Optional arguments.
 	 * @param int    $current_page Page ID.
-	 * @param array  $args
 	 */
 	public function start_el( &$output, $page, $depth = 0, $args = array(), $current_page = 0 ) {
 		if ( $depth ) {

wp-includes/class-wp-http-curl.php

@@ -326,7 +326,7 @@ class WP_Http_Curl {
 	 * @access private
 	 *
 	 * @param resource $handle  cURL handle.
-	 * @param string   $headers cURL request headers.
+	 * @param string   $data    cURL request body.
 	 * @return int Total bytes of data written.
 	 */
 	private function stream_body( $handle, $data ) {

wp-includes/ms-functions.php

@@ -2154,7 +2154,7 @@ function force_ssl_content( $force = '' ) {
  *
  * @since 2.8.5
  *
- * @param string URL
+ * @param string $url URL
  * @return string URL with https as the scheme
  */
 function filter_SSL( $url ) {

wp-includes/post.php

@@ -4268,8 +4268,8 @@ function get_page_hierarchy( &$pages, $page_id = 0 ) {
  * @see _page_traverse_name()
  *
  * @param int   $page_id   Page ID.
- * @param array &$children Parent-children relations, passed by reference.
- * @param array &$result   Result, passed by reference.
+ * @param array $children  Parent-children relations, passed by reference.
+ * @param array $result    Result, passed by reference.
  */
 function _page_traverse_name( $page_id, &$children, &$result ){
 	if ( isset( $children[ $page_id ] ) ){

wp-includes/version.php

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