Changeset 60682

Timestamp:

08/27/2025 01:40:57 PM (6 months ago)

Author:

SergeyBiryukov

Message:

Docs: Correct the order of @since and @global tags in some files.

Follow-up to [9053], [13177], [16660], [32642], [37226], [54953], [59865], [60658].

Props viralsampat, shailu25, sandipsinh007.
Fixes #63879. See #63166.

Location:

trunk/src

Files:

• wp-admin/includes/template.php (modified) (2 diffs)
• wp-admin/nav-menus.php (modified) (1 diff)
• wp-includes/ms-settings.php (modified) (2 diffs)
• wp-includes/option.php (modified) (1 diff)

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

@@ -1752 +1752 @@
  * add_settings_section() and add_settings_field()
  *
+ * @since 2.7.0
+ *
  * @global array $wp_settings_sections Storage array of all settings sections added to admin pages.
  * @global array $wp_settings_fields Storage array of settings fields and info about their pages/sections.
- * @since 2.7.0
  *
  * @param string $page The slug name of the page whose settings sections you want to output.
@@ -1801 +1802 @@
  * rather than directly.
  *
+ * @since 2.7.0
+ *
  * @global array $wp_settings_fields Storage array of settings fields and their pages/sections.
- *
- * @since 2.7.0
  *
  * @param string $page Slug title of the admin page whose settings fields you want to show.

trunk/src/wp-admin/nav-menus.php

@@ -673 +673 @@
 
 /**
+ * @since 3.0.0
+ *
  * @global int $_wp_nav_menu_max_depth
- *
- * @since 3.0.0
  *
  * @param string $classes

trunk/src/wp-includes/ms-settings.php

@@ -22 +22 @@
  * file will attempt to populate them based on the current request.
  *
+ * @since 3.0.0
+ *
  * @global WP_Network $current_site The current network.
  * @global object     $current_blog The current site.
@@ -32 +34 @@
  * @global bool       $public       Deprecated. Whether the site found on load is public.
  *                                  Use `get_site()->public` instead.
- *
- * @since 3.0.0
  */
 global $current_site, $current_blog, $domain, $path, $site_id, $public;

trunk/src/wp-includes/option.php

@@ -1630 +1630 @@
  * from table a, and the corresponding transient_timeout record from table b.
  *
+ * @since 4.9.0
+ *
  * @global wpdb $wpdb WordPress database abstraction object.
- *
- * @since 4.9.0
  *
  * @param bool $force_db Optional. Force cleanup to run against the database even when an external object cache is used.