Docs: Consistently include an empty line between @since tag and @see, @link, or @global, per the documentation standards.

See #49572.

git-svn-id: https://develop.svn.wordpress.org/trunk@48067 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov
2020-06-16 21:05:20 +00:00
parent 9f11a8414f
commit 3bdf8b7b02
42 changed files with 113 additions and 27 deletions

View File

@@ -445,6 +445,7 @@ function get_comment_count( $post_id = 0 ) {
* Add meta data field to a comment.
*
* @since 2.9.0
*
* @link https://developer.wordpress.org/reference/functions/add_comment_meta/
*
* @param int $comment_id Comment ID.
@@ -466,6 +467,7 @@ function add_comment_meta( $comment_id, $meta_key, $meta_value, $unique = false
* allows removing all metadata matching key, if needed.
*
* @since 2.9.0
*
* @link https://developer.wordpress.org/reference/functions/delete_comment_meta/
*
* @param int $comment_id Comment ID.
@@ -483,6 +485,7 @@ function delete_comment_meta( $comment_id, $meta_key, $meta_value = '' ) {
* Retrieve comment meta field for a comment.
*
* @since 2.9.0
*
* @link https://developer.wordpress.org/reference/functions/get_comment_meta/
*
* @param int $comment_id Comment ID.
@@ -507,6 +510,7 @@ function get_comment_meta( $comment_id, $key = '', $single = false ) {
* If the meta field for the comment does not exist, it will be added.
*
* @since 2.9.0
*
* @link https://developer.wordpress.org/reference/functions/update_comment_meta/
*
* @param int $comment_id Comment ID.
@@ -2449,6 +2453,7 @@ function wp_update_comment( $commentarr ) {
* updated without having to call wp_update_comment_count() after.
*
* @since 2.5.0
*
* @staticvar bool $_defer
*
* @param bool $defer
@@ -2480,6 +2485,7 @@ function wp_defer_comment_counting( $defer = null ) {
* IDs will be updated along with the current $post_id.
*
* @since 2.1.0
*
* @see wp_update_comment_count_now() For what could cause a false return value
*
* @staticvar array $_deferred
@@ -3013,6 +3019,7 @@ function weblog_ping( $server = '', $path = '' ) {
* Default filter attached to pingback_ping_source_uri to validate the pingback's Source URI
*
* @since 3.5.1
*
* @see wp_http_validate_url()
*
* @param string $source_uri
@@ -3029,6 +3036,7 @@ function pingback_ping_source_uri( $source_uri ) {
* which reports that the pingback is already registered.
*
* @since 3.5.1
*
* @link https://www.hixie.ch/specs/pingback/pingback#TOC3
*
* @param IXR_Error $ixr_error
@@ -3127,8 +3135,8 @@ function _prime_comment_caches( $comment_ids, $update_meta_cache = true ) {
/**
* Close comments on old posts on the fly, without any extra DB queries. Hooked to the_posts.
*
* @access private
* @since 2.7.0
* @access private
*
* @param WP_Post $posts Post data object.
* @param WP_Query $query Query object.
@@ -3167,8 +3175,8 @@ function _close_comments_for_old_posts( $posts, $query ) {
/**
* Close comments on an old post. Hooked to comments_open and pings_open.
*
* @access private
* @since 2.7.0
* @access private
*
* @param bool $open Comments open or closed
* @param int $post_id Post ID