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

Timestamp:

01/29/2020 12:43:23 AM (6 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' );