Changeset 56180 for trunk/src/wp-includes/class-wp-theme.php

Timestamp:

07/09/2023 09:46:24 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], [56176], [56177], [56178], [56179].

Props costdev, audrasjb.
See #58459.

File:

• trunk/src/wp-includes/class-wp-theme.php (modified) (4 diffs)

trunk/src/wp-includes/class-wp-theme.php

@@ -322 +322 @@
         } else {
             $this->headers = get_file_data( $this->theme_root . '/' . $theme_file, self::$file_headers, 'theme' );
-            // Default themes always trump their pretenders.
-            // Properly identify default themes that are inside a directory within wp-content/themes.
+            /*
+             * Default themes always trump their pretenders.
+             * Properly identify default themes that are inside a directory within wp-content/themes.
+             */
             $default_theme_slug = array_search( $this->headers['Name'], self::$default_themes, true );
             if ( $default_theme_slug ) {
@@ -390 +392 @@
         // If we got our data from cache, we can assume that 'template' is pointing to the right place.
         if ( ! is_array( $cache ) && $this->template != $this->stylesheet && ! file_exists( $this->theme_root . '/' . $this->template . '/index.php' ) ) {
-            // If we're in a directory of themes inside /themes, look for the parent nearby.
-            // wp-content/themes/directory-of-themes/*
+            /*
+             * If we're in a directory of themes inside /themes, look for the parent nearby.
+             * wp-content/themes/directory-of-themes/*
+             */
             $parent_dir  = dirname( $this->stylesheet );
             $directories = search_theme_directories();
@@ -398 +402 @@
                 $this->template = $parent_dir . '/' . $this->template;
             } elseif ( $directories && isset( $directories[ $this->template ] ) ) {
-                // Look for the template in the search_theme_directories() results, in case it is in another theme root.
-                // We don't look into directories of themes, just the theme root.
+                /*
+                 * Look for the template in the search_theme_directories() results, in case it is in another theme root.
+                 * We don't look into directories of themes, just the theme root.
+                 */
                 $theme_root_template = $directories[ $this->template ]['theme_root'];
             } else {
@@ -1666 +1672 @@
         }
 
-        // This is all super old MU back compat joy.
-        // 'allowedthemes' keys things by stylesheet. 'allowed_themes' keyed things by name.
+        /*
+         * This is all super old MU back compat joy.
+         * 'allowedthemes' keys things by stylesheet. 'allowed_themes' keyed things by name.
+         */
         if ( false === $allowed_themes[ $blog_id ] ) {
             if ( $current ) {