Ticket #33014: post.php.patch

post.php

@@ -4009 +4009 @@
 }
 
 /**
- * Transition the post status of a post.
+ * Perform action hooks that occur just before the transition the post status of a post.
  *
  * When a post is saved, the post status is "transitioned" from one status to another,
  * though this does not always mean the status has actually changed before and after
- * the save.
+ * the save. This function only fires do_action hooks, it does not actually transition
+ * the post. 
  *
  * For instance: When publishing a post for the first time, the post status may transition
  * from 'draft' – or some other status – to 'publish'. However, if a post is already
@@ -4022 +4023 @@
  *
  * @since 2.3.0
  *
- * @param string  $new_status Transition to this post status.
+ * @param string  $new_status Transitioning to this post status.
  * @param string  $old_status Previous post status.
  * @param WP_Post $post Post data.
  */