Changeset 55725

Timestamp:

05/06/2023 11:38:17 AM (3 years ago)

Author:

SergeyBiryukov

Message:

Docs: Remove @return void from various DocBlocks.

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

Follow-up to [52049], [52051], [53331], [54156], [54214], [55203], [55719].

See #57840.

Location:

trunk/src/wp-includes

Files:

• class-wp-theme-json-schema.php (modified) (1 diff)
• html-api/class-wp-html-tag-processor.php (modified) (4 diffs)
• rest-api/endpoints/class-wp-rest-global-styles-controller.php (modified) (1 diff)
• script-loader.php (modified) (1 diff)
• style-engine/class-wp-style-engine-css-rules-store.php (modified) (3 diffs)
• style-engine/class-wp-style-engine-processor.php (modified) (1 diff)
• style-engine/class-wp-style-engine.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-theme-json-schema.php

@@ -139 +139 @@
          * @param array $settings Reference to the current settings array.
          * @param array $path Path to the property to be removed.
-         *
-         * @return void
          */
         private static function unset_setting_by_path( &$settings, $path ) {

trunk/src/wp-includes/html-api/class-wp-html-tag-processor.php

@@ -1259 +1259 @@
          *
          * @since 6.2.0
-         *
-         * @return void
          */
         private function skip_whitespace() {
@@ -1270 +1268 @@
          *
          * @since 6.2.0
-         *
-         * @return void
          */
         private function after_tag() {
@@ -1290 +1286 @@
          * @see WP_HTML_Tag_Processor::$lexical_updates
          * @see WP_HTML_Tag_Processor::$classname_updates
-         *
-         * @return void
          */
         private function class_name_updates_to_attributes_updates() {
@@ -2184 +2178 @@
          *     @type string      $tag_closers  "visit" or "skip": whether to stop on tag closers, e.g. </div>.
          * }
-         * @return void
          */
         private function parse_query( $query ) {

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php

@@ -35 +35 @@
          *
          * @since 5.9.0
-         *
-         * @return void
          */
         public function register_routes() {

trunk/src/wp-includes/script-loader.php

@@ -3022 +3022 @@
  *     @type bool $prettify Whether to add new lines and indents to output. Default is the test of whether the global constant `SCRIPT_DEBUG` is defined.
  * }
- *
- * @return void
  */
 function wp_enqueue_stored_styles( $options = array() ) {

trunk/src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php

@@ -81 +81 @@
          *
          * @since 6.1.0
-         *
-         * @return void
          */
         public static function remove_all_stores() {
@@ -94 +92 @@
          *
          * @param string $name The store name.
-         * @return void
          */
         public function set_name( $name ) {
@@ -153 +150 @@
          *
          * @param string $selector The CSS selector.
-         * @return void
          */
         public function remove_rule( $selector ) {

trunk/src/wp-includes/style-engine/class-wp-style-engine-processor.php

@@ -127 +127 @@
          *
          * @since 6.1.0
-         *
-         * @return void
          */
         private function combine_rules_selectors() {

trunk/src/wp-includes/style-engine/class-wp-style-engine.php

@@ -289 +289 @@
          * @param string   $css_selector     When a selector is passed, the function will return a full CSS rule `$selector { ...rules }`, otherwise a concatenated string of properties and values.
          * @param string[] $css_declarations An associative array of CSS definitions, e.g., `array( "$property" => "$value", "$property" => "$value" )`.
-         * @return void
          */
         public static function store_css_rule( $store_name, $css_selector, $css_declarations ) {