Index: src/wp-includes/post.php
===================================================================
--- src/wp-includes/post.php	(revision 43831)
+++ src/wp-includes/post.php	(working copy)
@@ -1965,11 +1965,13 @@
 /**
  * Updates a post meta field based on the given post ID.
  *
- * Use the $prev_value parameter to differentiate between meta fields with the
+ * Use the `$prev_value` parameter to differentiate between meta fields with the
  * same key and post ID.
  *
  * If the meta field for the post does not exist, it will be added and its ID returned.
  *
+ * Can be used in place of add_post_meta().
+ *
  * @since 1.5.0
  *
  * @param int    $post_id    Post ID.