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

Timestamp:

07/09/2023 08:05:43 PM (17 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/post.php (modified) (3 diffs)

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

@@ -136 +136 @@
     $published_statuses = array( 'publish', 'future' );
 
-    // Posts 'submitted for approval' are submitted to $_POST the same as if they were being published.
-    // Change status from 'publish' to 'pending' if user lacks permissions to publish or to resave published posts.
+    /*
+     * Posts 'submitted for approval' are submitted to $_POST the same as if they were being published.
+     * Change status from 'publish' to 'pending' if user lacks permissions to publish or to resave published posts.
+     */
     if ( isset( $post_data['post_status'] )
         && ( in_array( $post_data['post_status'], $published_statuses, true )
@@ -1444 +1446 @@
     }
 
-    // If the user wants to set a new name -- override the current one.
-    // Note: if empty name is supplied -- use the title instead, see #6072.
+    /*
+     * If the user wants to set a new name -- override the current one.
+     * Note: if empty name is supplied -- use the title instead, see #6072.
+     */
     if ( ! is_null( $name ) ) {
         $post->post_name = sanitize_title( $name ? $name : $title, $post->ID );
@@ -2074 +2078 @@
         return edit_post( wp_slash( $post_data ) );
     } else {
-        // Non-drafts or other users' drafts are not overwritten.
-        // The autosave is stored in a special post revision for each user.
+        /*
+         * Non-drafts or other users' drafts are not overwritten.
+         * The autosave is stored in a special post revision for each user.
+         */
         return wp_create_post_autosave( wp_slash( $post_data ) );
     }