Changeset 56195 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php

Timestamp:

07/10/2023 11:17:05 PM (15 months 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], [56193], [56194].

Props costdev, audrasjb.
See #58459.

File:

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

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

@@ -102 +102 @@
                 '/%s/(?P<id>%s%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: `/:<>*?"|`.
+                 */
                 '([^\/:<>\*\?"\|]+(?:\/[^\/:<>\*\?"\|]+)?)',
                 // Matches the template name.
@@ -178 +180 @@
      */
     protected function 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(
@@ -503 +507 @@
             }
 
-            // (Note that internally this falls through to `wp_delete_post()`
-            // if the Trash is disabled.)
+            /*
+             * (Note that internally this falls through to `wp_delete_post()`
+             * if the Trash is disabled.)
+             */
             $result           = wp_trash_post( $id );
             $template->status = 'trash';