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

Timestamp:

07/09/2023 08:15:03 PM (3 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() ) {