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

Timestamp:

07/09/2023 08:15:03 PM (2 years ago)

Author:

audrasjb

Message:

Docs: Replace multiple single line comments with multi-line comments.

This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See ​https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.

Follow-up to [56174], [56175], [56176].

Props costdev, audrasjb.
See #58459.

File:

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

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

@@ -314 +314 @@
         }
 
-        // Add the root node.
-        // Clear it first, just in case. Don't mess with The Root.
+        /*
+         * Add the root node.
+         * Clear it first, just in case. Don't mess with The Root.
+         */
         $this->remove_node( 'root' );
         $this->add_node(
@@ -363 +365 @@
                 $default    = $this->_get_node( $default_id );
 
-                // The default group is added here to allow groups that are
-                // added before standard menu items to render first.
+                /*
+                 * The default group is added here to allow groups that are
+                 * added before standard menu items to render first.
+                 */
                 if ( ! $default ) {
-                    // Use _set_node because add_node can be overloaded.
-                    // Make sure to specify default settings for all properties.
+                    /*
+                     * Use _set_node because add_node can be overloaded.
+                     * Make sure to specify default settings for all properties.
+                     */
                     $this->_set_node(
                         array(
@@ -386 +392 @@
                 $parent = $default;
 
-                // Groups in groups aren't allowed. Add a special 'container' node.
-                // The container will invisibly wrap both groups.
+                /*
+                 * Groups in groups aren't allowed. Add a special 'container' node.
+                 * The container will invisibly wrap both groups.
+                 */
             } elseif ( 'group' === $parent->type && 'group' === $node->type ) {
                 $container_id = $parent->id . '-container';
@@ -394 +402 @@
                 // We need to create a container for this group, life is sad.
                 if ( ! $container ) {
-                    // Use _set_node because add_node can be overloaded.
-                    // Make sure to specify default settings for all properties.
+                    /*
+                     * Use _set_node because add_node can be overloaded.
+                     * Make sure to specify default settings for all properties.
+                     */
                     $this->_set_node(
                         array(
@@ -448 +458 @@
      */
     final protected function _render( $root ) {
-        // Add browser classes.
-        // We have to do this here since admin bar shows on the front end.
+        /*
+         * Add browser classes.
+         * We have to do this here since admin bar shows on the front end.
+         */
         $class = 'nojq nojs';
         if ( wp_is_mobile() ) {