Changeset 47122 for trunk/src/wp-admin/themes.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-admin/themes.php (modified) (6 diffs)

trunk/src/wp-admin/themes.php

@@ -88 +88 @@
 $parent_file = 'themes.php';
 
-// Help tab: Overview
+// Help tab: Overview.
 if ( current_user_can( 'switch_themes' ) ) {
     $help_overview = '<p>' . __( 'This screen is used for managing your installed themes. Aside from the default theme(s) included with your WordPress installation, themes are designed and developed by third parties.' ) . '</p>' .
@@ -105 +105 @@
         )
     );
-} // switch_themes
-
-// Help tab: Adding Themes
+} // End if 'switch_themes'.
+
+// Help tab: Adding Themes.
 if ( current_user_can( 'install_themes' ) ) {
     if ( is_multisite() ) {
@@ -126 +126 @@
         )
     );
-} // install_themes
-
-// Help tab: Previewing and Customizing
+} // End if 'install_themes'.
+
+// Help tab: Previewing and Customizing.
 if ( current_user_can( 'edit_theme_options' ) && current_user_can( 'customize' ) ) {
     $help_customize =
@@ -142 +142 @@
         )
     );
-} // edit_theme_options && customize
+} // End if 'edit_theme_options' && 'customize'.
 
 get_current_screen()->set_help_sidebar(
@@ -171 +171 @@
             'addNew'            => __( 'Add New Theme' ),
             'search'            => __( 'Search Installed Themes' ),
-            'searchPlaceholder' => __( 'Search installed themes...' ), // placeholder (no ellipsis)
+            'searchPlaceholder' => __( 'Search installed themes...' ), // Placeholder (no ellipsis).
             /* translators: %d: Number of themes. */
             'themesFound'       => __( 'Number of Themes found: %d' ),
@@ -251 +251 @@
             continue;
         }
-        // 0 = name, 1 = capability, 2 = file
+        // 0 = name, 1 = capability, 2 = file.
         if ( ( strcmp( $self, $item[2] ) == 0 && empty( $parent_file ) ) || ( $parent_file && ( $item[2] == $parent_file ) ) ) {
             $class = ' current';