Changeset 51957

Timestamp:

10/30/2021 08:15:59 PM (4 years ago)

Author:

johnbillion

Message:

Docs: Miscellaneous docblock improvements.

See #53399

Location:

trunk/src

Files:

• wp-admin/includes/media.php (modified) (1 diff)
• wp-includes/functions.php (modified) (1 diff)
• wp-includes/general-template.php (modified) (1 diff)

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

@@ -1522 +1522 @@
  * @global WP_Query $wp_the_query WordPress Query object.
  *
- * @param int   $post_id Optional. Post ID.
+ * @param int   $post_id Post ID.
  * @param array $errors  Errors for attachment, if any.
  * @return string

trunk/src/wp-includes/functions.php

@@ -566 +566 @@
  * @param string     $mysqlstring   Date or datetime field type from MySQL.
  * @param int|string $start_of_week Optional. Start of the week as an integer. Default empty string.
- * @return array Keys are 'start' and 'end'.
+ * @return int[] {
+ *     Week start and end dates as Unix timestamps.
+ *
+ *     @type int $start The week start date as a Unix timestamp.
+ *     @type int $end   The week end date as a Unix timestamp.
+ * }
  */
 function get_weekstartend( $mysqlstring, $start_of_week = '' ) {

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

@@ -190 +190 @@
 
     /**
-     * Fires before a template part is loaded.
+     * Fires before an attempt is made to locate and load a template part.
      *
      * @since 5.2.0