Changeset 51885 for trunk/src/wp-includes/post.php

Timestamp:

10/04/2021 08:42:54 PM (4 years ago)

Author:

johnbillion

Message:

Docs: Miscellaneous inline documentation improvements, including:

• Document the post statuses global as an array of stdClass objects
• Document the taxonomies global as an array of WP_Taxonomy objects
• Document the return value of the post count functions as stdClass objects
• Fix some typos

See #53399

File:

• trunk/src/wp-includes/post.php (modified) (8 diffs)

trunk/src/wp-includes/post.php

@@ -950 +950 @@
  * @since 2.0.0
  *
- * @param int|WP_Post $post Optional. Post ID or post object. Defaults to global $post..
+ * @param int|WP_Post $post Optional. Post ID or post object. Defaults to global $post.
  * @return string|false Post status on success, false on failure.
  */
@@ -1078 +1078 @@
  * @since 3.0.0
  *
- * @global array $wp_post_statuses Inserts new post status object into the list
+ * @global stdClass[] $wp_post_statuses Inserts new post status object into the list
  *
  * @param string       $post_status Name of the post status.
@@ -1202 +1202 @@
  * @since 3.0.0
  *
- * @global array $wp_post_statuses List of post statuses.
+ * @global stdClass[] $wp_post_statuses List of post statuses.
  *
  * @see register_post_status()
  *
  * @param string $post_status The name of a registered post status.
- * @return object|null A post status object.
+ * @return stdClass|null A post status object.
  */
 function get_post_status_object( $post_status ) {
@@ -1224 +1224 @@
  * @since 3.0.0
  *
- * @global array $wp_post_statuses List of post statuses.
+ * @global stdClass[] $wp_post_statuses List of post statuses.
  *
  * @see register_post_status()
@@ -2818 +2818 @@
  * @param string $type Optional. Post type to retrieve count. Default 'post'.
  * @param string $perm Optional. 'readable' or empty. Default empty.
- * @return object Number of posts for each status.
+ * @return stdClass Number of posts for each status.
  */
 function wp_count_posts( $type = 'post', $perm = '' ) {
@@ -2871 +2871 @@
      * @since 3.7.0
      *
-     * @param object $counts An object containing the current post_type's post
-     *                       counts by status.
-     * @param string $type   Post type.
-     * @param string $perm   The permission to determine if the posts are 'readable'
-     *                       by the current user.
+     * @param stdClass $counts An object containing the current post_type's post
+     *                         counts by status.
+     * @param string   $type   Post type.
+     * @param string   $perm   The permission to determine if the posts are 'readable'
+     *                         by the current user.
      */
     return apply_filters( 'wp_count_posts', $counts, $type, $perm );
@@ -2894 +2894 @@
  * @param string|string[] $mime_type Optional. Array or comma-separated list of
  *                                   MIME patterns. Default empty.
- * @return object An object containing the attachment counts by mime type.
+ * @return stdClass An object containing the attachment counts by mime type.
  */
 function wp_count_attachments( $mime_type = '' ) {
@@ -2913 +2913 @@
      * @since 3.7.0
      *
-     * @param object          $counts    An object containing the attachment counts by
+     * @param stdClass        $counts    An object containing the attachment counts by
      *                                   mime type.
      * @param string|string[] $mime_type Array or comma-separated list of MIME patterns.