diff --git a/src/wp-includes/revision.php b/src/wp-includes/revision.php index be3f62cbc2..0f76f908f1 100644 --- a/src/wp-includes/revision.php +++ b/src/wp-includes/revision.php @@ -220,7 +220,7 @@ function wp_save_post_revision( $post_id ) { } /** - * Retrieve the autosaved data of the specified post. + * Retrieves the autosaved data of the specified post. * * Returns a post object with the information that was autosaved for the specified post. * If the optional $user_id is passed, returns the autosave for that user, otherwise @@ -231,7 +231,7 @@ function wp_save_post_revision( $post_id ) { * @global wpdb $wpdb WordPress database abstraction object. * * @param int $post_id The post ID. - * @param int $user_id Optional The post author ID. + * @param int $user_id Optional. The post author ID. * @return WP_Post|false The autosaved data or false on failure or when no autosave exists. */ function wp_get_post_autosave( $post_id, $user_id = 0 ) { @@ -313,7 +313,7 @@ function wp_is_post_autosave( $post ) { * @access private * * @param int|WP_Post|array|null $post Post ID, post object OR post array. - * @param bool $autosave Optional. Is the revision an autosave? + * @param bool $autosave Optional. Whether the revision is an autosave or not. * @return int|WP_Error WP_Error or 0 if error, new revision ID if success. */ function _wp_put_post_revision( $post = null, $autosave = false ) { @@ -362,7 +362,7 @@ function _wp_put_post_revision( $post = null, $autosave = false ) { * @param string $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which * correspond to a WP_Post object, an associative array, or a numeric array, * respectively. Default OBJECT. - * @param string $filter Optional sanitation filter. See sanitize_post(). + * @param string $filter Optional sanitization filter. See sanitize_post(). * @return WP_Post|array|null WP_Post (or array) on success, or null on failure. */ function wp_get_post_revision( &$post, $output = OBJECT, $filter = 'raw' ) { @@ -613,7 +613,7 @@ function wp_get_post_revisions_url( $post = 0 ) { } /** - * Determine if revisions are enabled for a given post. + * Determines whether revisions are enabled for a given post. * * @since 3.6.0 * @@ -625,7 +625,7 @@ function wp_revisions_enabled( $post ) { } /** - * Determine how many revisions to retain for a given post. + * Determines how many revisions to retain for a given post. * * By default, an infinite number of revisions are kept. * @@ -830,16 +830,16 @@ function _wp_get_post_revision_version( $revision ) { } /** - * Upgrade the revisions author, add the current post as a revision and set the revisions version to 1 + * Upgrades the revisions author, adds the current post as a revision and sets the revisions version to 1. * * @since 3.6.0 * @access private * * @global wpdb $wpdb WordPress database abstraction object. * - * @param WP_Post $post Post object - * @param array $revisions Current revisions of the post - * @return bool true if the revisions were upgraded, false if problems + * @param WP_Post $post Post object. + * @param array $revisions Current revisions of the post. + * @return bool true if the revisions were upgraded, false if problems. */ function _wp_upgrade_revisions_of_post( $post, $revisions ) { global $wpdb;