Changeset 47122 for trunk/src/wp-includes/class-wp-theme.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/class-wp-theme.php (modified) (11 diffs)

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

@@ -174 +174 @@
          * Constructor for WP_Theme.
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @global array $wp_theme_directories
@@ -436 +436 @@
          * When converting the object to a string, the theme name is returned.
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @return string Theme name, ready for display (translated)
@@ -449 +449 @@
          * @staticvar array $properties
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @param string $offset Property to check if set.
@@ -478 +478 @@
          * __get() magic method for properties formerly returned by current_theme_info()
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @param string $offset Property to get.
@@ -522 +522 @@
          * Method to implement ArrayAccess for keys formerly returned by get_themes()
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @param mixed $offset
@@ -532 +532 @@
          * Method to implement ArrayAccess for keys formerly returned by get_themes()
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @param mixed $offset
@@ -543 +543 @@
          * @staticvar array $keys
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @param mixed $offset
@@ -584 +584 @@
          * translated header.
          *
-         * @since  3.4.0
+         * @since 3.4.0
          *
          * @param mixed $offset
@@ -960 +960 @@
                                         );
 
-                                        $feature_list = get_theme_feature_list( false ); // No API
+                                        $feature_list = get_theme_feature_list( false ); // No API.
                                         foreach ( $feature_list as $tags ) {
                                                 $tags_list += $tags;
@@ -1342 +1342 @@
          * Loads the theme's textdomain.
          *
-         * Translation files are not inherited from the parent theme. Todo: if this fails for the
+         * Translation files are not inherited from the parent theme. TODO: If this fails for the
          * child theme, it should probably try to load the parent theme's translations.
          *
@@ -1415 +1415 @@
          * This hits the filesystem.
          *
-         * @since  4.4.0
+         * @since 4.4.0
          *
          * @return WP_Theme|false Object, or false if no theme is installed, which would be bad.