Changeset 46288

Timestamp:

09/24/2019 12:53:09 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve consistency in @since tags for parameters that were made optional.

See #47110.

Location:

trunk/src

Files:

• wp-admin/includes/class-wp-privacy-policy-content.php (modified) (1 diff)
• wp-admin/includes/media.php (modified) (2 diffs)
• wp-includes/link-template.php (modified) (1 diff)
• wp-includes/post.php (modified) (1 diff)

trunk/src/wp-admin/includes/class-wp-privacy-policy-content.php

@@ -300 +300 @@
      *
      * @since 4.9.6
-     * @since 5.0.0 The $post parameter is now optional.
+     * @since 5.0.0 The `$post` parameter was made optional.
      *
      * @param WP_Post|null $post The currently edited post. Default null.

trunk/src/wp-admin/includes/media.php

@@ -433 +433 @@
  *
  * @since 2.6.0
- * @since 5.3.0 Made `$post_id` parameter optional.
+ * @since 5.3.0 The `$post_id` parameter was made optional.
  *
  * @param array  $file_array Array similar to a `$_FILES` upload array.
@@ -971 +971 @@
  * @since 4.2.0 Introduced the `$return` parameter.
  * @since 4.8.0 Introduced the 'id' option within the `$return` parameter.
- * @since 5.3.0 Made the `$post_id` parameter optional
+ * @since 5.3.0 The `$post_id` parameter was made optional.
  *
  * @param string $file    The URL of the image to download.

trunk/src/wp-includes/link-template.php

@@ -982 +982 @@
  *
  * @since 3.1.0
- * @since 4.5.0 The `$taxonomy` argument was made optional.
+ * @since 4.5.0 The `$taxonomy` parameter was made optional.
  *
  * @param int    $term_id     Term ID.

trunk/src/wp-includes/post.php

@@ -5114 +5114 @@
  *
  * @since 1.5.0
- * @since 4.6.0 Converted the `$page` parameter to optional.
+ * @since 4.6.0 The `$page` parameter was made optional.
  *
  * @param WP_Post|object|int $page Optional. Page ID or WP_Post object. Default is global $post.