Changeset 56175

Timestamp:

07/09/2023 07:54:42 PM (17 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].

Props costdev, audrasjb.
See #58459.

Location:

trunk/src/wp-admin

Files:

• menu-header.php (modified) (1 diff)
• update-core.php (modified) (1 diff)
• user-edit.php (modified) (1 diff)

trunk/src/wp-admin/menu-header.php

@@ -227 +227 @@
                         $aria_attributes .= ' aria-current="page"';
                     }
-                    // If plugin_page is set the parent must either match the current page or not physically exist.
-                    // This allows plugin pages with the same hook to exist under different parents.
+                    /*
+                     * If plugin_page is set the parent must either match the current page or not physically exist.
+                     * This allows plugin pages with the same hook to exist under different parents.
+                     */
                 } elseif (
                     ( ! isset( $plugin_page ) && $self === $sub_item[2] )

trunk/src/wp-admin/update-core.php

@@ -851 +851 @@
     }
 
-    // Allow relaxed file ownership writes for User-initiated upgrades when the API specifies
-    // that it's safe to do so. This only happens when there are no new files to create.
+    /*
+     * Allow relaxed file ownership writes for User-initiated upgrades when the API specifies
+     * that it's safe to do so. This only happens when there are no new files to create.
+     */
     $allow_relaxed_file_ownership = ! $reinstall && isset( $update->new_files ) && ! $update->new_files;
 

trunk/src/wp-admin/user-edit.php

@@ -922 +922 @@
         var languageSelect = $( '#locale' );
         $( 'form' ).on( 'submit', function() {
-            // Don't show a spinner for English and installed languages,
-            // as there is nothing to download.
+            /*
+             * Don't show a spinner for English and installed languages,
+             * as there is nothing to download.
+             */
             if ( ! languageSelect.find( 'option:selected' ).data( 'installed' ) ) {
                 $( '#submit', this ).after( '<span class="spinner language-install-spinner is-active" />' );