Changeset 47122 for trunk/src/wp-includes/update.php

Timestamp:

01/29/2020 12:43:23 AM (7 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/src/wp-includes/update.php (modified) (13 diffs)

trunk/src/wp-includes/update.php

@@ -28 +28 @@
 
         global $wpdb, $wp_local_package;
-        // include an unmodified $wp_version
+        // Include an unmodified $wp_version.
         include( ABSPATH . WPINC . '/version.php' );
         $php_version = phpversion();
@@ -35 +35 @@
         $translations = wp_get_installed_translations( 'core' );
 
-        // Invalidate the transient when $wp_version changes
+        // Invalidate the transient when $wp_version changes.
         if ( is_object( $current ) && $wp_version != $current->version_checked ) {
                 $current = false;
@@ -50 +50 @@
         }
 
-        // Wait 60 seconds between multiple version check requests
-        $timeout          = 60;
+        // Wait 1 minute between multiple version check requests.
+        $timeout          = MINUTE_IN_SECONDS;
         $time_not_changed = isset( $current->last_checked ) && $timeout > ( time() - $current->last_checked );
         if ( ! $force_check && $time_not_changed ) {
@@ -66 +66 @@
         $locale = apply_filters( 'core_version_check_locale', get_locale() );
 
-        // Update last_checked for current to prevent multiple blocking requests if request hangs
+        // Update last_checked for current to prevent multiple blocking requests if request hangs.
         $current->last_checked = time();
         set_site_transient( 'update_core', $current );
@@ -261 +261 @@
         }
 
-        // include an unmodified $wp_version
+        // Include an unmodified $wp_version.
         include( ABSPATH . WPINC . '/version.php' );
 
-        // If running blog-side, bail unless we've not checked in the last 12 hours
+        // If running blog-side, bail unless we've not checked in the last 12 hours.
         if ( ! function_exists( 'get_plugins' ) ) {
                 require_once( ABSPATH . 'wp-admin/includes/plugin.php' );
@@ -324 +324 @@
                 }
 
-                // Bail if we've checked recently and if nothing has changed
+                // Bail if we've checked recently and if nothing has changed.
                 if ( ! $plugin_changed ) {
                         return;
@@ -330 +330 @@
         }
 
-        // Update last_checked for current to prevent multiple blocking requests if request hangs
+        // Update last_checked for current to prevent multiple blocking requests if request hangs.
         $current->last_checked = time();
         set_site_transient( 'update_plugins', $current );
@@ -352 +352 @@
                 $timeout = 30;
         } else {
-                // Three seconds, plus one extra second for every 10 plugins
+                // Three seconds, plus one extra second for every 10 plugins.
                 $timeout = 3 + (int) ( count( $plugins ) / 10 );
         }
@@ -441 +441 @@
         }
 
-        // include an unmodified $wp_version
+        // Include an unmodified $wp_version.
         include( ABSPATH . WPINC . '/version.php' );
 
@@ -514 +514 @@
                 }
 
-                // Bail if we've checked recently and if nothing has changed
+                // Bail if we've checked recently and if nothing has changed.
                 if ( ! $theme_changed ) {
                         return;
@@ -520 +520 @@
         }
 
-        // Update last_checked for current to prevent multiple blocking requests if request hangs
+        // Update last_checked for current to prevent multiple blocking requests if request hangs.
         $last_update->last_checked = time();
         set_site_transient( 'update_themes', $last_update );
@@ -542 +542 @@
                 $timeout = 30;
         } else {
-                // Three seconds, plus one extra second for every 10 themes
+                // Three seconds, plus one extra second for every 10 themes.
                 $timeout = 3 + (int) ( count( $themes ) / 10 );
         }
@@ -729 +729 @@
  */
 function _maybe_update_core() {
-        // include an unmodified $wp_version
+        // Include an unmodified $wp_version.
         include( ABSPATH . WPINC . '/version.php' );