Docs: Remove @return void from widget DocBlocks.

Per the documentation standards, it should not be used outside of the default bundled themes.

See #48303.
Built from https://develop.svn.wordpress.org/trunk@47055


git-svn-id: http://core.svn.wordpress.org/trunk@46855 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2020-01-10 00:30:05 +00:00
parent d784ebbcb4
commit a94ed9baf3
8 changed files with 10 additions and 8 deletions

View File

@ -13,7 +13,7 @@
*
* @global string $wp_version
*/
$wp_version = '5.4-alpha-47054';
$wp_version = '5.4-alpha-47055';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.

View File

@ -238,6 +238,7 @@ class WP_Widget_Custom_HTML extends WP_Widget {
* @since 4.9.0 The form contains only hidden sync inputs. For the control UI, see `WP_Widget_Custom_HTML::render_control_template_scripts()`.
*
* @see WP_Widget_Custom_HTML::render_control_template_scripts()
*
* @param array $instance Current instance.
*/
public function form( $instance ) {

View File

@ -60,6 +60,7 @@ class WP_Widget_Media_Audio extends WP_Widget_Media {
* @see WP_REST_Controller::get_item_schema()
* @see WP_REST_Controller::get_additional_fields()
* @link https://core.trac.wordpress.org/ticket/35574
*
* @return array Schema for properties.
*/
public function get_instance_schema() {
@ -96,7 +97,6 @@ class WP_Widget_Media_Audio extends WP_Widget_Media {
* @since 4.8.0
*
* @param array $instance Widget instance props.
* @return void
*/
public function render_media( $instance ) {
$instance = array_merge( wp_list_pluck( $this->get_instance_schema(), 'default' ), $instance );

View File

@ -51,6 +51,7 @@ class WP_Widget_Media_Gallery extends WP_Widget_Media {
* @see WP_REST_Controller::get_item_schema()
* @see WP_REST_Controller::get_additional_fields()
* @link https://core.trac.wordpress.org/ticket/35574
*
* @return array Schema for properties.
*/
public function get_instance_schema() {
@ -108,7 +109,6 @@ class WP_Widget_Media_Gallery extends WP_Widget_Media {
* @since 4.9.0
*
* @param array $instance Widget instance props.
* @return void
*/
public function render_media( $instance ) {
$instance = array_merge( wp_list_pluck( $this->get_instance_schema(), 'default' ), $instance );

View File

@ -59,6 +59,7 @@ class WP_Widget_Media_Image extends WP_Widget_Media {
* @see WP_REST_Controller::get_item_schema()
* @see WP_REST_Controller::get_additional_fields()
* @link https://core.trac.wordpress.org/ticket/35574
*
* @return array Schema for properties.
*/
public function get_instance_schema() {
@ -172,7 +173,6 @@ class WP_Widget_Media_Image extends WP_Widget_Media {
* @since 4.8.0
*
* @param array $instance Widget instance props.
* @return void
*/
public function render_media( $instance ) {
$instance = array_merge( wp_list_pluck( $this->get_instance_schema(), 'default' ), $instance );

View File

@ -61,6 +61,7 @@ class WP_Widget_Media_Video extends WP_Widget_Media {
* @see WP_REST_Controller::get_item_schema()
* @see WP_REST_Controller::get_additional_fields()
* @link https://core.trac.wordpress.org/ticket/35574
*
* @return array Schema for properties.
*/
public function get_instance_schema() {
@ -107,8 +108,6 @@ class WP_Widget_Media_Video extends WP_Widget_Media {
* @since 4.8.0
*
* @param array $instance Widget instance props.
*
* @return void
*/
public function render_media( $instance ) {
$instance = array_merge( wp_list_pluck( $this->get_instance_schema(), 'default' ), $instance );

View File

@ -127,6 +127,7 @@ abstract class WP_Widget_Media extends WP_Widget {
* @see WP_REST_Controller::get_item_schema()
* @see WP_REST_Controller::get_additional_fields()
* @link https://core.trac.wordpress.org/ticket/35574
*
* @return array Schema for properties.
*/
public function get_instance_schema() {
@ -320,8 +321,8 @@ abstract class WP_Widget_Media extends WP_Widget {
* @since 4.8.0
*
* @see \WP_Widget_Media::render_control_template_scripts() Where the JS template is located.
*
* @param array $instance Current settings.
* @return void
*/
final public function form( $instance ) {
$instance_schema = $this->get_instance_schema();

View File

@ -344,6 +344,7 @@ class WP_Widget_Text extends WP_Widget {
* @since 4.9.0
*
* @see WP_Widget_Media_Video::inject_video_max_width_style()
*
* @param array $matches Pattern matches from preg_replace_callback.
* @return string HTML Output.
*/
@ -441,11 +442,11 @@ class WP_Widget_Text extends WP_Widget {
* @since 2.8.0
* @since 4.8.0 Form only contains hidden inputs which are synced with JS template.
* @since 4.8.1 Restored original form to be displayed when in legacy mode.
*
* @see WP_Widget_Text::render_control_template_scripts()
* @see _WP_Editors::editor()
*
* @param array $instance Current settings.
* @return void
*/
public function form( $instance ) {
$instance = wp_parse_args(