Docs: Various docblock fixes in wp-includes/revision.php, as per documentation standards.

See #55646.

Built from https://develop.svn.wordpress.org/trunk@54347


git-svn-id: http://core.svn.wordpress.org/trunk@53906 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
audrasjb 2022-09-28 14:47:12 +00:00
parent 2a81bee262
commit 525c52c873
2 changed files with 11 additions and 11 deletions

View File

@ -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;

View File

@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
$wp_version = '6.1-beta2-54346';
$wp_version = '6.1-beta2-54347';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.