Index: wp-includes/post.php
===================================================================
--- wp-includes/post.php	(revision 40476)
+++ wp-includes/post.php	(working copy)
@@ -2824,10 +2824,11 @@
  *
  * @since 2.3.0
  *
- * @param int   $post_id Optional. The Post ID. Does not default to the ID of the
- *                       global $post. Default 0.
- * @param array $args Optional. Overwrite the defaults
- * @return array List of post tags.
+ * @param int    $post_id Optional. The Post ID. Does not default to the ID of the
+ *                        global $post. Default 0.
+ * @param array  $args    Optional. Overwrite the defaults
+ * @return array|WP_Error Array of WP_Term objects on success, an empty array if there are no
+ *                        terms, or a WP_Error object if the `post_tag` taxonomy does not exist.
  */
 function wp_get_post_tags( $post_id = 0, $args = array() ) {
 	return wp_get_post_terms( $post_id, 'post_tag', $args);
@@ -2846,8 +2847,8 @@
  *                         global $post. Default 0.
  * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
  * @param array  $args     Optional. wp_get_object_terms() arguments. Default empty array.
- * @return array|WP_Error  List of post terms or empty array if no terms were found. WP_Error object
- *                         if `$taxonomy` doesn't exist.
+ * @return array|WP_Error  Array of WP_Term objects on success or empty array if no terms were
+ *                         found. WP_Error object if `$taxonomy` doesn't exist.
  */
 function wp_get_post_terms( $post_id = 0, $taxonomy = 'post_tag', $args = array() ) {
 	$post_id = (int) $post_id;