From 90605e02e7f227521e00a39988f690a705c46275 Mon Sep 17 00:00:00 2001
From: Andrew Nacin <nacin@git.wordpress.org>
Date: Thu, 5 Sep 2013 16:20:05 +0000
Subject: [PATCH] Hook docs for admin-footer.php.

props natejacobs.
see #25229.


git-svn-id: https://develop.svn.wordpress.org/trunk@25252 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-admin/admin-footer.php | 60 +++++++++++++++++++++++++++++++----
 1 file changed, 54 insertions(+), 6 deletions(-)

diff --git a/src/wp-admin/admin-footer.php b/src/wp-admin/admin-footer.php
index 3818ab411e..0c51d0aacd 100644
--- a/src/wp-admin/admin-footer.php
+++ b/src/wp-admin/admin-footer.php
@@ -16,16 +16,64 @@ if ( !defined('ABSPATH') )
 <div class="clear"></div></div><!-- wpcontent -->
 
 <div id="wpfooter">
-<?php do_action( 'in_admin_footer' ); ?>
-<p id="footer-left" class="alignleft"><?php
-echo apply_filters( 'admin_footer_text', '<span id="footer-thankyou">' . __( 'Thank you for creating with <a href="http://wordpress.org/">WordPress</a>.' ) . '</span>' );
-?></p>
-<p id="footer-upgrade" class="alignright"><?php echo apply_filters( 'update_footer', '' ); ?></p>
-<div class="clear"></div>
+	<?php
+	/**
+	 * Fires after the opening tag for the admin footer.
+	 *
+	 * @since 2.5.0
+	 */ 
+	do_action( 'in_admin_footer' ); 
+	?>
+	<p id="footer-left" class="alignleft">
+		<?php
+		/**
+		 * Filter the "Thank you" text displayed in the admin footer
+		 * 
+		 * @since 2.8.0
+		 * @param string The content that will be printed.
+		 */	
+		echo apply_filters( 'admin_footer_text', '<span id="footer-thankyou">' . __( 'Thank you for creating with <a href="http://wordpress.org/">WordPress</a>.' ) . '</span>' );
+		?>
+	</p>
+	<p id="footer-upgrade" class="alignright">
+		<?php
+		/**
+		 * Filter the version/update text displayed in the admin footer
+		 *
+		 * @see core_update_footer() WordPress prints the current version and update information,
+		 *	using core_update_footer() at priority 10.
+		 * 
+		 * @since 2.5.0
+		 * @param string The content that will be printed.
+		 */
+		echo apply_filters( 'update_footer', '' ); 
+		?>
+	</p>
+	<div class="clear"></div>
 </div>
 <?php
+/**
+ * Print scripts or data before the default footer scripts
+ * 
+ * @since 2.5.0
+ * @param string The data to print.
+ */
 do_action('admin_footer', '');
+
+/**
+ * Prints any scripts and data queued for the footer
+ * 
+ * @since 2.8.0
+ */
 do_action('admin_print_footer_scripts');
+
+/**
+ * Print scripts or data after the default footer scripts
+ * 
+ * @since unknown
+ * 
+ * @param type $GLOBALS['hook_suffix'] The current admin page.
+ */
 do_action("admin_footer-" . $GLOBALS['hook_suffix']);
 
 // get_site_option() won't exist when auto upgrading from <= 2.7