Index: wp-includes/admin-bar.php
===================================================================
--- wp-includes/admin-bar.php	(revision 24921)
+++ wp-includes/admin-bar.php	(working copy)
@@ -31,6 +31,7 @@
 	else
 		return false;
 
+    /* @var $wp_admin_bar WP_Admin_Bar */
 	$wp_admin_bar->initialize();
 	$wp_admin_bar->add_menus();
 
@@ -52,6 +53,7 @@
  * @since 3.1.0
  */
 function wp_admin_bar_render() {
+    /* @var $wp_admin_bar WP_Admin_Bar */
 	global $wp_admin_bar;
 
 	if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) )
@@ -72,6 +74,7 @@
  * Add the WordPress logo menu.
  *
  * @since 3.3.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_wp_menu( $wp_admin_bar ) {
 	$wp_admin_bar->add_menu( array(
@@ -130,6 +133,7 @@
  * Add the "My Account" item.
  *
  * @since 3.3.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_my_account_item( $wp_admin_bar ) {
 	$user_id      = get_current_user_id();
@@ -159,6 +163,7 @@
  * Add the "My Account" submenu items.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_my_account_menu( $wp_admin_bar ) {
 	$user_id      = get_current_user_id();
@@ -206,6 +211,7 @@
  * Add the "Site Name" menu.
  *
  * @since 3.3.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_site_menu( $wp_admin_bar ) {
 	global $current_site;
@@ -275,6 +281,7 @@
  * Add the "My Sites/[Site Name]" menu and all submenus.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {
 	global $wpdb;
@@ -396,6 +403,7 @@
  * Provide a shortlink.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_shortlink_menu( $wp_admin_bar ) {
 	$short = wp_get_shortlink( 0, 'query' );
@@ -418,6 +426,7 @@
  * Provide an edit link for posts and terms.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_edit_menu( $wp_admin_bar ) {
 	global $tag, $wp_the_query;
@@ -483,6 +492,7 @@
  * Add "Add New" menu.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_new_content_menu( $wp_admin_bar ) {
 	$actions = array();
@@ -548,6 +558,7 @@
  * Add edit comments link with awaiting moderation count bubble.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_comments_menu( $wp_admin_bar ) {
 	if ( !current_user_can('edit_posts') )
@@ -572,6 +583,7 @@
  * Add appearance submenu items to the "Site Name" menu.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_appearance_menu( $wp_admin_bar ) {
 	$wp_admin_bar->add_group( array( 'parent' => 'site-name', 'id' => 'appearance' ) );
@@ -611,6 +623,7 @@
  * Provide an update link if theme/plugin/core updates are available.
  *
  * @since 3.1.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_updates_menu( $wp_admin_bar ) {
 
@@ -636,6 +649,7 @@
  * Add search form.
  *
  * @since 3.3.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_search_menu( $wp_admin_bar ) {
 	if ( is_admin() )
@@ -661,6 +675,7 @@
  * Add secondary menus.
  *
  * @since 3.3.0
+ * @param $wp_admin_bar WP_Admin_Bar
  */
 function wp_admin_bar_add_secondary_groups( $wp_admin_bar ) {
 	$wp_admin_bar->add_group( array(