diff --git a/wp-admin/includes/media.php b/wp-admin/includes/media.php index 79fb8c2f0d..24f65818e4 100644 --- a/wp-admin/includes/media.php +++ b/wp-admin/includes/media.php @@ -169,7 +169,7 @@ function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $re } /** - * Adds image shortcode with caption to editor + * Adds image shortcode with caption to editor. * * @since 2.6.0 * @@ -248,7 +248,7 @@ function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $ } /** - * Private preg_replace callback used in image_add_caption() + * Private preg_replace callback used in image_add_caption(). * * @access private * @since 3.4.0 @@ -259,7 +259,7 @@ function _cleanup_image_add_caption( $matches ) { } /** - * Adds image html to editor + * Adds image HTML to editor. * * @since 2.5.0 * @@ -276,15 +276,15 @@ function media_send_to_editor( $html ) { } /** - * Save a file submitted from a POST request and create an attachment post for it. + * Saves a file submitted from a POST request and create an attachment post for it. * * @since 2.5.0 * * @param string $file_id Index of the `$_FILES` array that the file was sent. Required. * @param int $post_id The post ID of a post to attach the media item to. Required, but can * be set to 0, creating a media item that has no relationship to a post. - * @param array $post_data Overwrite some of the attachment. Optional. - * @param array $overrides Override the wp_handle_upload() behavior. Optional. + * @param array $post_data Optional. Overwrite some of the attachment. + * @param array $overrides Optional. Override the wp_handle_upload() behavior. * @return int|WP_Error ID of the attachment or a WP_Error object on failure. */ function media_handle_upload( $file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false ) ) { diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php index 3629a5ed3a..418b610c98 100644 --- a/wp-admin/includes/template.php +++ b/wp-admin/includes/template.php @@ -923,7 +923,7 @@ function parent_dropdown( $default = 0, $parent = 0, $level = 0, $post = null ) } /** - * Print out option html elements for role selectors. + * Print out option HTML elements for role selectors. * * @since 2.1.0 * @@ -1566,7 +1566,7 @@ function add_settings_section( $id, $title, $callback, $page ) { * do_settings_fields() in do_settings-sections() * * The $callback argument should be the name of a function that echoes out the - * html input tags for this setting field. Use get_option() to retrieve existing + * HTML input tags for this setting field. Use get_option() to retrieve existing * values to show. * * @since 2.7.0 @@ -1918,7 +1918,7 @@ function find_posts_div( $found_action = '' ) { /** * Displays the post password. * - * The password is passed through esc_attr() to ensure that it is safe for placing in an html attribute. + * The password is passed through esc_attr() to ensure that it is safe for placing in an HTML attribute. * * @since 2.7.0 */ diff --git a/wp-content/themes/twentytwenty/inc/template-tags.php b/wp-content/themes/twentytwenty/inc/template-tags.php index ba4e9151de..5e3de17f7d 100644 --- a/wp-content/themes/twentytwenty/inc/template-tags.php +++ b/wp-content/themes/twentytwenty/inc/template-tags.php @@ -70,7 +70,7 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) { /** * Filters the arguments for `twentytwenty_site_logo()`. * - * @param string $html Compiled html based on our arguments. + * @param string $html Compiled HTML based on our arguments. * @param array $args Parsed arguments. * @param string $classname Class name based on current view, home or single. * @param string $contents HTML for site title or logo. @@ -103,7 +103,7 @@ function twentytwenty_site_description( $echo = true ) { $html = sprintf( $wrapper, esc_html( $description ) ); /** - * Filters the html for the site description. + * Filters the HTML for the site description. * * @since Twenty Twenty 1.0 * @@ -326,7 +326,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) ` diff --git a/wp-includes/class-wp-customize-nav-menus.php b/wp-includes/class-wp-customize-nav-menus.php index 962a3ce60c..02fce9454a 100644 --- a/wp-includes/class-wp-customize-nav-menus.php +++ b/wp-includes/class-wp-customize-nav-menus.php @@ -1127,7 +1127,7 @@ final class WP_Customize_Nav_Menus { } /** - * Print the html template used to render the add-menu-item frame. + * Print the HTML template used to render the add-menu-item frame. * * @since 4.3.0 */ diff --git a/wp-includes/comment.php b/wp-includes/comment.php index ca1f77b560..055d1d11e5 100644 --- a/wp-includes/comment.php +++ b/wp-includes/comment.php @@ -2734,7 +2734,7 @@ function discover_pingback_server_uri( $url, $deprecated = '' ) { return false; } - // Now do a GET since we're going to look in the html headers (and we're sure it's not a binary file). + // Now do a GET since we're going to look in the HTML headers (and we're sure it's not a binary file). $response = wp_safe_remote_get( $url, array( diff --git a/wp-includes/deprecated.php b/wp-includes/deprecated.php index 1434cfba25..a568b44650 100644 --- a/wp-includes/deprecated.php +++ b/wp-includes/deprecated.php @@ -379,18 +379,23 @@ function user_can_edit_user($user_id, $other_user) { * @deprecated 2.1.0 Use get_bookmarks() * @see get_bookmarks() * - * @param string $cat_name Optional. The category name to use. If no match is found uses all. - * @param string $before Optional. The html to output before the link. - * @param string $after Optional. The html to output after the link. - * @param string $between Optional. The html to output between the link/image and its description. Not used if no image or $show_images is true. - * @param bool $show_images Optional. Whether to show images (if defined). - * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner. - * If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a - * random order. - * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. - * @param bool $show_rating Optional. Show rating stars/chars. - * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated Optional. Whether to show last updated timestamp + * @param string $cat_name Optional. The category name to use. If no match is found, uses all. + * Default 'noname'. + * @param string $before Optional. The HTML to output before the link. Default empty. + * @param string $after Optional. The HTML to output after the link. Default '
'. + * @param string $between Optional. The HTML to output between the link/image and its description. + * Not used if no image or $show_images is true. Default ' '. + * @param bool $show_images Optional. Whether to show images (if defined). Default true. + * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', + * 'description', 'rating', or 'owner'. Default 'id'. + * If you start the name with an underscore, the order will be reversed. + * Specifying 'rand' as the order will return links in a random order. + * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. + * Default true. + * @param bool $show_rating Optional. Show rating stars/chars. Default false. + * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. + * Default -1. + * @param int $show_updated Optional. Whether to show last updated timestamp. Default 0. */ function get_linksbyname($cat_name = "noname", $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $show_rating = false, @@ -447,11 +452,14 @@ function wp_get_linksbyname($category, $args = '') { * @deprecated 2.1.0 Use get_bookmarks() * @see get_bookmarks() * - * @param string $cat_name The category name to use. If no match is found uses all. - * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. - * Or maybe owner. If you start the name with an underscore the order will be reversed. You can also - * specify 'rand' as the order which will return links in a random order. - * @param int $limit Limit to X entries. If not specified, all entries are shown. + * @param string $cat_name Optional. The category name to use. If no match is found, uses all. + * Default 'noname'. + * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', + * 'description', 'rating', or 'owner'. Default 'name'. + * If you start the name with an underscore, the order will be reversed. + * Specifying 'rand' as the order will return links in a random order. + * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. + * Default -1. * @return array */ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) { @@ -497,12 +505,14 @@ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit * @deprecated 2.1.0 Use get_bookmarks() * @see get_bookmarks() * - * @param int $category The category to use. If no category supplied uses all - * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. If you start the name with an - * underscore the order will be reversed. You can also specify 'rand' as the - * order which will return links in a random order. - * @param int $limit Limit to X entries. If not specified, all entries are shown. + * @param int $category Optional. The category to use. If no category supplied, uses all. + * Default 0. + * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', + * 'description', 'rating', or 'owner'. Default 'name'. + * If you start the name with an underscore, the order will be reversed. + * Specifying 'rand' as the order will return links in a random order. + * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. + * Default 0. * @return array */ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { @@ -524,18 +534,22 @@ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { * @deprecated 2.1.0 Use get_bookmarks() * @see get_bookmarks() * - * @param string $cat_name The category name to use. If no match is found uses all - * @param string $before The html to output before the link - * @param string $after The html to output after the link - * @param string $between The html to output between the link/image and its description. Not used if no image or show_images is true - * @param bool $show_images Whether to show images (if defined). - * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. If you start the name with an - * underscore the order will be reversed. You can also specify 'rand' as the - * order which will return links in a random order. - * @param bool $show_description Whether to show the description if show_images=false/not defined - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated Whether to show last updated timestamp + * @param string $cat_name Optional. The category name to use. If no match is found, uses all. + * Default 'noname'. + * @param string $before Optional. The HTML to output before the link. Default empty. + * @param string $after Optional. The HTML to output after the link. Default '
'. + * @param string $between Optional. The HTML to output between the link/image and its description. + * Not used if no image or $show_images is true. Default ' '. + * @param bool $show_images Optional. Whether to show images (if defined). Default true. + * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', + * 'description', 'rating', or 'owner'. Default 'id'. + * If you start the name with an underscore, the order will be reversed. + * Specifying 'rand' as the order will return links in a random order. + * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. + * Default true. + * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. + * Default -1. + * @param int $show_updated Optional. Whether to show last updated timestamp. Default 0. */ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { @@ -551,18 +565,22 @@ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = * @deprecated 2.1.0 Use get_bookmarks() * @see get_bookmarks() * - * @param int $category The category to use. If no category supplied uses all - * @param string $before The html to output before the link - * @param string $after The html to output after the link - * @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true - * @param bool $show_images Whether to show images (if defined). - * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. If you start the name with an - * underscore the order will be reversed. You can also specify 'rand' as the - * order which will return links in a random order. - * @param bool $show_description Whether to show the description if show_images=false/not defined. - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated Whether to show last updated timestamp + * @param int $category Optional. The category to use. If no category supplied, uses all. + * Default 0. + * @param string $before Optional. The HTML to output before the link. Default empty. + * @param string $after Optional. The HTML to output after the link. Default '
'. + * @param string $between Optional. The HTML to output between the link/image and its description. + * Not used if no image or $show_images is true. Default ' '. + * @param bool $show_images Optional. Whether to show images (if defined). Default true. + * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', + * 'description', 'rating', or 'owner'. Default 'id'. + * If you start the name with an underscore, the order will be reversed. + * Specifying 'rand' as the order will return links in a random order. + * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. + * Default true. + * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. + * Default -1. + * @param int $show_updated Optional. Whether to show last updated timestamp. Default 0. */ function get_links_withrating($category = -1, $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { @@ -904,21 +922,24 @@ function wp_get_links($args = '') { * @deprecated 2.1.0 Use get_bookmarks() * @see get_bookmarks() * - * @param int $category The category to use. If no category supplied uses all - * @param string $before the html to output before the link - * @param string $after the html to output after the link - * @param string $between the html to output between the link/image and its description. - * Not used if no image or show_images == true - * @param bool $show_images whether to show images (if defined). - * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. If you start the name with an - * underscore the order will be reversed. You can also specify 'rand' as the order - * which will return links in a random order. - * @param bool $show_description whether to show the description if show_images=false/not defined. - * @param bool $show_rating show rating stars/chars - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated whether to show last updated timestamp - * @param bool $echo whether to echo the results, or return them instead + * @param int $category Optional. The category to use. If no category supplied uses all. + * Default 0. + * @param string $before Optional. The HTML to output before the link. Default empty. + * @param string $after Optional. The HTML to output after the link. Default '
'. + * @param string $between Optional. The HTML to output between the link/image and its description. + * Not used if no image or $show_images is true. Default ' '. + * @param bool $show_images Optional. Whether to show images (if defined). Default true. + * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', + * 'description', 'rating', or 'owner'. Default 'name'. + * If you start the name with an underscore, the order will be reversed. + * Specifying 'rand' as the order will return links in a random order. + * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. + * Default true. + * @param bool $show_rating Optional. Show rating stars/chars. Default false. + * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. + * Default -1. + * @param int $show_updated Optional. Whether to show last updated timestamp. Default 1. + * @param bool $echo Whether to echo the results, or return them instead. * @return null|string */ function get_links($category = -1, $before = '', $after = '
', $between = ' ', $show_images = true, $orderby = 'name', @@ -1628,30 +1649,31 @@ function the_author_ID() { /** * Display the post content for the feed. * - * For encoding the html or the $encode_html parameter, there are three possible - * values. '0' will make urls footnotes and use make_url_footnote(). '1' will - * encode special characters and automatically display all of the content. The - * value of '2' will strip all HTML tags from the content. + * For encoding the HTML or the $encode_html parameter, there are three possible values: + * - '0' will make urls footnotes and use make_url_footnote(). + * - '1' will encode special characters and automatically display all of the content. + * - '2' will strip all HTML tags from the content. * - * Also note that you cannot set the amount of words and not set the html - * encoding. If that is the case, then the html encoding will default to 2, - * which will strip all HTML tags. + * Also note that you cannot set the amount of words and not set the HTML encoding. + * If that is the case, then the HTML encoding will default to 2, which will strip + * all HTML tags. * - * To restrict the amount of words of the content, you can use the cut - * parameter. If the content is less than the amount, then there won't be any - * dots added to the end. If there is content left over, then dots will be added - * and the rest of the content will be removed. + * To restrict the amount of words of the content, you can use the cut parameter. + * If the content is less than the amount, then there won't be any dots added to the end. + * If there is content left over, then dots will be added and the rest of the content + * will be removed. * * @since 0.71 * * @deprecated 2.9.0 Use the_content_feed() * @see the_content_feed() * - * @param string $more_link_text Optional. Text to display when more content is available but not displayed. - * @param int $stripteaser Optional. Default is 0. - * @param string $more_file Optional. - * @param int $cut Optional. Amount of words to keep for the content. - * @param int $encode_html Optional. How to encode the content. + * @param string $more_link_text Optional. Text to display when more content is available + * but not displayed. Default '(more...)'. + * @param int $stripteaser Optional. Default 0. + * @param string $more_file Optional. + * @param int $cut Optional. Amount of words to keep for the content. + * @param int $encode_html Optional. How to encode the content. */ function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) { _deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed()' ); @@ -1704,7 +1726,7 @@ function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file * @since 0.71 * @deprecated 2.9.0 * - * @param string $content Content to get links + * @param string $content Content to get links. * @return string HTML stripped out of content with links at the bottom. */ function make_url_footnote( $content ) { @@ -1742,9 +1764,9 @@ function make_url_footnote( $content ) { * @deprecated 2.9.0 Use _x() * @see _x() * - * @param string $text Text to translate - * @param string $domain Optional. Domain to retrieve the translated text - * @return string Translated context string without pipe + * @param string $text Text to translate. + * @param string $domain Optional. Domain to retrieve the translated text. + * @return string Translated context string without pipe. */ function _c( $text, $domain = 'default' ) { _deprecated_function( __FUNCTION__, '2.9.0', '_x()' ); @@ -1759,9 +1781,9 @@ function _c( $text, $domain = 'default' ) { * @deprecated 3.0.0 Use _x() * @see _x() * - * @param string $text Text to translate - * @param string $domain Domain to retrieve the translated text - * @return string Translated text + * @param string $text Text to translate. + * @param string $domain Domain to retrieve the translated text. + * @return string Translated text. */ function translate_with_context( $text, $domain = 'default' ) { _deprecated_function( __FUNCTION__, '2.9.0', '_x()' ); diff --git a/wp-includes/feed.php b/wp-includes/feed.php index 7c2f8f350d..ca52d98373 100644 --- a/wp-includes/feed.php +++ b/wp-includes/feed.php @@ -535,12 +535,12 @@ function atom_enclosure() { /** * Determine the type of a string of data with the data formatted. * - * Tell whether the type is text, html, or xhtml, per RFC 4287 section 3.1. + * Tell whether the type is text, HTML, or XHTML, per RFC 4287 section 3.1. * * In the case of WordPress, text is defined as containing no markup, - * xhtml is defined as "well formed", and html as tag soup (i.e., the rest). + * XHTML is defined as "well formed", and HTML as tag soup (i.e., the rest). * - * Container div tags are added to xhtml values, per section 3.1.1.3. + * Container div tags are added to XHTML values, per section 3.1.1.3. * * @link http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.3.1 * diff --git a/wp-includes/formatting.php b/wp-includes/formatting.php index 285134f21f..3840e92217 100644 --- a/wp-includes/formatting.php +++ b/wp-includes/formatting.php @@ -928,7 +928,7 @@ function seems_utf8( $str ) { * double if set to 'double' or both if otherwise set. * Default is ENT_NOQUOTES. * @param false|string $charset Optional. The character encoding of the string. Default false. - * @param bool $double_encode Optional. Whether to encode existing html entities. Default false. + * @param bool $double_encode Optional. Whether to encode existing HTML entities. Default false. * @return string The encoded text with HTML entities. */ function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) { @@ -5136,7 +5136,7 @@ function wp_sprintf_l( $pattern, $args ) { } /** - * Safely extracts not more than the first $count characters from html string. + * Safely extracts not more than the first $count characters from HTML string. * * UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT* * be counted as one character. For example & will be counted as 4, < as @@ -6013,7 +6013,7 @@ function sanitize_hex_color( $color ) { * * Saving hex colors without a hash puts the burden of adding the hash on the * UI, which makes it difficult to use or upgrade to other color types such as - * rgba, hsl, rgb, and html color names. + * rgba, hsl, rgb, and HTML color names. * * Returns either '', a 3 or 6 digit hex color (without a #), or null. * diff --git a/wp-includes/functions.php b/wp-includes/functions.php index 09a5c17ff3..3056eec29d 100644 --- a/wp-includes/functions.php +++ b/wp-includes/functions.php @@ -6559,7 +6559,7 @@ function get_tag_regex( $tag ) { /** * Retrieve a canonical form of the provided charset appropriate for passing to PHP - * functions such as htmlspecialchars() and charset html attributes. + * functions such as htmlspecialchars() and charset HTML attributes. * * @since 3.6.0 * @access private diff --git a/wp-includes/general-template.php b/wp-includes/general-template.php index 9f3f2cfc13..6827b425e7 100644 --- a/wp-includes/general-template.php +++ b/wp-includes/general-template.php @@ -3915,7 +3915,7 @@ function wp_get_code_editor_settings( $args ) { * Retrieves the contents of the search WordPress query variable. * * The search query string is passed through esc_attr() to ensure that it is safe - * for placing in an html attribute. + * for placing in an HTML attribute. * * @since 2.3.0 * @@ -3943,7 +3943,7 @@ function get_search_query( $escaped = true ) { * Displays the contents of the search query variable. * * The search query string is passed through esc_attr() to ensure that it is safe - * for placing in an html attribute. + * for placing in an HTML attribute. * * @since 2.1.0 */ @@ -3959,14 +3959,14 @@ function the_search_query() { } /** - * Gets the language attributes for the html tag. + * Gets the language attributes for the 'html' tag. * - * Builds up a set of html attributes containing the text direction and language + * Builds up a set of HTML attributes containing the text direction and language * information for the page. * * @since 4.3.0 * - * @param string $doctype Optional. The type of html document. Accepts 'xhtml' or 'html'. Default 'html'. + * @param string $doctype Optional. The type of HTML document. Accepts 'xhtml' or 'html'. Default 'html'. */ function get_language_attributes( $doctype = 'html' ) { $attributes = array(); @@ -3989,27 +3989,27 @@ function get_language_attributes( $doctype = 'html' ) { $output = implode( ' ', $attributes ); /** - * Filters the language attributes for display in the html tag. + * Filters the language attributes for display in the 'html' tag. * * @since 2.5.0 * @since 4.3.0 Added the `$doctype` parameter. * * @param string $output A space-separated list of language attributes. - * @param string $doctype The type of html document (xhtml|html). + * @param string $doctype The type of HTML document (xhtml|html). */ return apply_filters( 'language_attributes', $output, $doctype ); } /** - * Displays the language attributes for the html tag. + * Displays the language attributes for the 'html' tag. * - * Builds up a set of html attributes containing the text direction and language + * Builds up a set of HTML attributes containing the text direction and language * information for the page. * * @since 2.1.0 * @since 4.3.0 Converted into a wrapper for get_language_attributes(). * - * @param string $doctype Optional. The type of html document. Accepts 'xhtml' or 'html'. Default 'html'. + * @param string $doctype Optional. The type of HTML document. Accepts 'xhtml' or 'html'. Default 'html'. */ function language_attributes( $doctype = 'html' ) { echo get_language_attributes( $doctype ); @@ -4654,7 +4654,7 @@ function get_the_generator( $type = '' ) { } /** - * Outputs the html checked attribute. + * Outputs the HTML checked attribute. * * Compares the first two arguments and if identical marks as checked * @@ -4663,14 +4663,14 @@ function get_the_generator( $type = '' ) { * @param mixed $checked One of the values to compare * @param mixed $current (true) The other value to compare if not just true * @param bool $echo Whether to echo or just return the string - * @return string html attribute or empty string + * @return string HTML attribute or empty string */ function checked( $checked, $current = true, $echo = true ) { return __checked_selected_helper( $checked, $current, $echo, 'checked' ); } /** - * Outputs the html selected attribute. + * Outputs the HTML selected attribute. * * Compares the first two arguments and if identical marks as selected * @@ -4679,14 +4679,14 @@ function checked( $checked, $current = true, $echo = true ) { * @param mixed $selected One of the values to compare * @param mixed $current (true) The other value to compare if not just true * @param bool $echo Whether to echo or just return the string - * @return string html attribute or empty string + * @return string HTML attribute or empty string */ function selected( $selected, $current = true, $echo = true ) { return __checked_selected_helper( $selected, $current, $echo, 'selected' ); } /** - * Outputs the html disabled attribute. + * Outputs the HTML disabled attribute. * * Compares the first two arguments and if identical marks as disabled * @@ -4695,14 +4695,14 @@ function selected( $selected, $current = true, $echo = true ) { * @param mixed $disabled One of the values to compare * @param mixed $current (true) The other value to compare if not just true * @param bool $echo Whether to echo or just return the string - * @return string html attribute or empty string + * @return string HTML attribute or empty string */ function disabled( $disabled, $current = true, $echo = true ) { return __checked_selected_helper( $disabled, $current, $echo, 'disabled' ); } /** - * Outputs the html readonly attribute. + * Outputs the HTML readonly attribute. * * Compares the first two arguments and if identical marks as readonly * @@ -4711,7 +4711,7 @@ function disabled( $disabled, $current = true, $echo = true ) { * @param mixed $readonly One of the values to compare * @param mixed $current (true) The other value to compare if not just true * @param bool $echo Whether to echo or just return the string - * @return string html attribute or empty string + * @return string HTML attribute or empty string */ function readonly( $readonly, $current = true, $echo = true ) { return __checked_selected_helper( $readonly, $current, $echo, 'readonly' ); @@ -4729,7 +4729,7 @@ function readonly( $readonly, $current = true, $echo = true ) { * @param mixed $current (true) The other value to compare if not just true * @param bool $echo Whether to echo or just return the string * @param string $type The type of checked|selected|disabled|readonly we are doing - * @return string html attribute or empty string + * @return string HTML attribute or empty string */ function __checked_selected_helper( $helper, $current, $echo, $type ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore if ( (string) $helper === (string) $current ) { diff --git a/wp-includes/kses.php b/wp-includes/kses.php index 2009a67686..154c10e277 100644 --- a/wp-includes/kses.php +++ b/wp-includes/kses.php @@ -2390,7 +2390,7 @@ function safecss_filter_attr( $css, $deprecated = '' ) { } /** - * Helper function to add global attributes to a tag in the allowed html list. + * Helper function to add global attributes to a tag in the allowed HTML list. * * @since 3.5.0 * @since 5.0.0 Add support for `data-*` wildcard attributes. diff --git a/wp-includes/version.php b/wp-includes/version.php index d7ba303567..fbade61272 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.5-alpha-48198'; +$wp_version = '5.5-alpha-48199'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.