Changeset 56176 for trunk/src/wp-admin/includes/revision.php

Timestamp:

07/09/2023 08:05:43 PM (15 months 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].

Props costdev, audrasjb.
See #58459.

File:

• trunk/src/wp-admin/includes/revision.php (modified) (2 diffs)

trunk/src/wp-admin/includes/revision.php

@@ -40 +40 @@
     }
 
-    // If comparing revisions, make sure we're dealing with the right post parent.
-    // The parent post may be a 'revision' when revisions are disabled and we're looking at autosaves.
+    /*
+     * If comparing revisions, make sure we are dealing with the right post parent.
+     * The parent post may be a 'revision' when revisions are disabled and we're looking at autosaves.
+     */
     if ( $compare_from && $compare_from->post_parent !== $post->ID && $compare_from->ID !== $post->ID ) {
         return false;
@@ -119 +121 @@
 
         if ( ! $diff && 'post_title' === $field ) {
-            // It's a better user experience to still show the Title, even if it didn't change.
-            // No, you didn't see this.
+            /*
+             * It's a better user experience to still show the Title, even if it didn't change.
+             * No, you didn't see this.
+             */
             $diff = '<table class="diff"><colgroup><col class="content diffsplit left"><col class="content diffsplit middle"><col class="content diffsplit right"></colgroup><tbody><tr>';