Ticket #25229: wp-includes-feed-rss2.diff

wp-includes/feed-rss2.php

@@ -17 +17 @@
         xmlns:atom="http://www.w3.org/2005/Atom"
         xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
         xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
-        <?php do_action('rss2_ns'); ?>
+        <?php
+        /**
+         * Fired at the end of the RSS root to add namespaces.
+         *
+         * @since 2.0.0
+         */
+        do_action('rss2_ns'); ?>
 >
 
 <channel>
@@ -27 +33 @@
         <description><?php bloginfo_rss("description") ?></description>
         <lastBuildDate><?php echo mysql2date('D, d M Y H:i:s +0000', get_lastpostmodified('GMT'), false); ?></lastBuildDate>
         <language><?php bloginfo_rss( 'language' ); ?></language>
+        <?php
+        /**
+         * Allows filtering of the declaration of the period of time the feed is updated. 
+         *
+         * @since 2.1
+         *
+         * @param string The update period. Accepted values are hourly, daily, weekly, monthly, and yearly.
+         */
+        ?>
         <sy:updatePeriod><?php echo apply_filters( 'rss_update_period', 'hourly' ); ?></sy:updatePeriod>
+        <?php
+        /**
+         * Allows filtering of the frequency of updating within the update period. 
+         *
+         * @since 2.1
+         *
+         * @param string An integer representing the frequency of udpates within the update period.
+         */
+        ?>
         <sy:updateFrequency><?php echo apply_filters( 'rss_update_frequency', '1' ); ?></sy:updateFrequency>
-        <?php do_action('rss2_head'); ?>
+        <?php
+        /**
+         * Fired at the end of the RSS2 Feed Header.
+         *
+         * @since 2.0.0
+         */
+        do_action('rss2_head'); ?>
         <?php while( have_posts()) : the_post(); ?>
         <item>
                 <title><?php the_title_rss() ?></title>
@@ -54 +84 @@
                 <wfw:commentRss><?php echo esc_url( get_post_comments_feed_link(null, 'rss2') ); ?></wfw:commentRss>
                 <slash:comments><?php echo get_comments_number(); ?></slash:comments>
 <?php rss_enclosure(); ?>
-        <?php do_action('rss2_item'); ?>
+        <?php
+        /**
+         * Fired at the end of each RSS2 feed item.
+         *
+         * @since 2.0.0
+         */
+        do_action('rss2_item'); ?>
         </item>
         <?php endwhile; ?>
 </channel>