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

Timestamp:

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

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 ) );
         }