Index: feed.php
===================================================================
--- feed.php	(revision 6597)
+++ feed.php	(working copy)
@@ -1,18 +1,66 @@
 <?php
+/**
+ * WordPress Feed API
+ *
+ * @package WordPress
+ * @subpackage Feed
+ */
 
+/**
+ * get_bloginfo_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.1
+ * @uses apply_filters() 
+ *
+ * @param unknown_type $show
+ * @return unknown
+ */
 function get_bloginfo_rss($show = '') {
 	$info = strip_tags(get_bloginfo($show));
 	return apply_filters('get_bloginfo_rss', convert_chars($info));
 }
 
+/**
+ * bloginfo_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ * @uses apply_filters() 
+ *
+ * @param unknown_type $show
+ */
 function bloginfo_rss($show = '') {
 	echo apply_filters('bloginfo_rss', get_bloginfo_rss($show));
 }
 
+/**
+ * get_default_feed() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.5
+ * @uses apply_filters() 
+ *
+ * @return unknown
+ */
 function get_default_feed() {
 	return apply_filters('default_feed', 'rss2');
 }
 
+/**
+ * get_wp_title_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.2.0
+ * @uses apply_filters() 
+ *
+ * @param unknown_type $sep
+ * @return unknown
+ */
 function get_wp_title_rss($sep = '&#187;') {
 	$title = wp_title($sep, false);
 	if ( is_wp_error( $title ) )
@@ -21,22 +69,61 @@
 	return $title;
 }
 
+/**
+ * wp_title_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.2.0
+ * @uses apply_filters() 
+ *
+ * @param unknown_type $sep
+ */
 function wp_title_rss($sep = '&#187;') {
 	echo apply_filters('wp_title_rss', get_wp_title_rss($sep));
 }
 
+/**
+ * get_the_title_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ * @uses apply_filters() 
+ *
+ * @return unknown
+ */
 function get_the_title_rss() {
 	$title = get_the_title();
 	$title = apply_filters('the_title_rss', $title);
 	return $title;
 }
 
-
+/**
+ * the_title_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ */
 function the_title_rss() {
 	echo get_the_title_rss();
 }
 
-
+/**
+ * the_content_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ * @uses apply_filters() 
+ *
+ * @param unknown_type $more_link_text
+ * @param unknown_type $stripteaser
+ * @param unknown_type $more_file
+ * @param unknown_type $cut
+ * @param unknown_type $encode_html
+ */
 function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
 	$content = get_the_content($more_link_text, $stripteaser, $more_file);
 	$content = apply_filters('the_content_rss', $content);
@@ -68,35 +155,92 @@
 	echo $content;
 }
 
-
+/**
+ * the_excerpt_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ * @uses apply_filters() 
+ */
 function the_excerpt_rss() {
 	$output = get_the_excerpt();
 	echo apply_filters('the_excerpt_rss', $output);
 }
 
+/**
+ * the_permalink_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.3.0
+ * @uses apply_filters()
+ */
 function the_permalink_rss() {
 	echo apply_filters('the_permalink_rss', get_permalink());
-
 }
 
+/**
+ * comment_link() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.0
+ */
 function comment_link() {
 	echo get_comment_link();
 }
 
+/**
+ * get_comment_author_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ * @uses apply_filters() 
+ *
+ * @return unknown
+ */
 function get_comment_author_rss() {
 	return apply_filters('comment_author_rss', get_comment_author() );
 }
 
+/**
+ * comment_author_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.0.0
+ */
 function comment_author_rss() {
 	echo get_comment_author_rss();
 }
 
+/**
+ * comment_text_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.0.0
+ * @uses apply_filters() 
+ */
 function comment_text_rss() {
 	$comment_text = get_comment_text();
 	$comment_text = apply_filters('comment_text_rss', $comment_text);
 	echo $comment_text;
 }
 
+/**
+ * get_the_category_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ * @uses apply_filters() 
+ *
+ * @param unknown_type $type
+ * @return unknown
+ */
 function get_the_category_rss($type = 'rss') {
 	$categories = get_the_category();
 	$tags = get_the_tags();
@@ -129,10 +273,26 @@
 	return apply_filters('the_category_rss', $the_list, $type);
 }
 
+/**
+ * the_category_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $type
+ */
 function the_category_rss($type = 'rss') {
 	echo get_the_category_rss($type);
 }
 
+/**
+ * html_type_rss() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.2.0
+ */
 function html_type_rss() {
 	$type = get_bloginfo('html_type');
 	if (strpos($type, 'xhtml') !== false)
@@ -142,7 +302,14 @@
 	echo $type;
 }
 
-
+/**
+ * rss_enclosure() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.0
+ * @uses apply_filters() 
+ */
 function rss_enclosure() {
 	global $post;
 	if ( !empty($post->post_password) && ($_COOKIE['wp-postpass_'.COOKIEHASH] != $post->post_password) )
@@ -158,6 +325,14 @@
 	}
 }
 
+/**
+ * atom_enclosure() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.2.0
+ * @uses apply_filters() 
+ */
 function atom_enclosure() {
 	global $post;
 	if ( !empty($post->post_password) && ($_COOKIE['wp-postpass_'.COOKIEHASH] != $post->post_password) )
@@ -174,7 +349,7 @@
 }
 
 /**
- * prep_atom_text_construct() - Determine the type of a given string of data
+ * prep_atom_text_construct() - Determine the type of a string of data
  *
  * Tell whether the type is text, html, or xhtml, per RFC 4287 section 3.1.
  *
@@ -185,9 +360,7 @@
  *
  * @link http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.3.1
  *
- * @package WordPress
- * @subpackage Feed
- * @since 2.4 
+ * @since 2.5
  *
  * @param string $data input string
  * @return array $result array(type, value)