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

Timestamp:

01/29/2020 12:43:23 AM (5 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 );