Changeset 47122 for trunk/src/wp-includes/class-wp-admin-bar.php

Timestamp:

01/29/2020 12:43:23 AM (7 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/src/wp-includes/class-wp-admin-bar.php (modified) (4 diffs)

trunk/src/wp-includes/class-wp-admin-bar.php

@@ -123 +123 @@
          */
         public function add_node( $args ) {
-                // Shim for old method signature: add_node( $parent_id, $menu_obj, $args )
+                // Shim for old method signature: add_node( $parent_id, $menu_obj, $args ).
                 if ( func_num_args() >= 3 && is_string( $args ) ) {
                         $args = array_merge( array( 'parent' => $args ), func_get_arg( 2 ) );
@@ -608 +608 @@
          */
         public function add_menus() {
-                // User related, aligned right.
+                // User-related, aligned right.
                 add_action( 'admin_bar_menu', 'wp_admin_bar_my_account_menu', 0 );
                 add_action( 'admin_bar_menu', 'wp_admin_bar_search_menu', 4 );
@@ -614 +614 @@
                 add_action( 'admin_bar_menu', 'wp_admin_bar_recovery_mode_menu', 8 );
 
-                // Site related.
+                // Site-related.
                 add_action( 'admin_bar_menu', 'wp_admin_bar_sidebar_toggle', 0 );
                 add_action( 'admin_bar_menu', 'wp_admin_bar_wp_menu', 10 );
@@ -622 +622 @@
                 add_action( 'admin_bar_menu', 'wp_admin_bar_updates_menu', 50 );
 
-                // Content related.
+                // Content-related.
                 if ( ! is_network_admin() && ! is_user_admin() ) {
                         add_action( 'admin_bar_menu', 'wp_admin_bar_comments_menu', 60 );