Docs: Improve documentation for a few functions accepting a `WP_Post` object.

Follow-up to [15777], [23769], [24490], [25697], [37252], [49544].

See #60699.
Built from https://develop.svn.wordpress.org/trunk@58212


git-svn-id: http://core.svn.wordpress.org/trunk@57675 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/includes/post.php

@@ -1139,7 +1139,7 @@ function update_meta( $meta_id, $meta_key, $meta_value ) {
  * @since 2.3.0
  * @access private
  *
- * @param int|object $post Post ID or post object.
+ * @param int|WP_Post $post Post ID or post object.
  * @return void|int|WP_Error Void if nothing fixed. 0 or WP_Error on update failure. The post ID on update success.
  */
 function _fix_attachment_links( $post ) {

wp-includes/link-template.php

@@ -465,7 +465,7 @@ function _get_page_link( $post = false, $leavename = false, $sample = false ) {
  *
  * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
  *
- * @param int|object $post      Optional. Post ID or object. Default uses the global `$post`.
+ * @param int|WP_Post $post      Optional. Post ID or object. Default uses the global `$post`.
  * @param bool        $leavename Optional. Whether to keep the page name. Default false.
  * @return string The attachment permalink.
  */

wp-includes/post-formats.php

@@ -63,7 +63,7 @@ function has_post_format( $format = array(), $post = null ) {
  *
  * @since 3.1.0
  *
- * @param int|object $post   The post for which to assign a format.
+ * @param int|WP_Post $post   The post for which to assign a format.
  * @param string      $format A format to assign. Use an empty string or array to remove all formats from the post.
  * @return array|WP_Error|false Array of affected term IDs on success. WP_Error on error.
  */

wp-includes/post-template.php

@@ -1861,7 +1861,7 @@ function get_page_template_slug( $post = null ) {
  *
  * @since 2.6.0
  *
- * @param int|object $revision Revision ID or revision object.
+ * @param int|WP_Post $revision Revision ID or revision object.
  * @param bool        $link     Optional. Whether to link to revision's page. Default true.
  * @return string|false i18n formatted datetimestamp or localized 'Current Revision'.
  */
@@ -1903,7 +1903,7 @@ function wp_post_revision_title( $revision, $link = true ) {
  *
  * @since 3.6.0
  *
- * @param int|object $revision Revision ID or revision object.
+ * @param int|WP_Post $revision Revision ID or revision object.
  * @param bool        $link     Optional. Whether to link to revision's page. Default true.
  * @return string|false gravatar, user, i18n formatted datetimestamp or localized 'Current Revision'.
  */

wp-includes/version.php

@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '6.6-alpha-58211';
+$wp_version = '6.6-alpha-58212';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.