Short descriptions for inline docs should end with a period, per the vast majority of core. see #25229.

Built from https://develop.svn.wordpress.org/trunk@25273


git-svn-id: http://core.svn.wordpress.org/trunk@25239 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/admin-footer.php

@@ -27,7 +27,7 @@ if ( !defined('ABSPATH') )
 	<p id="footer-left" class="alignleft">
 		<?php
 		/**
-		 * Filter the "Thank you" text displayed in the admin footer
+		 * Filter the "Thank you" text displayed in the admin footer.
 		 * 
 		 * @since 2.8.0
 		 * @param string The content that will be printed.
@@ -38,7 +38,7 @@ if ( !defined('ABSPATH') )
 	<p id="footer-upgrade" class="alignright">
 		<?php
 		/**
-		 * Filter the version/update text displayed in the admin footer
+		 * Filter the version/update text displayed in the admin footer.
 		 *
 		 * @see core_update_footer() WordPress prints the current version and update information,
 		 *	using core_update_footer() at priority 10.
@@ -53,7 +53,7 @@ if ( !defined('ABSPATH') )
 </div>
 <?php
 /**
- * Print scripts or data before the default footer scripts
+ * Print scripts or data before the default footer scripts.
  * 
  * @since 2.5.0
  * @param string The data to print.
@@ -61,18 +61,18 @@ if ( !defined('ABSPATH') )
 do_action('admin_footer', '');
 
 /**
- * Prints any scripts and data queued for the footer
+ * Prints any scripts and data queued for the footer.
  * 
  * @since 2.8.0
  */
 do_action('admin_print_footer_scripts');
 
 /**
- * Print scripts or data after the default footer scripts
+ * Print scripts or data after the default footer scripts.
  * 
- * @since unknown
+ * @since 2.8.0
  * 
- * @param type $GLOBALS['hook_suffix'] The current admin page.
+ * @param string $GLOBALS['hook_suffix'] The current admin page.
  */
 do_action("admin_footer-" . $GLOBALS['hook_suffix']);
 

wp-admin/index.php

@@ -122,7 +122,7 @@ $today = current_time('mysql', 1);
 		<a class="welcome-panel-close" href="<?php echo esc_url( admin_url( '?welcome=0' ) ); ?>"><?php _e( 'Dismiss' ); ?></a>
 		<?php
 		/**
-		 * Add content to the welcome panel on the admin dashboard
+		 * Add content to the welcome panel on the admin dashboard.
 		 * 
 		 * To remove the default welcome panel, use remove_action():
 		 * <code>remove_action( 'welcome_panel', 'wp_welcome_panel' );</code>

wp-comments-post.php

@@ -23,7 +23,7 @@ $post = get_post($comment_post_ID);
 
 if ( empty( $post->comment_status ) ) {
 	/**
-	 * Fires when a comment is attempted on a post that does not exist
+	 * Fires when a comment is attempted on a post that does not exist.
 	 *
 	 * @since unknown
 	 * @param int $comment_post_ID Post ID.
@@ -39,7 +39,7 @@ $status_obj = get_post_status_object($status);
 
 if ( ! comments_open( $comment_post_ID ) ) {
 	/**
-	 * Fires when a comment is attempted on a post that has comments closed
+	 * Fires when a comment is attempted on a post that has comments closed.
 	 *
 	 * @since unknown
 	 * @param int $comment_post_ID Post ID.
@@ -48,7 +48,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	wp_die( __('Sorry, comments are closed for this item.') );
 } elseif ( 'trash' == $status ) {
 	/**
-	 * Fires when a comment is attempted on a trashed post
+	 * Fires when a comment is attempted on a trashed post.
 	 *
 	 * @since 2.9.0
 	 * @param int $comment_post_ID Post ID.
@@ -57,7 +57,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	exit;
 } elseif ( ! $status_obj->public && ! $status_obj->private ) {
 	/**
-	 * Fires when a comment is attempted on a post in draft mode
+	 * Fires when a comment is attempted on a post in draft mode.
 	 *
 	 * @since unknown
 	 * @param int $comment_post_ID Post ID.
@@ -66,7 +66,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	exit;
 } elseif ( post_password_required( $comment_post_ID ) ) {
 	/**
-	 * Fires when a comment is attempted on a password-protected post
+	 * Fires when a comment is attempted on a password-protected post.
 	 *
 	 * @since unknown
 	 * @param int $comment_post_ID Post ID.
@@ -75,7 +75,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	exit;
 } else {
 	/**
-	 * Fires before a comment is posted
+	 * Fires before a comment is posted.
 	 *
 	 * @since unknown
 	 * @param int $comment_post_ID Post ID.
@@ -129,7 +129,7 @@ $comment_id = wp_new_comment( $commentdata );
 $comment = get_comment($comment_id);
 
 /**
- * Perform other actions when comment cookies are set
+ * Perform other actions when comment cookies are set.
  *
  * @since 3.4.0
  *
@@ -141,7 +141,7 @@ do_action( 'set_comment_cookies', $comment, $user );
 $location = empty($_POST['redirect_to']) ? get_comment_link($comment_id) : $_POST['redirect_to'] . '#comment-' . $comment_id;
 
 /**
- * The location URI to send commenter after posting
+ * The location URI to send commenter after posting.
  *
  * @since unknown
  *

wp-includes/pluggable.php

@@ -865,7 +865,7 @@ function wp_redirect($location, $status = 302) {
 	global $is_IIS;
 
 	/**
-	 * Filter the redirect location
+	 * Filter the redirect location.
 	 *
 	 * @since 2.1.0
 	 *
@@ -875,7 +875,7 @@ function wp_redirect($location, $status = 302) {
 	$location = apply_filters( 'wp_redirect', $location, $status );
 
 	/**
-	 * Filter the redirect status code
+	 * Filter the redirect status code.
 	 *
 	 * @since 2.3.0
 	 *

wp-trackback.php

@@ -107,7 +107,7 @@ if ( !empty($tb_url) && !empty($title) ) {
 	$trackback_id = $wpdb->insert_id;
 
 	/**
-	 * Fires after a trackback is added to a post
+	 * Fires after a trackback is added to a post.
 	 *
 	 * @since 1.2.0
 	 * @param int $trackback_id Trackback ID.