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

Timestamp:

07/10/2023 10:58:33 PM (3 years ago)

Author:

audrasjb

Message:

Docs: Replace multiple single line comments with multi-line comments.

This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See ​https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.

Follow-up to [56174], [56175], [56176], [56177], [56178], [56179], [56180], [56191], [56192].

Props costdev, audrasjb.
See #58459.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php (modified) (3 diffs)

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

@@ -62 +62 @@
                                 '/%s/themes/(?P<stylesheet>%s)',
                                 $this->rest_base,
-                                // Matches theme's directory: `/themes/<subdirectory>/<theme>/` or `/themes/<theme>/`.
-                                // Excludes invalid directory name characters: `/:<>*?"|`.
+                                /*
+                                 * Matches theme's directory: `/themes/<subdirectory>/<theme>/` or `/themes/<theme>/`.
+                                 * Excludes invalid directory name characters: `/:<>*?"|`.
+                                 */
                                 '[^\/:<>\*\?"\|]+(?:\/[^\/:<>\*\?"\|]+)?'
                         ),
@@ -566 +568 @@
          */
         public function get_theme_item_permissions_check( $request ) {
-                // Verify if the current user has edit_theme_options capability.
-                // This capability is required to edit/view/delete templates.
+                /*
+                 * Verify if the current user has edit_theme_options capability.
+                 * This capability is required to edit/view/delete templates.
+                 */
                 if ( ! current_user_can( 'edit_theme_options' ) ) {
                         return new WP_Error(
@@ -639 +643 @@
          */
         public function get_theme_items_permissions_check( $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
-                // Verify if the current user has edit_theme_options capability.
-                // This capability is required to edit/view/delete templates.
+                /*
+                 * Verify if the current user has edit_theme_options capability.
+                 * This capability is required to edit/view/delete templates.
+                 */
                 if ( ! current_user_can( 'edit_theme_options' ) ) {
                         return new WP_Error(