Changeset 60506

Timestamp:

07/24/2025 02:24:09 PM (6 months ago)

Author:

SergeyBiryukov

Message:

Twenty Eleven: Use third-person singular verbs for function descriptions.

Reference: ​PHP Documentation Standards: Documenting Tips.

Props vladimiraus, mukesh27, SergeyBiryukov.
See #63692.

Location:

trunk/src/wp-content/themes/twentyeleven

Files:

• functions.php (modified) (9 diffs)
• inc/block-patterns.php (modified) (2 diffs)
• inc/theme-options.php (modified) (5 diffs)
• inc/widgets.php (modified) (1 diff)

trunk/src/wp-content/themes/twentyeleven/functions.php

@@ -299 +299 @@
 
 /**
- * Enqueue scripts and styles for front end.
+ * Enqueues scripts and styles for front end.
  *
  * @since Twenty Eleven 2.9
@@ -310 +310 @@
 
 /**
- * Enqueue styles for the block-based editor.
+ * Enqueues styles for the block-based editor.
  *
  * @since Twenty Eleven 2.9
@@ -474 +474 @@
 
 /**
- * Set the post excerpt length to 40 words.
+ * Sets the post excerpt length to 40 words.
  *
  * To override this length in a child theme, remove
@@ -525 +525 @@
 
 /**
- * Add a pretty "Continue Reading" link to custom post excerpts.
+ * Adds a pretty "Continue Reading" link to custom post excerpts.
  *
  * To override this link in a child theme, remove the filter and add your own
@@ -544 +544 @@
 
 /**
- * Show a home link for the wp_nav_menu() fallback, wp_page_menu().
+ * Shows a home link for the wp_nav_menu() fallback, wp_page_menu().
  *
  * @since Twenty Eleven 1.0
@@ -560 +560 @@
 
 /**
- * Register sidebars and widgetized areas.
+ * Registers sidebars and widgetized areas.
  *
  * Also register the default Ephemera widget.
@@ -633 +633 @@
 if ( ! function_exists( 'twentyeleven_content_nav' ) ) :
     /**
-     * Display navigation to next/previous pages when applicable.
+     * Displays navigation to next/previous pages when applicable.
      *
      * @since Twenty Eleven 1.0
@@ -852 +852 @@
 
 /**
- * Add two classes to the array of body classes.
+ * Adds two classes to the array of body classes.
  *
  * The first is if the site has only had one author with published posts.
@@ -877 +877 @@
 
 /**
- * Retrieve the IDs for images in a gallery.
+ * Retrieves the IDs for images in a gallery.
  *
  * @uses get_post_galleries() First, if available. Falls back to shortcode parsing,

trunk/src/wp-content/themes/twentyeleven/inc/block-patterns.php

@@ -12 +12 @@
 
 /**
- * Register Block Pattern Category.
+ * Registers Block Pattern Category.
  */
 if ( function_exists( 'register_block_pattern_category' ) ) {
@@ -23 +23 @@
 
 /**
- * Register Block Patterns.
+ * Registers Block Patterns.
  */
 if ( function_exists( 'register_block_pattern' ) ) {

trunk/src/wp-content/themes/twentyeleven/inc/theme-options.php

@@ -25 +25 @@
 
 /**
- * Register the form setting for our twentyeleven_options array.
+ * Registers the form setting for our twentyeleven_options array.
  *
  * This function is attached to the admin_init action hook.
@@ -85 +85 @@
 
 /**
- * Add a theme options page to the admin menu, including some help documentation.
+ * Adds a theme options page to the admin menu, including some help documentation.
  *
  * This function is attached to the admin_menu action hook.
@@ -410 +410 @@
 
 /**
- * Enqueue the styles for the current color scheme.
+ * Enqueues the styles for the current color scheme.
  *
  * @since Twenty Eleven 1.0
@@ -434 +434 @@
 
 /**
- * Add a style block to the theme for the current link color.
+ * Adds a style block to the theme for the current link color.
  *
  * This function is attached to the wp_head action hook.
@@ -483 +483 @@
 
 /**
- * Add Twenty Eleven layout classes to the array of body classes.
+ * Adds Twenty Eleven layout classes to the array of body classes.
  *
  * @since Twenty Eleven 1.0

trunk/src/wp-content/themes/twentyeleven/inc/widgets.php

@@ -182 +182 @@
 
     /**
-     * Set up the widget form.
+     * Sets up the widget form.
      *
      * Displays the form for this widget on the Widgets page of the WP Admin area.