WordPress-C
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Docs: Adjust some deprecated function DocBlocks per the [https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#1-2-deprecated-functions documentation standards]. 

This ensures the replacement functions are linked correctly in the WordPress Code Reference.

Follow-up to [38515], [43548], [49992], [51348], [51586], [52757], [53082].

See #54729.
Built from https://develop.svn.wordpress.org/trunk@53086


git-svn-id: http://core.svn.wordpress.org/trunk@52675 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2022-04-06 15:20:06 +00:00
parent e0ce8e7a6b
commit a5f05b68a3
5 changed files with 28 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
wp-includes/deprecated.php
View File

@ -4182,6 +4182,8 @@ function wp_no_robots() {
* @since 5.0.1 * @since 5.0.1
* @deprecated 5.7.0 Use wp_robots_sensitive_page() instead on 'wp_robots' filter * @deprecated 5.7.0 Use wp_robots_sensitive_page() instead on 'wp_robots' filter
* and wp_strict_cross_origin_referrer() on 'wp_head' action. * and wp_strict_cross_origin_referrer() on 'wp_head' action.
*
* @see wp_robots_sensitive_page()
*/ */
function wp_sensitive_page_meta() { function wp_sensitive_page_meta() {
_deprecated_function( __FUNCTION__, '5.7.0', 'wp_robots_sensitive_page()' ); _deprecated_function( __FUNCTION__, '5.7.0', 'wp_robots_sensitive_page()' );
@ -4196,9 +4198,10 @@ function wp_sensitive_page_meta() {
* Render inner blocks from the `core/columns` block for generating an excerpt. * Render inner blocks from the `core/columns` block for generating an excerpt.
* *
* @since 5.2.0 * @since 5.2.0
* @deprecated 5.8.0
*
* @access private * @access private
* @deprecated 5.8.0 Use _excerpt_render_inner_blocks() introduced in 5.8.0.
*
* @see _excerpt_render_inner_blocks()
* *
* @param array $columns The parsed columns block. * @param array $columns The parsed columns block.
* @param array $allowed_blocks The list of allowed inner blocks. * @param array $allowed_blocks The list of allowed inner blocks.
@ -4206,6 +4209,7 @@ function wp_sensitive_page_meta() {
*/ */
function _excerpt_render_inner_columns_blocks( $columns, $allowed_blocks ) { function _excerpt_render_inner_columns_blocks( $columns, $allowed_blocks ) {
_deprecated_function( __FUNCTION__, '5.8.0', '_excerpt_render_inner_blocks()' ); _deprecated_function( __FUNCTION__, '5.8.0', '_excerpt_render_inner_blocks()' );
return _excerpt_render_inner_blocks( $columns, $allowed_blocks ); return _excerpt_render_inner_blocks( $columns, $allowed_blocks );
} }
@ -4214,7 +4218,7 @@ function _excerpt_render_inner_columns_blocks( $columns, $allowed_blocks ) {
* reference the rendered SVG. * reference the rendered SVG.
* *
* @since 5.9.0 * @since 5.9.0
* @deprecated 5.9.1 Use `wp_get_duotone_filter_property` introduced in 5.9.1. * @deprecated 5.9.1 Use wp_get_duotone_filter_property() introduced in 5.9.1.
* *
* @see wp_get_duotone_filter_property() * @see wp_get_duotone_filter_property()
* *
@ -4223,16 +4227,18 @@ function _excerpt_render_inner_columns_blocks( $columns, $allowed_blocks ) {
*/ */
function wp_render_duotone_filter_preset( $preset ) { function wp_render_duotone_filter_preset( $preset ) {
_deprecated_function( __FUNCTION__, '5.9.1', 'wp_get_duotone_filter_property()' ); _deprecated_function( __FUNCTION__, '5.9.1', 'wp_get_duotone_filter_property()' );
return wp_get_duotone_filter_property( $preset ); return wp_get_duotone_filter_property( $preset );
} }
/** /**
* Checks whether serialization of the current block's border properties should * Checks whether serialization of the current block's border properties should occur.
* occur.
* *
* @since 5.8.0 * @since 5.8.0
* @access private * @access private
* @deprecated 6.0.0 Use `wp_should_skip_block_supports_serialization` introduced in 6.0.0. * @deprecated 6.0.0 Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
*
* @see wp_should_skip_block_supports_serialization()
* *
* @param WP_Block_Type $block_type Block type. * @param WP_Block_Type $block_type Block type.
* @return bool Whether serialization of the current block's border properties * @return bool Whether serialization of the current block's border properties
@ -4240,6 +4246,7 @@ function wp_render_duotone_filter_preset( $preset ) {
*/ */
function wp_skip_border_serialization( $block_type ) { function wp_skip_border_serialization( $block_type ) {
_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' ); _deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
$border_support = _wp_array_get( $block_type->supports, array( '__experimentalBorder' ), false ); $border_support = _wp_array_get( $block_type->supports, array( '__experimentalBorder' ), false );
return is_array( $border_support ) && return is_array( $border_support ) &&
@ -4248,37 +4255,42 @@ function wp_skip_border_serialization( $block_type ) {
} }
/** /**
* Checks whether serialization of the current block's dimensions properties * Checks whether serialization of the current block's dimensions properties should occur.
* should occur.
* *
* @since 5.9.0 * @since 5.9.0
* @access private * @access private
* @deprecated 6.0.0 Use `wp_should_skip_block_supports_serialization` introduced in 6.0.0. * @deprecated 6.0.0 Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
*
* @see wp_should_skip_block_supports_serialization()
* *
* @param WP_Block_type $block_type Block type. * @param WP_Block_type $block_type Block type.
* @return bool Whether to serialize spacing support styles & classes. * @return bool Whether to serialize spacing support styles & classes.
*/ */
function wp_skip_dimensions_serialization( $block_type ) { function wp_skip_dimensions_serialization( $block_type ) {
_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' ); _deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
$dimensions_support = _wp_array_get( $block_type->supports, array( '__experimentalDimensions' ), false ); $dimensions_support = _wp_array_get( $block_type->supports, array( '__experimentalDimensions' ), false );
return is_array( $dimensions_support ) && return is_array( $dimensions_support ) &&
array_key_exists( '__experimentalSkipSerialization', $dimensions_support ) && array_key_exists( '__experimentalSkipSerialization', $dimensions_support ) &&
$dimensions_support['__experimentalSkipSerialization']; $dimensions_support['__experimentalSkipSerialization'];
} }
/** /**
* Checks whether serialization of the current block's spacing properties should * Checks whether serialization of the current block's spacing properties should occur.
* occur.
* *
* @since 5.9.0 * @since 5.9.0
* @access private * @access private
* @deprecated 6.0.0 Use `wp_should_skip_block_supports_serialization` introduced in 6.0.0. * @deprecated 6.0.0 Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
*
* @see wp_should_skip_block_supports_serialization()
* *
* @param WP_Block_Type $block_type Block type. * @param WP_Block_Type $block_type Block type.
* @return bool Whether to serialize spacing support styles & classes. * @return bool Whether to serialize spacing support styles & classes.
*/ */
function wp_skip_spacing_serialization( $block_type ) { function wp_skip_spacing_serialization( $block_type ) {
_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' ); _deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
$spacing_support = _wp_array_get( $block_type->supports, array( 'spacing' ), false ); $spacing_support = _wp_array_get( $block_type->supports, array( 'spacing' ), false );
return is_array( $spacing_support ) && return is_array( $spacing_support ) &&

2
wp-includes/ms-deprecated.php
View File

@ -559,7 +559,7 @@ function is_user_option_local( $key, $user_id = 0, $blog_id = 0 ) {
* the new blog's ID. It is the first step in creating a new blog. * the new blog's ID. It is the first step in creating a new blog.
* *
* @since MU (3.0.0) * @since MU (3.0.0)
* @deprecated 5.1.0 Use `wp_insert_site()` * @deprecated 5.1.0 Use wp_insert_site()
* @see wp_insert_site() * @see wp_insert_site()
* *
* @param string $domain The domain of the new site. * @param string $domain The domain of the new site.

2
wp-includes/ms-load.php
View File

@ -549,7 +549,7 @@ function wpmu_current_site() {
* Retrieve an object containing information about the requested network. * Retrieve an object containing information about the requested network.
* *
* @since 3.9.0 * @since 3.9.0
* @deprecated 4.7.0 Use `get_network()` * @deprecated 4.7.0 Use get_network()
* @see get_network() * @see get_network()
* *
* @internal In 4.6.0, converted to use get_network() * @internal In 4.6.0, converted to use get_network()

2
wp-includes/php-compat/readonly.php
View File

@ -20,7 +20,7 @@
* This function is deprecated, and cannot be used on PHP >= 8.1. * This function is deprecated, and cannot be used on PHP >= 8.1.
* *
* @since 4.9.0 * @since 4.9.0
* @deprecated 5.9.0 Use `wp_readonly` introduced in 5.9.0. * @deprecated 5.9.0 Use wp_readonly() introduced in 5.9.0.
* *
* @see wp_readonly() * @see wp_readonly()
* *

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.0-alpha-53085'; $wp_version = '6.0-alpha-53086';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.