diff --git a/src/wp-includes/author-template.php b/src/wp-includes/author-template.php index 5dc618b7a5..26c1a6a930 100644 --- a/src/wp-includes/author-template.php +++ b/src/wp-includes/author-template.php @@ -183,6 +183,8 @@ function the_author_meta( $field = '', $user_id = false ) { * If the author has a home page set, return an HTML link, otherwise just return the * author's name. * + * @since 3.0.0 + * * @return string|null An HTML link if the author's url exist in user meta, * else the result of get_the_author(). */ @@ -502,6 +504,8 @@ function is_multi_author() { /** * Helper function to clear the cache for number of authors. * + * @since 3.2.0 + * * @private */ function __clear_multi_author_cache() { diff --git a/src/wp-includes/category-template.php b/src/wp-includes/category-template.php index 5987daca82..e9b3428f38 100644 --- a/src/wp-includes/category-template.php +++ b/src/wp-includes/category-template.php @@ -720,8 +720,10 @@ function wp_tag_cloud( $args = '' ) { /** * Default topic count scaling for tag links * - * @param int $count number of posts with that tag - * @return int scaled count + * @since 2.9.0 + * + * @param int $count Number of posts with that tag. + * @return int Scaled count. */ function default_topic_count_scale( $count ) { return round(log10($count + 1) * 100); diff --git a/src/wp-includes/functions.php b/src/wp-includes/functions.php index 8593e8c923..0eeb60ccec 100644 --- a/src/wp-includes/functions.php +++ b/src/wp-includes/functions.php @@ -1921,6 +1921,7 @@ function wp_upload_dir( $time = null, $create_dir = true, $refresh_cache = false /** * A non-filtered, non-cached version of wp_upload_dir() that doesn't check the path. * + * @since 4.5.0 * @access private * * @param string $time Optional. Time formatted in 'yyyy/mm'. Default null. @@ -5108,6 +5109,8 @@ function _device_can_upload() { /** * Test if a given path is a stream URL * + * @since 3.5.0 + * * @param string $path The resource path or URL. * @return bool True if the path is a stream URL. */ diff --git a/src/wp-includes/general-template.php b/src/wp-includes/general-template.php index ed91e5bd17..2c3f91cfdf 100644 --- a/src/wp-includes/general-template.php +++ b/src/wp-includes/general-template.php @@ -808,7 +808,7 @@ function get_site_icon_url( $size = 512, $url = '', $blog_id = 0 ) { /** * Filters the site icon URL. * - * @site 4.4.0 + * @since 4.4.0 * * @param string $url Site icon URL. * @param int $size Size of the site icon. diff --git a/src/wp-includes/kses.php b/src/wp-includes/kses.php index 4745d8d7ef..b567e10cde 100644 --- a/src/wp-includes/kses.php +++ b/src/wp-includes/kses.php @@ -1449,6 +1449,7 @@ function wp_kses_normalize_entities2($matches) { * This function helps wp_kses_normalize_entities() to only accept valid Unicode * numeric entities in hex form. * + * @since 2.7.0 * @access private * * @param array $matches preg_replace_callback() matches array @@ -1465,6 +1466,8 @@ function wp_kses_normalize_entities3($matches) { /** * Helper function to determine if a Unicode value is valid. * + * @since 2.7.0 + * * @param int $i Unicode value * @return bool True if the value was a valid Unicode number */ @@ -1497,6 +1500,8 @@ function wp_kses_decode_entities($string) { /** * Regex callback for wp_kses_decode_entities() * + * @since 2.9.0 + * * @param array $match preg match * @return string */ @@ -1507,6 +1512,8 @@ function _wp_kses_decode_entities_chr( $match ) { /** * Regex callback for wp_kses_decode_entities() * + * @since 2.9.0 + * * @param array $match preg match * @return string */ diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php index deb18a40b6..5f10503863 100644 --- a/src/wp-includes/media.php +++ b/src/wp-includes/media.php @@ -1045,6 +1045,8 @@ function wp_calculate_image_srcset( $size_array, $image_src, $image_meta, $attac /** * Let plugins pre-filter the image meta to be able to fix inconsistencies in the stored data. * + * @since 4.5.0 + * * @param array $image_meta The image meta data as returned by 'wp_get_attachment_metadata()'. * @param array $size_array Array of width and height values in pixels (in that order). * @param string $image_src The 'src' of the image. diff --git a/src/wp-includes/ms-functions.php b/src/wp-includes/ms-functions.php index 2e9ca946d9..2c356cae26 100644 --- a/src/wp-includes/ms-functions.php +++ b/src/wp-includes/ms-functions.php @@ -2242,7 +2242,7 @@ function wp_schedule_update_network_counts() { /** * Update the network-wide counts for the current network. * - * @since 3.1.0 + * @since 3.1.0 */ function wp_update_network_counts() { wp_update_network_user_counts(); diff --git a/src/wp-includes/nav-menu.php b/src/wp-includes/nav-menu.php index 30039f420e..0710055c79 100644 --- a/src/wp-includes/nav-menu.php +++ b/src/wp-includes/nav-menu.php @@ -96,6 +96,7 @@ function register_nav_menus( $locations = array() ) { /** * Unregisters a navigation menu location for a theme. * + * @since 3.1.0 * @global array $_wp_registered_nav_menus * * @param string $location The menu location identifier. diff --git a/src/wp-includes/rest-api.php b/src/wp-includes/rest-api.php index e5efb74fbe..8c252b4d1c 100644 --- a/src/wp-includes/rest-api.php +++ b/src/wp-includes/rest-api.php @@ -988,6 +988,8 @@ function rest_get_avatar_sizes() { /** * Validate a value based on a schema. * + * @since 4.7.0 + * * @param mixed $value The value to validate. * @param array $args Schema array to use for validation. * @param string $param The parameter name, used in error messages. @@ -1110,6 +1112,8 @@ function rest_validate_value_from_schema( $value, $args, $param = '' ) { /** * Sanitize a value based on a schema. * + * @since 4.7.0 + * * @param mixed $value The value to sanitize. * @param array $args Schema array to use for sanitization. * @return true|WP_Error diff --git a/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php b/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php index c037ae2107..2c5d9fc76a 100644 --- a/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php +++ b/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php @@ -1518,6 +1518,8 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { * "Protected: %s", as the REST API communicates the protected status of a post * in a machine readable format, we remove the "Protected: " prefix. * + * @since 4.7.0 + * * @return string Protected title format. */ public function protected_title_format() { diff --git a/src/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php b/src/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php index 3bf74317a2..2b8e265c93 100644 --- a/src/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php +++ b/src/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php @@ -305,6 +305,8 @@ class WP_REST_Settings_Controller extends WP_REST_Controller { * `null` as it's not a valid value for something like "type => string". We * provide a wrapper sanitizer to whitelist the use of `null`. * + * @since 4.7.0 + * * @param mixed $value The value for the setting. * @param WP_REST_Request $request The request object. * @param string $param The parameter name. diff --git a/src/wp-includes/vars.php b/src/wp-includes/vars.php index 9c9cb33dd4..2e97c9a0ae 100644 --- a/src/wp-includes/vars.php +++ b/src/wp-includes/vars.php @@ -120,6 +120,8 @@ $is_iis7 = $is_IIS && intval( substr( $_SERVER['SERVER_SOFTWARE'], strpos( $_SER /** * Test if the current browser runs on a mobile device (smart phone, tablet, etc.) * + * @since 3.4.0 + * * @return bool */ function wp_is_mobile() {