Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-12-31 13:37:51 +01:00
Code Issues Projects Releases Wiki Activity

Docs: Use a third-person singular verb for comment template function descriptions, per the documentation standards.

Browse Source 
See #48303.
Built from https://develop.svn.wordpress.org/trunk@47009


git-svn-id: http://core.svn.wordpress.org/trunk@46809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2019-12-24 16:19:01 +00:00
parent 9c68816a21
commit 8073fd3ec0
2 changed files with 37 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
wp-includes/comment-template.php
View File

@ -9,7 +9,7 @@
*/
/**
* Retrieve the author of the current comment.
* Retrieves the author of the current comment.
*
* If the comment has an empty comment_author field, then 'Anonymous' person is
* assumed.
@ -74,7 +74,7 @@ function comment_author( $comment_ID = 0 ) {
}
/**
* Retrieve the email of the author of the current comment.
* Retrieves the email of the author of the current comment.
*
* @since 1.5.0
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -100,7 +100,7 @@ function get_comment_author_email( $comment_ID = 0 ) {
}
/**
* Display the email of the author of the current global $comment.
* Displays the email of the author of the current global $comment.
*
* Care should be taken to protect the email address and assure that email
* harvesters do not capture your commenter's email address. Most assume that
@ -131,7 +131,7 @@ function comment_author_email( $comment_ID = 0 ) {
}
/**
* Display the html email link to the author of the current comment.
* Displays the HTML email link to the author of the current comment.
*
* Care should be taken to protect the email address and assure that email
* harvesters do not capture your commenter's email address. Most assume that
@ -156,7 +156,7 @@ function comment_author_email_link( $linktext = '', $before = '', $after = '', $
}
/**
* Return the html email link to the author of the current comment.
* Returns the HTML email link to the author of the current comment.
*
* Care should be taken to protect the email address and assure that email
* harvesters do not capture your commenter's email address. Most assume that
@ -204,7 +204,7 @@ function get_comment_author_email_link( $linktext = '', $before = '', $after = '
}
/**
* Retrieve the HTML link to the URL of the author of the current comment.
* Retrieves the HTML link to the URL of the author of the current comment.
*
* Both get_comment_author_url() and get_comment_author() rely on get_comment(),
* which falls back to the global comment variable if the $comment_ID argument is empty.
@ -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.
* Displays 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.
@ -281,7 +281,7 @@ function get_comment_author_IP( $comment_ID = 0 ) { // phpcs:ignore WordPress.Na
}
/**
* Display the IP address of the author of the current comment.
* Displays the IP address 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.
@ -537,7 +537,7 @@ function get_comment_class( $class = '', $comment_id = null, $post_id = null ) {
}
/**
* Retrieve the comment date of the current comment.
* Retrieves the comment date of the current comment.
*
* @since 1.5.0
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -567,7 +567,7 @@ function get_comment_date( $d = '', $comment_ID = 0 ) {
}
/**
* Display the comment date of the current comment.
* Displays the comment date of the current comment.
*
* @since 0.71
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -624,7 +624,7 @@ function get_comment_excerpt( $comment_ID = 0 ) {
}
/**
* Display the excerpt of the current comment.
* Displays the excerpt of the current comment.
*
* @since 1.2.0
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -649,7 +649,7 @@ function comment_excerpt( $comment_ID = 0 ) {
}
/**
* Retrieve the comment id of the current comment.
* Retrieves the comment id of the current comment.
*
* @since 1.5.0
*
@ -671,7 +671,7 @@ function get_comment_ID() { // phpcs:ignore WordPress.NamingConventions.ValidFun
}
/**
* Display the comment id of the current comment.
* Displays the comment id of the current comment.
*
* @since 0.71
*/
@ -680,7 +680,7 @@ function comment_ID() { // phpcs:ignore WordPress.NamingConventions.ValidFunctio
}
/**
* Retrieve the link to a given comment.
* Retrieves the link to a given comment.
*
* @since 1.5.0
* @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object. Added `$cpage` argument.
@ -818,7 +818,7 @@ function get_comments_link( $post_id = 0 ) {
}
/**
* Display the link to the current post comments.
* Displays the link to the current post comments.
*
* @since 0.71
*
@ -866,7 +866,7 @@ function get_comments_number( $post_id = 0 ) {
}
/**
* Display the language string for the number of comments the current post has.
* Displays the language string for the number of comments the current post has.
*
* @since 0.71
*
@ -883,7 +883,7 @@ function comments_number( $zero = false, $one = false, $more = false, $deprecate
}
/**
* Display the language string for the number of comments the current post has.
* Displays the language string for the number of comments the current post has.
*
* @since 4.0.0
*
@ -944,7 +944,7 @@ function get_comments_number_text( $zero = false, $one = false, $more = false )
}
/**
* Retrieve the text of the current comment.
* Retrieves the text of the current comment.
*
* @since 1.5.0
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -974,7 +974,7 @@ function get_comment_text( $comment_ID = 0, $args = array() ) {
}
/**
* Display the text of the current comment.
* Displays the text of the current comment.
*
* @since 0.71
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -1004,7 +1004,7 @@ function comment_text( $comment_ID = 0, $args = array() ) {
}
/**
* Retrieve the comment time of the current comment.
* Retrieves the comment time of the current comment.
*
* @since 1.5.0
*
@ -1039,7 +1039,7 @@ function get_comment_time( $d = '', $gmt = false, $translate = true ) {
}
/**
* Display the comment time of the current comment.
* Displays the comment time of the current comment.
*
* @since 0.71
*
@ -1050,7 +1050,7 @@ function comment_time( $d = '' ) {
}
/**
* Retrieve the comment type of the current comment.
* Retrieves the comment type of the current comment.
*
* @since 1.5.0
* @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
@ -1079,7 +1079,7 @@ function get_comment_type( $comment_ID = 0 ) {
}
/**
* Display the comment type of the current comment.
* Displays the comment type of the current comment.
*
* @since 0.71
*
@ -1111,7 +1111,7 @@ function comment_type( $commenttxt = false, $trackbacktxt = false, $pingbacktxt
}
/**
* Retrieve The current post's trackback URL.
* Retrieves the current post's trackback URL.
*
* There is a check to see if permalink's have been enabled and if so, will
* retrieve the pretty path. If permalinks weren't enabled, the ID of the
@ -1139,7 +1139,7 @@ function get_trackback_url() {
}
/**
* Display the current post's trackback URL.
* Displays the current post's trackback URL.
*
* @since 0.71
*
@ -1168,7 +1168,7 @@ function trackback_url( $deprecated_echo = true ) {
}
/**
* Generate and display the RDF for the trackback information of current post.
* Generates and displays the RDF for the trackback information of current post.
*
* Deprecated in 3.0.0, and restored in 3.0.1.
*
@ -1260,7 +1260,7 @@ function pings_open( $post_id = null ) {
}
/**
* Display form token for unfiltered comments.
* Displays form token for unfiltered comments.
*
* Will only display nonce token if the current user has permissions for
* unfiltered html. Won't display the token for other users.
@ -1284,7 +1284,7 @@ function wp_comment_form_unfiltered_html_nonce() {
}
/**
* Load the comment template specified in $file.
* Loads the comment template specified in $file.
*
* Will not display the comments template if not on single post or page, or if
* the post does not have comments.
@ -1597,7 +1597,7 @@ function comments_popup_link( $zero = false, $one = false, $more = false, $css_c
}
/**
* Retrieve HTML content for reply to comment link.
* Retrieves HTML content for reply to comment link.
*
* @since 2.7.0
* @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object.
@ -1742,7 +1742,7 @@ function comment_reply_link( $args = array(), $comment = null, $post = null ) {
}
/**
* Retrieve HTML content for reply to post link.
* Retrieves HTML content for reply to post link.
*
* @since 2.7.0
*
@ -1832,7 +1832,7 @@ function post_reply_link( $args = array(), $post = null ) {
}
/**
* Retrieve HTML content for cancel comment reply link.
* Retrieves HTML content for cancel comment reply link.
*
* @since 2.7.0
*
@ -1862,7 +1862,7 @@ function get_cancel_comment_reply_link( $text = '' ) {
}
/**
* Display HTML content for cancel comment reply link.
* Displays HTML content for cancel comment reply link.
*
* @since 2.7.0
*
@ -1873,7 +1873,7 @@ function cancel_comment_reply_link( $text = '' ) {
}
/**
* Retrieve hidden input HTML for replying to comments.
* Retrieves hidden input HTML for replying to comments.
*
* @since 3.0.0
*
@ -1902,7 +1902,7 @@ function get_comment_id_fields( $id = 0 ) {
}
/**
* Output hidden input HTML for replying to comments.
* Outputs hidden input HTML for replying to comments.
*
* @since 2.7.0
*
@ -1913,7 +1913,7 @@ function comment_id_fields( $id = 0 ) {
}
/**
* Display text based on comment reply status.
* Displays text based on comment reply status.
*
* Only affects users with JavaScript disabled.
*
@ -1956,7 +1956,7 @@ function comment_form_title( $noreplytext = false, $replytext = false, $linktopa
}
/**
* List comments.
* Displays a list of comments.
*
* Used in the comments.php template to list comments for a particular post.
*

2
wp-includes/version.php
View File

@ -13,7 +13,7 @@
*
* @global string $wp_version
*/
$wp_version = '5.4-alpha-47008';
$wp_version = '5.4-alpha-47009';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.