From 8fe11fa642aa0dec3b6603c7723c9085a3da5780 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Sun, 22 May 2016 18:05:54 +0000
Subject: [PATCH] Docs: Standardize hook docs in wp-includes/widgets/* to use
 third-person singular verbs per the inline documentation standards for PHP.

See #36913.


git-svn-id: https://develop.svn.wordpress.org/trunk@37489 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/widgets/class-wp-nav-menu-widget.php        | 2 +-
 src/wp-includes/widgets/class-wp-widget-archives.php        | 4 ++--
 src/wp-includes/widgets/class-wp-widget-categories.php      | 4 ++--
 src/wp-includes/widgets/class-wp-widget-links.php           | 2 +-
 src/wp-includes/widgets/class-wp-widget-meta.php            | 2 +-
 src/wp-includes/widgets/class-wp-widget-pages.php           | 4 ++--
 src/wp-includes/widgets/class-wp-widget-recent-comments.php | 4 ++--
 src/wp-includes/widgets/class-wp-widget-recent-posts.php    | 2 +-
 src/wp-includes/widgets/class-wp-widget-tag-cloud.php       | 2 +-
 src/wp-includes/widgets/class-wp-widget-text.php            | 2 +-
 10 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/wp-includes/widgets/class-wp-nav-menu-widget.php b/src/wp-includes/widgets/class-wp-nav-menu-widget.php
index d43aa3325b..3368458457 100644
--- a/src/wp-includes/widgets/class-wp-nav-menu-widget.php
+++ b/src/wp-includes/widgets/class-wp-nav-menu-widget.php
@@ -61,7 +61,7 @@ class WP_Nav_Menu_Widget extends WP_Widget {
 		);
 
 		/**
-		 * Filter the arguments for the Custom Menu widget.
+		 * Filters the arguments for the Custom Menu widget.
 		 *
 		 * @since 4.2.0
 		 * @since 4.4.0 Added the `$instance` parameter.
diff --git a/src/wp-includes/widgets/class-wp-widget-archives.php b/src/wp-includes/widgets/class-wp-widget-archives.php
index ba12572bcb..f36b47ee8e 100644
--- a/src/wp-includes/widgets/class-wp-widget-archives.php
+++ b/src/wp-includes/widgets/class-wp-widget-archives.php
@@ -60,7 +60,7 @@ class WP_Widget_Archives extends WP_Widget {
 		<select id="<?php echo esc_attr( $dropdown_id ); ?>" name="archive-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'>
 			<?php
 			/**
-			 * Filter the arguments for the Archives widget drop-down.
+			 * Filters the arguments for the Archives widget drop-down.
 			 *
 			 * @since 2.8.0
 			 *
@@ -101,7 +101,7 @@ class WP_Widget_Archives extends WP_Widget {
 		<ul>
 		<?php
 		/**
-		 * Filter the arguments for the Archives widget.
+		 * Filters the arguments for the Archives widget.
 		 *
 		 * @since 2.8.0
 		 *
diff --git a/src/wp-includes/widgets/class-wp-widget-categories.php b/src/wp-includes/widgets/class-wp-widget-categories.php
index 2fbc62a2e8..2e52423d12 100644
--- a/src/wp-includes/widgets/class-wp-widget-categories.php
+++ b/src/wp-includes/widgets/class-wp-widget-categories.php
@@ -72,7 +72,7 @@ class WP_Widget_Categories extends WP_Widget {
 			$cat_args['id'] = $dropdown_id;
 
 			/**
-			 * Filter the arguments for the Categories widget drop-down.
+			 * Filters the arguments for the Categories widget drop-down.
 			 *
 			 * @since 2.8.0
 			 *
@@ -105,7 +105,7 @@ class WP_Widget_Categories extends WP_Widget {
 		$cat_args['title_li'] = '';
 
 		/**
-		 * Filter the arguments for the Categories widget.
+		 * Filters the arguments for the Categories widget.
 		 *
 		 * @since 2.8.0
 		 *
diff --git a/src/wp-includes/widgets/class-wp-widget-links.php b/src/wp-includes/widgets/class-wp-widget-links.php
index 68d86f16d7..b3bda4cef5 100644
--- a/src/wp-includes/widgets/class-wp-widget-links.php
+++ b/src/wp-includes/widgets/class-wp-widget-links.php
@@ -69,7 +69,7 @@ class WP_Widget_Links extends WP_Widget {
 		);
 
 		/**
-		 * Filter the arguments for the Links widget.
+		 * Filters the arguments for the Links widget.
 		 *
 		 * @since 2.6.0
 		 * @since 4.4.0 The `$instance` parameter was added.
diff --git a/src/wp-includes/widgets/class-wp-widget-meta.php b/src/wp-includes/widgets/class-wp-widget-meta.php
index 2de9844a52..e4a3b51ac9 100644
--- a/src/wp-includes/widgets/class-wp-widget-meta.php
+++ b/src/wp-includes/widgets/class-wp-widget-meta.php
@@ -59,7 +59,7 @@ class WP_Widget_Meta extends WP_Widget {
 			<li><a href="<?php echo esc_url( get_bloginfo( 'comments_rss2_url' ) ); ?>"><?php _e('Comments <abbr title="Really Simple Syndication">RSS</abbr>'); ?></a></li>
 			<?php
 			/**
-			 * Filter the "Powered by WordPress" text in the Meta widget.
+			 * Filters the "Powered by WordPress" text in the Meta widget.
 			 *
 			 * @since 3.6.0
 			 *
diff --git a/src/wp-includes/widgets/class-wp-widget-pages.php b/src/wp-includes/widgets/class-wp-widget-pages.php
index 165f33487d..9fd2afc573 100644
--- a/src/wp-includes/widgets/class-wp-widget-pages.php
+++ b/src/wp-includes/widgets/class-wp-widget-pages.php
@@ -44,7 +44,7 @@ class WP_Widget_Pages extends WP_Widget {
 	public function widget( $args, $instance ) {
 
 		/**
-		 * Filter the widget title.
+		 * Filters the widget title.
 		 *
 		 * @since 2.6.0
 		 *
@@ -61,7 +61,7 @@ class WP_Widget_Pages extends WP_Widget {
 			$sortby = 'menu_order, post_title';
 
 		/**
-		 * Filter the arguments for the Pages widget.
+		 * Filters the arguments for the Pages widget.
 		 *
 		 * @since 2.8.0
 		 *
diff --git a/src/wp-includes/widgets/class-wp-widget-recent-comments.php b/src/wp-includes/widgets/class-wp-widget-recent-comments.php
index 71fb4d2f5a..711b9106fd 100644
--- a/src/wp-includes/widgets/class-wp-widget-recent-comments.php
+++ b/src/wp-includes/widgets/class-wp-widget-recent-comments.php
@@ -44,7 +44,7 @@ class WP_Widget_Recent_Comments extends WP_Widget {
 	 */
 	public function recent_comments_style() {
 		/**
-		 * Filter the Recent Comments default widget styles.
+		 * Filters the Recent Comments default widget styles.
 		 *
 		 * @since 3.1.0
 		 *
@@ -85,7 +85,7 @@ class WP_Widget_Recent_Comments extends WP_Widget {
 			$number = 5;
 
 		/**
-		 * Filter the arguments for the Recent Comments widget.
+		 * Filters the arguments for the Recent Comments widget.
 		 *
 		 * @since 3.4.0
 		 *
diff --git a/src/wp-includes/widgets/class-wp-widget-recent-posts.php b/src/wp-includes/widgets/class-wp-widget-recent-posts.php
index fdb54a0ff2..9483b97e27 100644
--- a/src/wp-includes/widgets/class-wp-widget-recent-posts.php
+++ b/src/wp-includes/widgets/class-wp-widget-recent-posts.php
@@ -58,7 +58,7 @@ class WP_Widget_Recent_Posts extends WP_Widget {
 		$show_date = isset( $instance['show_date'] ) ? $instance['show_date'] : false;
 
 		/**
-		 * Filter the arguments for the Recent Posts widget.
+		 * Filters the arguments for the Recent Posts widget.
 		 *
 		 * @since 3.4.0
 		 *
diff --git a/src/wp-includes/widgets/class-wp-widget-tag-cloud.php b/src/wp-includes/widgets/class-wp-widget-tag-cloud.php
index 1251e1d29e..ae0832acbf 100644
--- a/src/wp-includes/widgets/class-wp-widget-tag-cloud.php
+++ b/src/wp-includes/widgets/class-wp-widget-tag-cloud.php
@@ -54,7 +54,7 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
 		}
 
 		/**
-		 * Filter the taxonomy used in the Tag Cloud widget.
+		 * Filters the taxonomy used in the Tag Cloud widget.
 		 *
 		 * @since 2.8.0
 		 * @since 3.0.0 Added taxonomy drop-down.
diff --git a/src/wp-includes/widgets/class-wp-widget-text.php b/src/wp-includes/widgets/class-wp-widget-text.php
index a8ec3d4fd8..a379fd719d 100644
--- a/src/wp-includes/widgets/class-wp-widget-text.php
+++ b/src/wp-includes/widgets/class-wp-widget-text.php
@@ -50,7 +50,7 @@ class WP_Widget_Text extends WP_Widget {
 		$widget_text = ! empty( $instance['text'] ) ? $instance['text'] : '';
 
 		/**
-		 * Filter the content of the Text widget.
+		 * Filters the content of the Text widget.
 		 *
 		 * @since 2.3.0
 		 * @since 4.4.0 Added the `$this` parameter.