From e5ec034d8f427f31ed286e37df1d0bfd1c2df6e0 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Tue, 20 Oct 2015 18:09:06 +0000
Subject: [PATCH] Docs: Improve vague changelog entries for functions and hooks
 where arguments were deprecated in [35294].

See #31078. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35297 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/feed.php | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/src/wp-includes/feed.php b/src/wp-includes/feed.php
index 8b2e88c35d..7d585f1136 100644
--- a/src/wp-includes/feed.php
+++ b/src/wp-includes/feed.php
@@ -91,9 +91,9 @@ function get_default_feed() {
  * Retrieve the blog title for the feed title.
  *
  * @since 2.2.0
- * @since 4.4.0 Deprecated argument.
+ * @since 4.4.0 The optional `$sep` parameter was deprecated and renamed to `$deprecated`.
  *
- * @param string $deprecated Deprecated.
+ * @param string $deprecated Unused..
  * @return string The document title.
  */
 function get_wp_title_rss( $deprecated = '&#8211;' ) {
@@ -105,10 +105,10 @@ function get_wp_title_rss( $deprecated = '&#8211;' ) {
 	 * Filter the blog title for use as the feed title.
 	 *
 	 * @since 2.2.0
-	 * @since 4.4.0 Deprecated argument.
+	 * @since 4.4.0 The `$sep` parameter was deprecated and renamed to `$deprecated`.
 	 *
 	 * @param string $title      The current blog title.
-	 * @param string $deprecated Deprecated.
+	 * @param string $deprecated Unused.
 	 */
 	return apply_filters( 'get_wp_title_rss', wp_get_document_title(), $deprecated );
 }
@@ -117,9 +117,9 @@ function get_wp_title_rss( $deprecated = '&#8211;' ) {
  * Display the blog title for display of the feed title.
  *
  * @since 2.2.0
- * @since 4.4.0 Deprecated argument.
+ * @since 4.4.0 The optional `$sep` parameter was deprecated and renamed to `$deprecated`.
  *
- * @param string $deprecated Optional.
+ * @param string $deprecated Unused.
  */
 function wp_title_rss( $deprecated = '&#8211;' ) {
 	if ( '&#8211;' !== $deprecated ) {
@@ -130,12 +130,12 @@ function wp_title_rss( $deprecated = '&#8211;' ) {
 	 * Filter the blog title for display of the feed title.
 	 *
 	 * @since 2.2.0
-	 * @since 4.4.0 Deprecated argument.
+	 * @since 4.4.0 The `$sep` parameter was deprecated and renamed to `$deprecated`.
 	 *
 	 * @see get_wp_title_rss()
 	 *
 	 * @param string $wp_title_rss The current blog title.
-	 * @param string $deprecated   Deprecated.
+	 * @param string $deprecated   Unused.
 	 */
 	echo apply_filters( 'wp_title_rss', get_wp_title_rss(), $deprecated );
 }
@@ -149,6 +149,7 @@ function wp_title_rss( $deprecated = '&#8211;' ) {
  */
 function get_the_title_rss() {
 	$title = get_the_title();
+
 	/**
 	 * Filter the post title for use in a feed.
 	 *