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

Timestamp:

01/29/2020 12:43:23 AM (5 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.