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
2020-06-16 21:05:20 +00:00 · 2020-06-16 21:05:20 +00:00 · 3bdf8b7b02
commit 3bdf8b7b02
parent 9f11a8414f
42 changed files with 113 additions and 27 deletions
--- a/src/wp-admin/comment.php
+++ b/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&#8217;t edit this comment because the associated post is in the Trash. Please restore the post first, then try again.' )
--- a/src/wp-admin/includes/ajax-actions.php
+++ b/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() {
--- a/src/wp-admin/includes/file.php
+++ b/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.
--- a/src/wp-admin/includes/plugin.php
+++ b/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.
--- a/src/wp-admin/includes/theme.php
+++ b/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.
--- a/src/wp-admin/includes/update-core.php
+++ b/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
--- a/src/wp-content/themes/twentyeleven/inc/theme-options.php
+++ b/src/wp-content/themes/twentyeleven/inc/theme-options.php
@ -644,6 +644,7 @@ add_action( 'customize_register', 'twentyeleven_customize_register' );
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Eleven 2.4
+ *
 * @see twentyeleven_customize_register()
 *
 * @return void
@ -656,6 +657,7 @@ function twentyeleven_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Eleven 2.4
+ *
 * @see twentyeleven_customize_register()
 *
 * @return void
--- a/src/wp-content/themes/twentyfifteen/inc/customizer.php
+++ b/src/wp-content/themes/twentyfifteen/inc/customizer.php
@ -116,6 +116,7 @@ add_action( 'customize_register', 'twentyfifteen_customize_register', 11 );
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Fifteen 1.5
+ *
 * @see twentyfifteen_customize_register()
 *
 * @return void
@ -128,6 +129,7 @@ function twentyfifteen_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Fifteen 1.5
+ *
 * @see twentyfifteen_customize_register()
 *
 * @return void
--- a/src/wp-content/themes/twentyfourteen/inc/customizer.php
+++ b/src/wp-content/themes/twentyfourteen/inc/customizer.php
@ -98,6 +98,7 @@ add_action( 'customize_register', 'twentyfourteen_customize_register' );
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Fourteen 1.7
+ *
 * @see twentyfourteen_customize_register()
 *
 * @return void
@ -110,6 +111,7 @@ function twentyfourteen_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Fourteen 1.7
+ *
 * @see twentyfourteen_customize_register()
 *
 * @return void
--- a/src/wp-content/themes/twentyseventeen/functions.php
+++ b/src/wp-content/themes/twentyseventeen/functions.php
@ -625,6 +625,7 @@ add_filter( 'widget_tag_cloud_args', 'twentyseventeen_widget_tag_cloud_args' );
 * but it is unique across the life of the PHP process.
 *
 * @since Twenty Seventeen 2.0
+ *
 * @see wp_unique_id() Themes requiring WordPress 5.0.3 and greater should use this instead.
 *
 * @staticvar int $id_counter
--- a/src/wp-content/themes/twentyseventeen/inc/customizer.php
+++ b/src/wp-content/themes/twentyseventeen/inc/customizer.php
@ -197,6 +197,7 @@ function twentyseventeen_sanitize_colorscheme( $input ) {
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Seventeen 1.0
+ *
 * @see twentyseventeen_customize_register()
 *
 * @return void
@ -209,6 +210,7 @@ function twentyseventeen_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Seventeen 1.0
+ *
 * @see twentyseventeen_customize_register()
 *
 * @return void
--- a/src/wp-content/themes/twentysixteen/inc/customizer.php
+++ b/src/wp-content/themes/twentysixteen/inc/customizer.php
@ -251,6 +251,7 @@ add_action( 'customize_register', 'twentysixteen_customize_register', 11 );
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Sixteen 1.2
+ *
 * @see twentysixteen_customize_register()
 *
 * @return void
@ -263,6 +264,7 @@ function twentysixteen_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Sixteen 1.2
+ *
 * @see twentysixteen_customize_register()
 *
 * @return void
--- a/src/wp-content/themes/twentythirteen/functions.php
+++ b/src/wp-content/themes/twentythirteen/functions.php
@ -734,6 +734,7 @@ add_action( 'customize_register', 'twentythirteen_customize_register' );
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Thirteen 1.9
+ *
 * @see twentythirteen_customize_register()
 *
 * @return void
@ -746,6 +747,7 @@ function twentythirteen_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Thirteen 1.9
+ *
 * @see twentythirteen_customize_register()
 *
 * @return void
--- a/src/wp-content/themes/twentytwelve/functions.php
+++ b/src/wp-content/themes/twentytwelve/functions.php
@ -651,6 +651,7 @@ add_action( 'customize_register', 'twentytwelve_customize_register' );
 * Render the site title for the selective refresh partial.
 *
 * @since Twenty Twelve 2.0
+ *
 * @see twentytwelve_customize_register()
 *
 * @return void
@ -663,6 +664,7 @@ function twentytwelve_customize_partial_blogname() {
 * Render the site tagline for the selective refresh partial.
 *
 * @since Twenty Twelve 2.0
+ *
 * @see twentytwelve_customize_register()
 *
 * @return void
--- a/src/wp-includes/author-template.php
+++ b/src/wp-includes/author-template.php
@ -49,6 +49,7 @@ function get_the_author( $deprecated = '' ) {
 * return it. However, backward compatibility has to be maintained.
 *
 * @since 0.71
+ *
 * @see get_the_author()
 * @link https://developer.wordpress.org/reference/functions/the_author/
 *
--- a/src/wp-includes/blocks.php
+++ b/src/wp-includes/blocks.php
@ -48,6 +48,7 @@ function unregister_block_type( $name ) {
 * you should use the block parser on post content.
 *
 * @since 5.0.0
+ *
 * @see parse_blocks()
 *
 * @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post.
@ -72,6 +73,7 @@ function has_blocks( $post = null ) {
 * you should use the block parser on post content.
 *
 * @since 5.0.0
+ *
 * @see parse_blocks()
 *
 * @param string                  $block_name Full Block type to look for.
--- a/src/wp-includes/category-template.php
+++ b/src/wp-includes/category-template.php
@ -11,6 +11,7 @@
 * Retrieves category link URL.
 *
 * @since 1.0.0
+ *
 * @see get_term_link()
 *
 * @param int|object $category Category ID or object.
@ -1117,6 +1118,7 @@ function walk_category_dropdown_tree( ...$args ) {
 * Retrieves the link to the tag.
 *
 * @since 2.3.0
+ *
 * @see get_term_link()
 *
 * @param int|object $tag Tag ID or object.
--- a/src/wp-includes/category.php
+++ b/src/wp-includes/category.php
@ -13,6 +13,7 @@
 * will be returned instead.
 *
 * @since 2.1.0
+ *
 * @see get_terms() Type of arguments that can be changed.
 *
 * @param string|array $args {
--- a/src/wp-includes/class-http.php
+++ b/src/wp-includes/class-http.php
@ -847,6 +847,7 @@ class WP_Http {
 	 * are supported, eg `*.wordpress.org` will allow for all subdomains of `wordpress.org` to be contacted.
 	 *
 	 * @since 2.8.0
+	 *
 	 * @link https://core.trac.wordpress.org/ticket/8927 Allow preventing external requests.
 	 * @link https://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_ACCESSIBLE_HOSTS
 	 *
--- a/src/wp-includes/class-wp-ajax-response.php
+++ b/src/wp-includes/class-wp-ajax-response.php
@ -18,6 +18,7 @@ class WP_Ajax_Response {
 	 * Constructor - Passes args to WP_Ajax_Response::add().
 	 *
 	 * @since 2.1.0
+	 *
 	 * @see WP_Ajax_Response::add()
 	 *
 	 * @param string|array $args Optional. Will be passed to add() method.
--- a/src/wp-includes/class-wp-customize-manager.php
+++ b/src/wp-includes/class-wp-customize-manager.php
@ -606,6 +606,7 @@ final class WP_Customize_Manager {
 	 * enabled, then a new UUID will be generated.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @global string $pagenow
 	 */
 	public function establish_loaded_changeset() {
@ -737,6 +738,7 @@ final class WP_Customize_Manager {
 	 * Gets whether settings are or will be previewed.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @see WP_Customize_Setting::preview()
 	 *
 	 * @return bool
@ -749,6 +751,7 @@ final class WP_Customize_Manager {
 	 * Gets whether data from a changeset's autosaved revision should be loaded if it exists.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @see WP_Customize_Manager::changeset_data()
 	 *
 	 * @return bool Is using autosaved changeset revision.
@ -761,6 +764,7 @@ final class WP_Customize_Manager {
 	 * Whether the changeset branching is allowed.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @see WP_Customize_Manager::establish_loaded_changeset()
 	 *
 	 * @return bool Is changeset branching.
@ -801,6 +805,7 @@ final class WP_Customize_Manager {
 	 * Get the changeset UUID.
 	 *
 	 * @since 4.7.0
+	 *
 	 * @see WP_Customize_Manager::establish_loaded_changeset()
 	 *
 	 * @return string UUID.
@ -1946,6 +1951,7 @@ final class WP_Customize_Manager {
 	 * Add customize state query params to a given URL if preview is allowed.
 	 *
 	 * @since 4.7.0
+	 *
 	 * @see wp_redirect()
 	 * @see WP_Customize_Manager::get_allowed_url()
 	 *
@ -3030,8 +3036,9 @@ final class WP_Customize_Manager {
 	 * untouched.
 	 *
 	 * @since 4.9.0
-	 * @global wpdb $wpdb WordPress database abstraction object.
+	 *
 	 * @see wp_trash_post()
+	 * @global wpdb $wpdb WordPress database abstraction object.
 	 *
 	 * @param int|WP_Post $post The changeset post.
 	 * @return mixed A WP_Post object for the trashed post or an empty value on failure.
@ -3179,6 +3186,7 @@ final class WP_Customize_Manager {
 	 * This should be able to be removed once #40922 is addressed in core.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @link https://core.trac.wordpress.org/ticket/40922
 	 * @see WP_Customize_Manager::save_changeset_post()
 	 * @see _wp_translate_postdata()
@ -3407,6 +3415,7 @@ final class WP_Customize_Manager {
 	 * invoking this method.
 	 *
 	 * @since 4.7.0
+	 *
 	 * @see _wp_customize_publish_changeset()
 	 * @global wpdb $wpdb WordPress database abstraction object.
 	 *
--- a/src/wp-includes/class-wp-customize-nav-menus.php
+++ b/src/wp-includes/class-wp-customize-nav-menus.php
@ -1409,6 +1409,7 @@ final class WP_Customize_Nav_Menus {
 	 * Keep track of the arguments that are being passed to wp_nav_menu().
 	 *
 	 * @since 4.3.0
+	 *
 	 * @see wp_nav_menu()
 	 * @see WP_Customize_Widgets::filter_dynamic_sidebar_params()
 	 *
--- a/src/wp-includes/class-wp-customize-setting.php
+++ b/src/wp-includes/class-wp-customize-setting.php
@ -13,9 +13,9 @@
 * Handles saving and sanitizing of settings.
 *
 * @since 3.4.0
- * @link https://developer.wordpress.org/themes/customize-api
 *
 * @see WP_Customize_Manager
+ * @link https://developer.wordpress.org/themes/customize-api
 */
 class WP_Customize_Setting {
 	/**
--- a/src/wp-includes/class-wp-http-encoding.php
+++ b/src/wp-includes/class-wp-http-encoding.php
@ -91,6 +91,7 @@ class WP_Http_Encoding {
 	 * https://core.trac.wordpress.org/ticket/18273
 	 *
 	 * @since 2.8.1
+	 *
 	 * @link https://core.trac.wordpress.org/ticket/18273
 	 * @link https://www.php.net/manual/en/function.gzinflate.php#70875
 	 * @link https://www.php.net/manual/en/function.gzinflate.php#77336
--- a/src/wp-includes/class-wp-query.php
+++ b/src/wp-includes/class-wp-query.php
@ -3378,6 +3378,7 @@ class WP_Query {
 	 * Sets up the current comment.
 	 *
 	 * @since 2.2.0
+	 *
 	 * @global WP_Comment $comment Global comment object.
 	 */
 	public function the_comment() {
--- a/src/wp-includes/comment.php
+++ b/src/wp-includes/comment.php
@ -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
--- a/src/wp-includes/customize/class-wp-customize-code-editor-control.php
+++ b/src/wp-includes/customize/class-wp-customize-code-editor-control.php
@ -65,6 +65,7 @@ class WP_Customize_Code_Editor_Control extends WP_Customize_Control {
 	 * Refresh the parameters passed to the JavaScript via JSON.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @see WP_Customize_Control::json()
 	 *
 	 * @return array Array of parameters passed to the JavaScript.
--- a/src/wp-includes/customize/class-wp-customize-custom-css-setting.php
+++ b/src/wp-includes/customize/class-wp-customize-custom-css-setting.php
@ -95,6 +95,7 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
 	 * This is used in the preview when `wp_get_custom_css()` is called for rendering the styles.
 	 *
 	 * @since 4.7.0
+	 *
 	 * @see wp_get_custom_css()
 	 *
 	 * @param string $css        Original CSS.
@ -115,6 +116,7 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
 	 * Fetch the value of the setting. Will return the previewed value when `preview()` is called.
 	 *
 	 * @since 4.7.0
+	 *
 	 * @see WP_Customize_Setting::value()
 	 *
 	 * @return string
--- a/src/wp-includes/customize/class-wp-customize-date-time-control.php
+++ b/src/wp-includes/customize/class-wp-customize-date-time-control.php
@ -187,6 +187,7 @@ class WP_Customize_Date_Time_Control extends WP_Customize_Control {
 	 * Based on touch_time().
 	 *
 	 * @since 4.9.0
+	 *
 	 * @see touch_time()
 	 *
 	 * @global WP_Locale $wp_locale WordPress date and time locale object.
@ -261,6 +262,7 @@ class WP_Customize_Date_Time_Control extends WP_Customize_Control {
 	 * Format GMT Offset.
 	 *
 	 * @since 4.9.0
+	 *
 	 * @see wp_timezone_choice()
 	 *
 	 * @param float $offset Offset in hours.
--- a/src/wp-includes/customize/class-wp-customize-partial.php
+++ b/src/wp-includes/customize/class-wp-customize-partial.php
@ -97,10 +97,11 @@ class WP_Customize_Partial {
 	 * Render callback.
 	 *
 	 * @since 4.5.0
+	 *
 	 * @see WP_Customize_Partial::render()
 	 * @var callable Callback is called with one argument, the instance of
-	 *                 WP_Customize_Partial. The callback can either echo the
-	 *                 partial or return the partial as a string, or return false if error.
+	 *               WP_Customize_Partial. The callback can either echo the
+	 *               partial or return the partial as a string, or return false if error.
 	 */
 	public $render_callback;

--- a/src/wp-includes/default-constants.php
+++ b/src/wp-includes/default-constants.php
@ -401,6 +401,7 @@ function wp_templating_constants() {
 	 * It will be used as the fallback if the current theme doesn't exist.
 	 *
 	 * @since 3.0.0
+	 *
 	 * @see WP_Theme::get_core_default_theme()
 	 */
 	if ( ! defined( 'WP_DEFAULT_THEME' ) ) {
--- a/src/wp-includes/feed.php
+++ b/src/wp-includes/feed.php
@ -18,6 +18,7 @@
 * are retrieved for use in the feeds.
 *
 * @since 1.5.1
+ *
 * @see get_bloginfo() For the list of possible values to display.
 *
 * @param string $show See get_bloginfo() for possible values.
@ -47,6 +48,7 @@ function get_bloginfo_rss( $show = '' ) {
 * are retrieved for use in the feeds.
 *
 * @since 0.71
+ *
 * @see get_bloginfo() For the list of possible values to display.
 *
 * @param string $show See get_bloginfo() for possible values.
@ -177,6 +179,7 @@ function the_title_rss() {
 * Retrieve the post content for feeds.
 *
 * @since 2.9.0
+ *
 * @see get_the_content()
 *
 * @param string $feed_type The type of feed. rss2 | atom | rss | rdf
@ -427,6 +430,7 @@ function get_the_category_rss( $type = null ) {
 * Display the post categories in the feed.
 *
 * @since 0.71
+ *
 * @see get_the_category_rss() For better explanation.
 *
 * @param string $type Optional, default is the type returned by get_default_feed().
@ -772,6 +776,7 @@ function fetch_feed( $url ) {
 	$feed->set_feed_url( $url );
 	/** This filter is documented in wp-includes/class-wp-feed-cache-transient.php */
 	$feed->set_cache_duration( apply_filters( 'wp_feed_cache_transient_lifetime', 12 * HOUR_IN_SECONDS, $url ) );
+
 	/**
 	 * Fires just before processing the SimplePie feed object.
 	 *
@ -781,6 +786,7 @@ function fetch_feed( $url ) {
 	 * @param string|string[] $url  URL of feed or array of URLs of feeds to retrieve.
 	 */
 	do_action_ref_array( 'wp_feed_options', array( &$feed, $url ) );
+
 	$feed->init();
 	$feed->set_output_encoding( get_option( 'blog_charset' ) );

--- a/src/wp-includes/link-template.php
+++ b/src/wp-includes/link-template.php
@ -2123,6 +2123,7 @@ function get_next_post_link( $format = '%link &raquo;', $link = '%title', $in_sa
 * Displays the next post link that is adjacent to the current post.
 *
 * @since 1.5.0
+ *
 * @see get_next_post_link()
 *
 * @param string       $format         Optional. Link anchor format. Default '&laquo; %link'.
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@ -3277,6 +3277,7 @@ function get_attachment_taxonomies( $attachment, $output = 'names' ) {
 * Handles mime-type-specific taxonomies such as attachment:image and attachment:video.
 *
 * @since 3.5.0
+ *
 * @see get_taxonomies()
 *
 * @param string $output Optional. The type of taxonomy output to return. Accepts 'names' or 'objects'.
--- a/src/wp-includes/ms-functions.php
+++ b/src/wp-includes/ms-functions.php
@ -2200,6 +2200,7 @@ function add_existing_user_to_blog( $details = false ) {
 * is specifically hooked into the {@see 'wpmu_activate_user'} action.
 *
 * @since MU (3.0.0)
+ *
 * @see add_user_to_blog()
 *
 * @param int    $user_id  User ID.
--- a/src/wp-includes/nav-menu.php
+++ b/src/wp-includes/nav-menu.php
@ -106,6 +106,7 @@ function register_nav_menus( $locations = array() ) {
 * Unregisters a navigation menu location for a theme.
 *
 * @since 3.1.0
+ *
 * @global array $_wp_registered_nav_menus
 *
 * @param string $location The menu location identifier.
--- a/src/wp-includes/pluggable.php
+++ b/src/wp-includes/pluggable.php
@ -17,6 +17,7 @@ if ( ! function_exists( 'wp_set_current_user' ) ) :
 	 * actions on users who aren't signed in.
 	 *
 	 * @since 2.0.3
+	 *
 	 * @global WP_User $current_user The current user object which holds the user data.
 	 *
 	 * @param int    $id   User ID
@ -2370,7 +2371,7 @@ if ( ! function_exists( 'wp_check_password' ) ) :
 	 * @since 2.5.0
 	 *
 	 * @global PasswordHash $wp_hasher PHPass object used for checking the password
-	 *  against the $hash + $password
+	 *                                 against the $hash + $password
 	 * @uses PasswordHash::CheckPassword
 	 *
 	 * @param string     $password Plaintext user's password
--- a/src/wp-includes/post.php
+++ b/src/wp-includes/post.php
@ -999,6 +999,7 @@ function _wp_privacy_statuses() {
 * Arguments prefixed with an _underscore shouldn't be used by plugins and themes.
 *
 * @since 3.0.0
+ *
 * @global array $wp_post_statuses Inserts new post status object into the list
 *
 * @param string $post_status Name of the post status.
--- a/src/wp-includes/script-loader.php
+++ b/src/wp-includes/script-loader.php
@ -1971,6 +1971,7 @@ function wp_localize_community_events() {
 * the $_wp_admin_css_colors array value URL.
 *
 * @since 2.6.0
+ *
 * @global array $_wp_admin_css_colors
 *
 * @param string $src    Source URL.
@ -2183,7 +2184,7 @@ function wp_print_footer_scripts() {
 }

 /**
- * Wrapper for do_action('wp_enqueue_scripts')
+ * Wrapper for do_action( 'wp_enqueue_scripts' ).
 *
 * Allows plugins to queue scripts for the front end using wp_enqueue_script().
 * Runs first in wp_head() where all is_home(), is_page(), etc. functions are available.
--- a/src/wp-includes/theme.php
+++ b/src/wp-includes/theme.php
@ -834,6 +834,7 @@ function switch_theme( $stylesheet ) {
 * disable this functionality.
 *
 * @since 1.5.0
+ *
 * @see WP_DEFAULT_THEME
 *
 * @return bool
@ -2817,7 +2818,9 @@ function get_theme_support( $feature, ...$args ) {
 * be used for child themes to override support from the parent theme.
 *
 * @since 3.0.0
+ *
 * @see add_theme_support()
+ *
 * @param string $feature The feature being removed.
 * @return bool|void Whether feature was removed.
 */
@ -3240,6 +3243,7 @@ function _wp_customize_publish_changeset( $new_status, $old_status, $changeset_p
 * transitioned into pending status by a contributor.
 *
 * @since 4.7.0
+ *
 * @see wp_insert_post()
 *
 * @param array $post_data          An array of slashed post data.
--- a/src/wp-includes/update.php
+++ b/src/wp-includes/update.php
@ -9,11 +9,13 @@
 /**
 * Check WordPress version against the newest version.
 *
- * The WordPress version, PHP version, and Locale is sent. Checks against the
- * WordPress server at api.wordpress.org server. Will only check if WordPress
- * isn't installing.
+ * The WordPress version, PHP version, and locale is sent.
+ *
+ * Checks against the WordPress server at api.wordpress.org. Will only check
+ * if WordPress isn't installing.
 *
 * @since 2.3.0
+ *
 * @global string $wp_version       Used to check against the newest WordPress version.
 * @global wpdb   $wpdb             WordPress database abstraction object.
 * @global string $wp_local_package Locale code of the package.
@ -251,11 +253,13 @@ function wp_version_check( $extra_stats = array(), $force_check = false ) {
 /**
 * Check plugin versions against the latest versions hosted on WordPress.org.
 *
- * The WordPress version, PHP version, and Locale is sent along with a list of
- * all plugins installed. Checks against the WordPress server at
- * api.wordpress.org. Will only check if WordPress isn't installing.
+ * A list of all plugins installed is sent to WP, along with the site locale.
+ *
+ * Checks against the WordPress server at api.wordpress.org. Will only check
+ * if WordPress isn't installing.
 *
 * @since 2.3.0
+ *
 * @global string $wp_version The WordPress version string.
 *
 * @param array $extra_stats Extra statistics to report to the WordPress.org API.
@ -442,11 +446,13 @@ function wp_update_plugins( $extra_stats = array() ) {
 /**
 * Check theme versions against the latest versions hosted on WordPress.org.
 *
- * A list of all themes installed in sent to WP. Checks against the
- * WordPress server at api.wordpress.org. Will only check if WordPress isn't
- * installing.
+ * A list of all themes installed is sent to WP, along with the site locale.
+ *
+ * Checks against the WordPress server at api.wordpress.org. Will only check
+ * if WordPress isn't installing.
 *
 * @since 2.7.0
+ *
 * @global string $wp_version The WordPress version string.
 *
 * @param array $extra_stats Extra statistics to report to the WordPress.org API.
--- a/src/wp-includes/user.php
+++ b/src/wp-includes/user.php
@ -803,6 +803,7 @@ function add_user_meta( $user_id, $meta_key, $meta_value, $unique = false ) {
 * allows removing all metadata matching key, if needed.
 *
 * @since 3.0.0
+ *
 * @link https://developer.wordpress.org/reference/functions/delete_user_meta/
 *
 * @param int    $user_id    User ID
@ -820,6 +821,7 @@ function delete_user_meta( $user_id, $meta_key, $meta_value = '' ) {
 * Retrieve user meta field for a user.
 *
 * @since 3.0.0
+ *
 * @link https://developer.wordpress.org/reference/functions/get_user_meta/
 *
 * @param int    $user_id User ID.
@ -844,6 +846,7 @@ function get_user_meta( $user_id, $key = '', $single = false ) {
 * If the meta field for the user does not exist, it will be added.
 *
 * @since 3.0.0
+ *
 * @link https://developer.wordpress.org/reference/functions/update_user_meta/
 *
 * @param int    $user_id    User ID.
@ -1554,7 +1557,7 @@ function wp_insert_user( $userdata ) {
 			return new WP_Error( 'invalid_user_id', __( 'Invalid user ID.' ) );
 		}

-		// hashed in wp_update_user(), plaintext if called directly.
+		// Hashed in wp_update_user(), plaintext if called directly.
 		$user_pass = ! empty( $userdata['user_pass'] ) ? $userdata['user_pass'] : $old_user_data->user_pass;
 	} else {
 		$update = false;
@ -2163,7 +2166,8 @@ All at ###SITENAME###
 * complex user creation use wp_insert_user() to specify more information.
 *
 * @since 2.0.0
- * @see wp_insert_user() More complete way to create a new user
+ *
+ * @see wp_insert_user() More complete way to create a new user.
 *
 * @param string $username The user's username.
 * @param string $password The user's password.
@ -2629,6 +2633,7 @@ function wp_get_session_token() {
 * Retrieve a list of sessions for the current user.
 *
 * @since 4.0.0
+ *
 * @return array Array of sessions.
 */
 function wp_get_all_sessions() {