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

Reference: [https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#documenting-tips PHP Documentation Standards: Documenting Tips].

Props vladimiraus, mukesh27, SergeyBiryukov.
See #63692.

git-svn-id: https://develop.svn.wordpress.org/trunk@60506 602fd350-edb4-49c9-b593-d223f7449a82

Author: SergeyBiryukov

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

@@ -298,7 +298,7 @@ function twentyeleven_setup() {
 endif; // twentyeleven_setup()
 
 /**
- * Enqueue scripts and styles for front end.
+ * Enqueues scripts and styles for front end.
  *
  * @since Twenty Eleven 2.9
  */
@@ -309,7 +309,7 @@ function twentyeleven_scripts_styles() {
 add_action( 'wp_enqueue_scripts', 'twentyeleven_scripts_styles' );
 
 /**
- * Enqueue styles for the block-based editor.
+ * Enqueues styles for the block-based editor.
  *
  * @since Twenty Eleven 2.9
  */
@@ -473,7 +473,7 @@ function twentyeleven_header_image() {
 endif; // twentyeleven_header_image()
 
 /**
- * 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
  * the filter and add your own function tied to
@@ -524,7 +524,7 @@ function twentyeleven_auto_excerpt_more( $more ) {
 add_filter( 'excerpt_more', 'twentyeleven_auto_excerpt_more' );
 
 /**
- * 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
  * function tied to the get_the_excerpt filter hook.
@@ -543,7 +543,7 @@ function twentyeleven_custom_excerpt_more( $output ) {
 add_filter( 'get_the_excerpt', 'twentyeleven_custom_excerpt_more' );
 
 /**
- * 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
  *
@@ -559,7 +559,7 @@ function twentyeleven_page_menu_args( $args ) {
 add_filter( 'wp_page_menu_args', 'twentyeleven_page_menu_args' );
 
 /**
- * Register sidebars and widgetized areas.
+ * Registers sidebars and widgetized areas.
  *
  * Also register the default Ephemera widget.
  *
@@ -632,7 +632,7 @@ function twentyeleven_widgets_init() {
 
 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
 	 *
@@ -851,7 +851,7 @@ function twentyeleven_posted_on() {
 endif;
 
 /**
- * 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.
  * The second is if a singular post being displayed
@@ -876,7 +876,7 @@ function twentyeleven_body_classes( $classes ) {
 add_filter( 'body_class', 'twentyeleven_body_classes' );
 
 /**
- * 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,
  *                            then as last option uses a get_posts() call.

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

@@ -11,7 +11,7 @@
  */
 
 /**
- * Register Block Pattern Category.
+ * Registers Block Pattern Category.
  */
 if ( function_exists( 'register_block_pattern_category' ) ) {
 
@@ -22,7 +22,7 @@
 }
 
 /**
- * Register Block Patterns.
+ * Registers Block Patterns.
  */
 if ( function_exists( 'register_block_pattern' ) ) {
 

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

@@ -24,7 +24,7 @@ function twentyeleven_admin_enqueue_scripts( $hook_suffix ) {
 add_action( 'admin_print_styles-appearance_page_theme_options', 'twentyeleven_admin_enqueue_scripts' );
 
 /**
- * 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.
  *
@@ -84,7 +84,7 @@ function twentyeleven_option_page_capability( $capability ) {
 add_filter( 'option_page_capability_twentyeleven_options', 'twentyeleven_option_page_capability' );
 
 /**
- * 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.
  *
@@ -409,7 +409,7 @@ function twentyeleven_theme_options_validate( $input ) {
 }
 
 /**
- * Enqueue the styles for the current color scheme.
+ * Enqueues the styles for the current color scheme.
  *
  * @since Twenty Eleven 1.0
  */
@@ -433,7 +433,7 @@ function twentyeleven_enqueue_color_scheme() {
 add_action( 'wp_enqueue_scripts', 'twentyeleven_enqueue_color_scheme' );
 
 /**
- * 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.
  *
@@ -482,7 +482,7 @@ function twentyeleven_print_link_color_style() {
 add_action( 'wp_head', 'twentyeleven_print_link_color_style' );
 
 /**
- * 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
  *

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

@@ -181,7 +181,7 @@ public function flush_widget_cache() {
 	}
 
 	/**
-	 * 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.
 	 *