Docs: Replace "html" and "xhtml" instances in DocBlocks and comments with "HTML" and "XHTML".

This ensures consistent capitalization where appropriate.

Props navidos, desrosj.
Fixes #50473.
Built from https://develop.svn.wordpress.org/trunk@48199


git-svn-id: http://core.svn.wordpress.org/trunk@47968 1a063a9b-81f0-0310-95a4-ce76da25c4cd

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  $post_data Optional. Overwrite some of the attachment.
- * @param array  $overrides Override the wp_handle_upload() behavior. Optional.
+ * @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 ) ) {

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
  */

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' )
 				<?php
 
 				/**
-				 * Fires before post meta html display.
+				 * Fires before post meta HTML display.
 				 *
 				 * Allow output of additional post meta info to be added by child themes and plugins.
 				 *
@@ -453,7 +453,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
 				}
 
 				/**
-				 * Fires after post meta html display.
+				 * Fires after post meta HTML display.
 				 *
 				 * Allow output of additional post meta info to be added by child themes and plugins.
 				 *

wp-includes/class-wp-ajax-response.php

@@ -55,7 +55,7 @@ class WP_Ajax_Response {
 	 *     @type int|false       $old_id       The previous response ID. Used as the value for the response type
 	 *                                         `old_id` attribute. False hides the attribute. Default false.
 	 *     @type string          $position     Value of the response type `position` attribute. Accepts 1 (bottom),
-	 *                                         -1 (top), html ID (after), or -html ID (before). Default 1 (bottom).
+	 *                                         -1 (top), HTML ID (after), or -HTML ID (before). Default 1 (bottom).
 	 *     @type string|WP_Error $data         The response content/message. Also accepts a WP_Error object if the
 	 *                                         ID does not exist. Default empty.
 	 *     @type array           $supplemental An array of extra strings that will be output within a `<supplemental>`

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
 	 */

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(

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 $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.
+ *                                 Default 'noname'.
- * @param string $after Optional. The html to output after the link.
+ * @param string $before           Optional. The HTML to output before the link. Default empty.
- * @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 string $after            Optional. The HTML to output after the link. Default '<br />'.
- * @param bool $show_images Optional. Whether to show images (if defined).
+ * @param string $between          Optional. The HTML to output between the link/image and its description.
- * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner.
+ *                                 Not used if no image or $show_images is true. Default ' '.
- *		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
+ * @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
- *		random order.
+ * @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.
- * @param bool $show_rating Optional. Show rating stars/chars.
+ *                                 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.
- * @param int $show_updated Optional. Whether to show last updated timestamp
+ *                                 Default -1.
+ * @param int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.
  */
 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $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 $cat_name Optional. 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'.
+ *                         Default 'noname'.
- *		Or maybe owner. If you start the name with an underscore the order will be reversed. You can also
+ * @param string $orderby  Optional. The order to output the links. E.g. 'id', 'name', 'url',
- *		specify 'rand' as the order which will return links in a random order.
+ *                         'description', 'rating', or 'owner'. Default 'name'.
- * @param int $limit Limit to X entries. If not specified, all entries are shown.
+ *                         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 int    $category Optional. The category to use. If no category supplied, uses all.
- * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
+ *                         Default 0.
- *		'description', or 'rating'. Or maybe owner. If you start the name with an
+ * @param string $orderby  Optional. The order to output the links. E.g. 'id', 'name', 'url',
- *		underscore the order will be reversed. You can also specify 'rand' as the
+ *                         'description', 'rating', or 'owner'. Default 'name'.
- *		order which will return links in a random order.
+ *                         If you start the name with an underscore, the order will be reversed.
- * @param int $limit Limit to X entries. If not specified, all entries are shown.
+ *                         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 $cat_name         Optional. The category name to use. If no match is found, uses all.
- * @param string $before The html to output before the link
+ *                                 Default 'noname'.
- * @param string $after The html to output after the link
+ * @param string $before           Optional. The HTML to output before the link. Default empty.
- * @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 string $after            Optional. The HTML to output after the link. Default '<br />'.
- * @param bool $show_images Whether to show images (if defined).
+ * @param string $between          Optional. The HTML to output between the link/image and its description.
- * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
+ *                                 Not used if no image or $show_images is true. Default ' '.
- *		'description', or 'rating'. Or maybe owner. If you start the name with an
+ * @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
- *		underscore the order will be reversed. You can also specify 'rand' as the
+ * @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
- *		order which will return links in a random order.
+ *                                 'description', 'rating', or 'owner'. Default 'id'.
- * @param bool $show_description Whether to show the description if show_images=false/not defined
+ *                                 If you start the name with an underscore, the order will be reversed.
- * @param int $limit Limit to X entries. If not specified, all entries are shown.
+ *                                 Specifying 'rand' as the order will return links in a random order.
- * @param int $show_updated Whether to show last updated timestamp
+ * @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 = '<br />', $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 int    $category         Optional. The category to use. If no category supplied, uses all.
- * @param string $before The html to output before the link
+ *                                 Default 0.
- * @param string $after The html to output after the link
+ * @param string $before           Optional. The HTML to output before the link. Default empty.
- * @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true
+ * @param string $after            Optional. The HTML to output after the link. Default '<br />'.
- * @param bool $show_images Whether to show images (if defined).
+ * @param string $between          Optional. The HTML to output between the link/image and its description.
- * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url',
+ *                                 Not used if no image or $show_images is true. Default ' '.
- *		'description', or 'rating'. Or maybe owner. If you start the name with an
+ * @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
- *		underscore the order will be reversed. You can also specify 'rand' as the
+ * @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
- *		order which will return links in a random order.
+ *                                 'description', 'rating', or 'owner'. Default 'id'.
- * @param bool $show_description Whether to show the description if show_images=false/not defined.
+ *                                 If you start the name with an underscore, the order will be reversed.
- * @param int $limit Limit to X entries. If not specified, all entries are shown.
+ *                                 Specifying 'rand' as the order will return links in a random order.
- * @param int $show_updated Whether to show last updated timestamp
+ * @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 = '<br />', $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 int    $category         Optional. The category to use. If no category supplied uses all.
- * @param string $before the html to output before the link
+ *                                 Default 0.
- * @param string $after the html to output after the link
+ * @param string $before           Optional. The HTML to output before the link. Default empty.
- * @param string $between the html to output between the link/image and its description.
+ * @param string $after            Optional. The HTML to output after the link. Default '<br />'.
- *		Not used if no image or show_images == true
+ * @param string $between          Optional. The HTML to output between the link/image and its description.
- * @param bool $show_images whether to show images (if defined).
+ *                                 Not used if no image or $show_images is true. Default ' '.
- * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
+ * @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
- *		'description', or 'rating'. Or maybe owner. If you start the name with an
+ * @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
- *		underscore the order will be reversed. You can also specify 'rand' as the order
+ *                                 'description', 'rating', or 'owner'. Default 'name'.
- *		which will return links in a random order.
+ *                                 If you start the name with an underscore, the order will be reversed.
- * @param bool $show_description whether to show the description if show_images=false/not defined.
+ *                                 Specifying 'rand' as the order will return links in a random order.
- * @param bool $show_rating show rating stars/chars
+ * @param bool   $show_description Optional. 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.
+ *                                 Default true.
- * @param int $show_updated whether to show last updated timestamp
+ * @param bool   $show_rating      Optional. Show rating stars/chars. Default false.
- * @param bool $echo whether to echo the results, or return them instead
+ * @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 = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
@@ -1628,27 +1649,28 @@ function the_author_ID() {
 /**
  * Display the post content for the feed.
  *
- * For encoding the html or the $encode_html parameter, there are three possible
+ * For encoding the HTML or the $encode_html parameter, there are three possible values:
- * values. '0' will make urls footnotes and use make_url_footnote(). '1' will
+ * - '0' will make urls footnotes and use make_url_footnote().
- * encode special characters and automatically display all of the content. The
+ * - '1' will encode special characters and automatically display all of the content.
- * value of '2' will strip all HTML tags from 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
+ * Also note that you cannot set the amount of words and not set the HTML encoding.
- * encoding. If that is the case, then the html encoding will default to 2,
+ * If that is the case, then the HTML encoding will default to 2, which will strip
- * which will strip all HTML tags.
+ * all HTML tags.
  *
- * To restrict the amount of words of the content, you can use the cut
+ * To restrict the amount of words of the content, you can use the cut parameter.
- * parameter. If the content is less than the amount, then there won't be any
+ * If the content is less than the amount, then there won't be any dots added to the end.
- * dots added to the end. If there is content left over, then dots will be added
+ * If there is content left over, then dots will be added and the rest of the content
- * and the rest of the content will be removed.
+ * 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 string $more_link_text Optional. Text to display when more content is available
- * @param int $stripteaser Optional. Default is 0.
+ *                               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.
@@ -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 $text Text to translate.
- * @param string $domain Optional. Domain to retrieve the translated text
+ * @param string $domain Optional. Domain to retrieve the translated text.
- * @return string Translated context string without pipe
+ * @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 $text Text to translate.
- * @param string $domain Domain to retrieve the translated text
+ * @param string $domain Domain to retrieve the translated text.
- * @return string Translated text
+ * @return string Translated text.
  */
 function translate_with_context( $text, $domain = 'default' ) {
 	_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );

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
  *

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.
  *

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

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 ) {

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.

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.