Changeset 56176 for trunk/src/wp-admin/includes/update-core.php

Timestamp:

07/09/2023 08:05:43 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].

Props costdev, audrasjb.
See #58459.

File:

• trunk/src/wp-admin/includes/update-core.php (modified) (4 diffs)

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

@@ -1230 +1230 @@
         apply_filters( 'update_feedback', __( 'Preparing to install the latest version…' ) );
 
-        // Don't copy wp-content, we'll deal with that below.
-        // We also copy version.php last so failed updates report their old version.
+        /*
+         * Don't copy wp-content, we'll deal with that below.
+         * We also copy version.php last so failed updates report their old version.
+         */
         $skip              = array( 'wp-content', 'wp-includes/version.php' );
         $check_is_writable = array();
@@ -1398 +1400 @@
                 }
 
-                // If we don't have enough free space, it isn't worth trying again.
-                // Unlikely to be hit due to the check in unzip_file().
+                /*
+                 * If we don't have enough free space, it isn't worth trying again.
+                 * Unlikely to be hit due to the check in unzip_file().
+                 */
                 $available_space = function_exists( 'disk_free_space' ) ? @disk_free_space( ABSPATH ) : false;
 
@@ -1417 +1421 @@
         }
 
-        // Custom content directory needs updating now.
-        // Copy languages.
+        /*
+         * Custom content directory needs updating now.
+         * Copy languages.
+         */
         if ( ! is_wp_error( $result ) && $wp_filesystem->is_dir( $from . $distro . 'wp-content/languages' ) ) {
                 if ( WP_LANG_DIR !== ABSPATH . WPINC . '/languages' || @is_dir( WP_LANG_DIR ) ) {
@@ -1456 +1462 @@
         $wp_filesystem->delete( $maintenance_file );
 
-        // 3.5 -> 3.5+ - an empty twentytwelve directory was created upon upgrade to 3.5 for some users,
-        // preventing installation of Twenty Twelve.
+        /*
+         * 3.5 -> 3.5+ - an empty twentytwelve directory was created upon upgrade to 3.5 for some users,
+         * preventing installation of Twenty Twelve.
+         */
         if ( '3.5' === $old_wp_version ) {
                 if ( is_dir( WP_CONTENT_DIR . '/themes/twentytwelve' )