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

src/wp-admin/comment.php

@@ -36,10 +36,10 @@ if ( isset( $_GET['dt'] ) ) {
 	}
 }
 
-// Prevent actions on a comment associated with a trashed post.
 $comment_id = absint( $_GET['c'] );
 $comment    = get_comment( $comment_id );
 
+// Prevent actions on a comment associated with a trashed post.
 if ( 'trash' === get_post_status( $comment->comment_post_ID ) ) {
 	wp_die(
 		__( 'You can’t edit this comment because the associated post is in the Trash. Please restore the post first, then try again.' )

src/wp-admin/includes/ajax-actions.php

@@ -421,8 +421,8 @@ function wp_ajax_logged_in() {
  *
  * Contrary to normal success Ajax response ("1"), die with time() on success.
  *
- * @access private
  * @since 2.7.0
+ * @access private
  *
  * @param int $comment_id
  * @param int $delta
@@ -554,8 +554,8 @@ function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
 /**
  * Ajax handler for adding a hierarchical term.
  *
- * @access private
  * @since 3.1.0
+ * @access private
  */
 function _wp_ajax_add_hierarchical_term() {
 	$action   = $_POST['action'];
@@ -4668,6 +4668,7 @@ function wp_ajax_search_install_plugins() {
  * Ajax handler for editing a theme or plugin file.
  *
  * @since 4.9.0
+ *
  * @see wp_edit_theme_plugin_file()
  */
 function wp_ajax_edit_theme_plugin_file() {

src/wp-admin/includes/file.php

@@ -1468,9 +1468,10 @@ function unzip_file( $file, $to ) {
  * Assumes that WP_Filesystem() has already been called and set up.
  *
  * @since 3.0.0
- * @see unzip_file()
  * @access private
  *
+ * @see unzip_file()
+ *
  * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass.
  *
  * @param string   $file        Full path and filename of ZIP archive.
@@ -1599,9 +1600,10 @@ function _unzip_file_ziparchive( $file, $to, $needed_dirs = array() ) {
  * Assumes that WP_Filesystem() has already been called and set up.
  *
  * @since 3.0.0
- * @see unzip_file()
  * @access private
  *
+ * @see unzip_file()
+ *
  * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass.
  *
  * @param string   $file        Full path and filename of ZIP archive.

src/wp-admin/includes/plugin.php

@@ -542,6 +542,7 @@ function is_plugin_active( $plugin ) {
  * Conditional Tags} article in the Theme Developer Handbook.
  *
  * @since 3.1.0
+ *
  * @see is_plugin_active()
  *
  * @param string $plugin Path to the plugin file relative to the plugins directory.

src/wp-admin/includes/theme.php

@@ -146,6 +146,7 @@ function _get_template_edit_filename( $fullpath, $containingfolder ) {
  * Will display link, if there is an update available.
  *
  * @since 2.7.0
+ *
  * @see get_theme_update_available()
  *
  * @param WP_Theme $theme Theme data object.

src/wp-admin/includes/update-core.php

@@ -11,6 +11,7 @@
  * Stores files to be deleted.
  *
  * @since 2.7.0
+ *
  * @global array $_old_files
  * @var array
  * @name $_old_files
@@ -1314,14 +1315,16 @@ function update_core( $from, $to ) {
 
 /**
  * Copies a directory from one location to another via the WordPress Filesystem Abstraction.
+ *
  * Assumes that WP_Filesystem() has already been called and setup.
  *
- * This is a temporary function for the 3.1 -> 3.2 upgrade, as well as for those upgrading to
- * 3.7+
+ * This is a temporary function for the 3.1 -> 3.2 upgrade, as well as for those
+ * upgrading to 3.7+.
  *
  * @ignore
  * @since 3.2.0
- * @since 3.7.0 Updated not to use a regular expression for the skip list
+ * @since 3.7.0 Updated not to use a regular expression for the skip list.
+ *
  * @see copy_dir()
  *
  * @global WP_Filesystem_Base $wp_filesystem