diff --git a/includes/theme.inc b/includes/theme.inc
index bf7b42f6ece407a61bfeeecf5aa107104497b98c..8104aaeb7d8db80747a8f22097df558dcc183e9b 100644
--- a/includes/theme.inc
+++ b/includes/theme.inc
@@ -1454,6 +1454,12 @@ function theme_more_help_link($url) {
 
 /**
  * Return code that emits an XML icon.
+ * 
+ * For most use cases, this function has been superseded by theme_feed_icon().
+ * 
+ * @see theme_feed_icon()
+ * @param $url
+ *   The url of the feed.
  */
 function theme_xml_icon($url) {
   if ($image = theme('image', 'misc/xml.png', t('XML feed'), t('XML feed'))) {