From 9c68816a212961f09f8a5b13f1a1f930820a58c8 Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov.ru@gmail.com>
Date: Tue, 24 Dec 2019 16:10:05 +0000
Subject: [PATCH] Docs: Improve documentation for `get_comment_author_url()`.

Props stevenlinx.
Fixes #49076.
Built from https://develop.svn.wordpress.org/trunk@47008


git-svn-id: http://core.svn.wordpress.org/trunk@46808 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/comment-template.php | 14 +++++++-------
 wp-includes/version.php          |  2 +-
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/wp-includes/comment-template.php b/wp-includes/comment-template.php
index 2ed2a32cd3..4d27e48225 100644
--- a/wp-includes/comment-template.php
+++ b/wp-includes/comment-template.php
@@ -242,7 +242,7 @@ function get_comment_author_link( $comment_ID = 0 ) {
 }
 
 /**
- * Display the html link to the url of the author of the current comment.
+ * Display the HTML link to the URL of the author of the current comment.
  *
  * @since 0.71
  * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@@ -294,14 +294,14 @@ function comment_author_IP( $comment_ID = 0 ) { // phpcs:ignore WordPress.Naming
 }
 
 /**
- * Retrieve the url of the author of the current comment.
+ * Retrieves the URL of the author of the current comment, not linked.
  *
  * @since 1.5.0
  * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
  *
  * @param int|WP_Comment $comment_ID Optional. WP_Comment or the ID of the comment for which to get the author's URL.
  *                                   Default current comment.
- * @return string Comment author URL.
+ * @return string Comment author URL, if provided, an empty string otherwise.
  */
 function get_comment_author_url( $comment_ID = 0 ) {
 	$comment = get_comment( $comment_ID );
@@ -327,7 +327,7 @@ function get_comment_author_url( $comment_ID = 0 ) {
 }
 
 /**
- * Display the url of the author of the current comment.
+ * Displays the URL of the author of the current comment, not linked.
  *
  * @since 0.71
  * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@@ -352,7 +352,7 @@ function comment_author_url( $comment_ID = 0 ) {
 }
 
 /**
- * Retrieves the HTML link of the url of the author of the current comment.
+ * Retrieves the HTML link of the URL of the author of the current comment.
  *
  * $linktext parameter is only used if the URL does not exist for the comment
  * author. If the URL does exist then the URL will be used and the $linktext
@@ -397,7 +397,7 @@ function get_comment_author_url_link( $linktext = '', $before = '', $after = '',
 }
 
 /**
- * Displays the HTML link of the url of the author of the current comment.
+ * Displays the HTML link of the URL of the author of the current comment.
  *
  * @since 0.71
  * @since 4.6.0 Added the `$comment` parameter.
@@ -1349,7 +1349,7 @@ function comments_template( $file = '/comments.php', $separate_comments = false
 	$comment_author_email = $commenter['comment_author_email'];
 
 	/*
-	 * The url of the current comment author escaped for use in attributes.
+	 * The URL of the current comment author escaped for use in attributes.
 	 */
 	$comment_author_url = esc_url( $commenter['comment_author_url'] );
 
diff --git a/wp-includes/version.php b/wp-includes/version.php
index b2e031517d..a72c2163e9 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.4-alpha-47007';
+$wp_version = '5.4-alpha-47008';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.