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 ) {