Commit 9e37e38a authored by John Blackbourn's avatar John Blackbourn
Browse files

Docs: Various corrections to inline docblocks. 

See #49572
Built from https://develop.svn.wordpress.org/trunk@48573


git-svn-id: https://core.svn.wordpress.org/trunk@48335 1a063a9b-81f0-0310-95a4-ce76da25c4cd
parent 54aa1394

wp-admin/includes/taxonomy.php

+2 −2
Original line number Diff line number Diff line
@@ -300,8 +300,8 @@ function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) { 
 *

 * @since 2.8.0

 *

 * @param int|string $tag_name

 * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.

 * @param string $tag_name The term name.

 * @param string $taxonomy Optional. The taxonomy within which to create the term. Default 'post_tag'.

 * @return array|WP_Error

 */

function wp_create_term( $tag_name, $taxonomy = 'post_tag' ) {

wp-admin/includes/template.php

+1 −2
Original line number Diff line number Diff line
@@ -2221,12 +2221,11 @@ function get_post_states( $post ) { 
}



/**

 * Function to echo the attachment media states as HTML.

 * Outputs the attachment media states as HTML.

 *

 * @since 3.2.0

 *

 * @param WP_Post $post The attachment post to retrieve states for.

 * @return string Media states string.

 */

function _media_states( $post ) {

	static $header_images;

wp-includes/blocks.php

+4 −4
Original line number Diff line number Diff line
@@ -359,7 +359,7 @@ function get_dynamic_block_names() { 
 *

 * @since 5.3.1

 *

 * @param array $attributes Attributes object.

 * @param array $block_attributes Attributes object.

 * @return string Serialized attributes.

 */

function serialize_block_attributes( $block_attributes ) {
@@ -397,8 +397,8 @@ function strip_core_block_namespace( $block_name = null ) { 
 * @since 5.3.1

 *

 * @param string $block_name       Block name.

 * @param array  $attributes Block attributes.

 * @param string $content    Block save content.

 * @param array  $block_attributes Block attributes.

 * @param string $block_content    Block save content.

 * @return string Comment-delimited block content.

 */

function get_comment_delimited_block_content( $block_name = null, $block_attributes, $block_content ) {

wp-includes/class-wp-customize-manager.php

+1 −1
Original line number Diff line number Diff line
@@ -2292,7 +2292,7 @@ final class WP_Customize_Manager { 
	 *

	 * @since 3.4.0

	 *

	 * @param $current_theme {@internal Parameter is not used}

	 * @param mixed $current_theme {@internal Parameter is not used}

	 * @return string Theme name.

	 */

	public function current_theme( $current_theme ) {

wp-includes/class-wp-customize-setting.php

+8 −8
Original line number Diff line number Diff line
@@ -846,8 +846,8 @@ class WP_Customize_Setting { 
	 *

	 * @since 3.4.0

	 *

	 * @param $root

	 * @param $keys

	 * @param array $root

	 * @param array $keys

	 * @param bool $create Default false.

	 * @return array|void Keys are 'root', 'node', and 'key'.

	 */
@@ -901,8 +901,8 @@ class WP_Customize_Setting { 
	 *

	 * @since 3.4.0

	 *

	 * @param $root

	 * @param $keys

	 * @param array $root

	 * @param array $keys

	 * @param mixed $value The value to update.

	 * @return mixed

	 */
@@ -927,8 +927,8 @@ class WP_Customize_Setting { 
	 *

	 * @since 3.4.0

	 *

	 * @param $root

	 * @param $keys

	 * @param array $root

	 * @param array $keys

	 * @param mixed $default A default value which is used as a fallback. Default null.

	 * @return mixed The requested value or the default value.

	 */
@@ -946,8 +946,8 @@ class WP_Customize_Setting { 
	 *

	 * @since 3.4.0

	 *

	 * @param $root

	 * @param $keys

	 * @param array $root

	 * @param array $keys

	 * @return bool True if value is set, false if not.

	 */

	final protected function multidimensional_isset( $root, $keys ) {