Docs: Improve description for wp_insert_post().

SergeyBiryukov · SergeyBiryukov · commit dc6ce7adfa93 · 2025-11-20T19:27:52.000Z
Follow-up to [6379], [8669]. Props rutujaparamane2004. See #64224. git-svn-id: https://develop.svn.wordpress.org/trunk@61275 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/post.php b/src/wp-includes/post.php
@@ -4435,9 +4435,10 @@ function wp_get_recent_posts( $args = array(), $output = ARRAY_A ) {
 }
 
 /**
- * Inserts or update a post.
+ * Inserts or updates a post in the database.
  *
- * If the $postarr parameter has 'ID' set to a value, then post will be updated.
+ * If the `$postarr` parameter contains an 'ID', the corresponding post will be updated.
+ * If not, a new post will be created using the values provided.
  *
  * You can set the post date manually, by setting the values for 'post_date'
  * and 'post_date_gmt' keys. You can close the comments or open the comments by

Original file line number	Diff line number	Diff line change
`@@ -4435,9 +4435,10 @@ function wp_get_recent_posts( $args = array(), $output = ARRAY_A ) {`
`4435`	`4435`	`}`
`4436`	`4436`
`4437`	`4437`	`/**`
`4438`		`- * Inserts or update a post.`
	`4438`	`+ * Inserts or updates a post in the database.`
`4439`	`4439`	`*`
`4440`		`- * If the $postarr parameter has 'ID' set to a value, then post will be updated.`
	`4440`	+ * If the `$postarr` parameter contains an 'ID', the corresponding post will be updated.
	`4441`	`+ * If not, a new post will be created using the values provided.`
`4441`	`4442`	`*`
`4442`	`4443`	`* You can set the post date manually, by setting the values for 'post_date'`
`4443`	`4444`	`* and 'post_date_gmt' keys. You can close the comments or open the comments by`