Docs: Fix various typos and spelling mistakes.

Props swissspidy, jucaduca, sergeybiryukov.
See #60699.

git-svn-id: https://develop.svn.wordpress.org/trunk@57987 602fd350-edb4-49c9-b593-d223f7449a82

README.md

@@ -13,7 +13,7 @@ To get started, create a codespace for this repository by clicking this 👇
 
 [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?hide_repo_select=true&ref=trunk&repo=75645659)
 
-A codespace will open in a web-based version of Visual Studio Code. The [dev container](.devcontainer/devcontainer.json) is fully configured with softwares needed for this project.
+A codespace will open in a web-based version of Visual Studio Code. The [dev container](.devcontainer/devcontainer.json) is fully configured with software needed for this project.
 
 **Note**: Dev containers is an open spec which is supported by [GitHub Codespaces](https://github.com/codespaces) and [other tools](https://containers.dev/supporting).
 

src/js/_enqueues/lib/admin-bar.js

@@ -203,7 +203,7 @@
 	}
 
 	/**
-	 * Toogle hover class for mobile devices.
+	 * Toggle hover class for mobile devices.
 	 *
 	 * @since 5.3.1
 	 *

src/js/_enqueues/wp/backbone.js

@@ -310,7 +310,7 @@ window.wp = window.wp || {};
 		 * @since 3.6.0
 		 *
 		 * @param {Object}  options        Options for call.
-		 * @param {boolean} options.silent If true, `unset` wil *not* be triggered on
+		 * @param {boolean} options.silent If true, `unset` will *not* be triggered on
 		 *                                 the master views' parent.
 		 *
 		 * @return {wp.Backbone.Subviews} The current Subviews instance.

src/js/_enqueues/wp/customize/controls.js

@@ -1799,7 +1799,7 @@
 						section.closeDetails();
 					} else {
 
-						// Escape from the inifinite scroll list.
+						// Escape from the infinite scroll list.
 						section.headerContainer.find( '.customize-themes-section-title' ).focus();
 					}
 					event.stopPropagation(); // Prevent section from being collapsed.
@@ -7199,7 +7199,7 @@
 			} ) );
 
 			/**
-			 * Return whether the pubish settings section should be active.
+			 * Return whether the publish settings section should be active.
 			 *
 			 * @return {boolean} Is section active.
 			 */

src/js/_enqueues/wp/customize/loader.js

@@ -22,7 +22,7 @@ window.wp = window.wp || {};
 	});
 
 	/**
-	 * Allows the Customizer to be overlayed on any page.
+	 * Allows the Customizer to be overlaid on any page.
 	 *
 	 * By default, any element in the body with the load-customize class will open
 	 * an iframe overlay with the URL specified.

src/js/_enqueues/wp/customize/selective-refresh.js

@@ -429,7 +429,7 @@ wp.customize.selectiveRefresh = ( function( $, api ) {
 			}
 
 			/* jshint ignore:start */
-			self.orginalDocumentWrite = document.write;
+			self.originalDocumentWrite = document.write;
 			document.write = function() {
 				throw new Error( self.data.l10n.badDocumentWrite );
 			};
@@ -473,8 +473,8 @@ wp.customize.selectiveRefresh = ( function( $, api ) {
 				partial.fallback( error, [ placement ] );
 			}
 			/* jshint ignore:start */
-			document.write = self.orginalDocumentWrite;
-			self.orginalDocumentWrite = null;
+			document.write = self.originalDocumentWrite;
+			self.originalDocumentWrite = null;
 			/* jshint ignore:end */
 
 			partial.createEditShortcutForPlacement( placement );
@@ -673,7 +673,7 @@ wp.customize.selectiveRefresh = ( function( $, api ) {
 	self._pendingPartialRequests = {};
 
 	/**
-	 * Timeout ID for the current requesr, or null if no request is current.
+	 * Timeout ID for the current request, or null if no request is current.
 	 *
 	 * @since 4.5.0
 	 * @type {number|null}

src/js/_enqueues/wp/customize/widgets.js

@@ -388,7 +388,7 @@
 		},
 
 		/**
-		 * Adds keyboard accessiblity to the panel.
+		 * Adds keyboard accessibility to the panel.
 		 */
 		keyboardAccessible: function( event ) {
 			var isEnter = ( event.which === 13 ),

src/js/_enqueues/wp/dashboard.js

@@ -92,7 +92,7 @@ jQuery( function($) {
 				setTimeout( function(){
 					// Request the widget content.
 					p.load( ajaxurl + '?action=dashboard-widgets&widget=' + id + '&pagenow=' + pagenow, '', function() {
-						// Hide the parent and slide it out for visual fancyness.
+						// Hide the parent and slide it out for visual fanciness.
 						p.hide().slideDown('normal', function(){
 							$(this).css('display', '');
 						});

src/js/_enqueues/wp/editor/base.js

@@ -265,7 +265,7 @@ window.wp = window.wp || {};
 		}
 
 		/**
-		 * Gets a list of unique shortcodes or shortcode-look-alikes in the content.
+		 * Gets a list of unique shortcodes or shortcode-lookalikes in the content.
 		 *
 		 * @param {string} content The content we want to scan for shortcodes.
 		 */
@@ -561,7 +561,7 @@ window.wp = window.wp || {};
 		 * By default TinyMCE wraps loose inline tags in a `<p>`.
 		 * When removing selection markers an empty `<p>` may be left behind, remove it.
 		 *
-		 * @param {Object} $marker The marker to be removed from the editor DOM, wrapped in an instnce of `editor.$`
+		 * @param {Object} $marker The marker to be removed from the editor DOM, wrapped in an instance of `editor.$`
 		 */
 		function removeSelectionMarker( $marker ) {
 			var $markerParent = $marker.parent();

src/js/_enqueues/wp/editor/dfw.js

@@ -1552,7 +1552,7 @@
 				// Bind and unbind based on the distraction free writing focus.
 				$document.on( 'dfw-on.focus', mceBind ).on( 'dfw-off.focus', mceUnbind );
 
-				// Focuse the editor when it is the target of the click event.
+				// Focus the editor when it is the target of the click event.
 				editor.on( 'click', function( event ) {
 					if ( event.target === editor.getDoc().documentElement ) {
 						editor.focus();

src/js/_enqueues/wp/theme-plugin-editor.js

@@ -191,7 +191,7 @@ wp.themePluginEditor = (function( $ ) {
 			return;
 		}
 
-		// Scroll ot the line that has the error.
+		// Scroll to the line that has the error.
 		if ( component.lintErrors.length ) {
 			component.instance.codemirror.setCursor( component.lintErrors[0].from.line );
 			return;

src/js/_enqueues/wp/theme.js

@@ -926,7 +926,7 @@ themes.view.Preview = themes.view.Details.extend({
 
 		currentPreviewDevice = this.$el.data( 'current-preview-device' );
 		if ( currentPreviewDevice ) {
-			self.tooglePreviewDeviceButtons( currentPreviewDevice );
+			self.togglePreviewDeviceButtons( currentPreviewDevice );
 		}
 
 		themes.router.navigate( themes.router.baseUrl( themes.router.themePath + this.model.get( 'id' ) ), { replace: false } );
@@ -988,10 +988,10 @@ themes.view.Preview = themes.view.Details.extend({
 			.addClass( 'preview-' + device )
 			.data( 'current-preview-device', device );
 
-		this.tooglePreviewDeviceButtons( device );
+		this.togglePreviewDeviceButtons( device );
 	},
 
-	tooglePreviewDeviceButtons: function( newDevice ) {
+	togglePreviewDeviceButtons: function( newDevice ) {
 		var $devices = $( '.wp-full-overlay-footer .devices' );
 
 		$devices.find( 'button' )

src/js/media/views/toolbar.js

@@ -52,7 +52,7 @@ Toolbar = View.extend(/** @lends wp.media.view.Toolbar.prototype */{
 		}
 	},
 	/**
-	 * @return {wp.media.view.Toolbar} Returns itsef to allow chaining
+	 * @return {wp.media.view.Toolbar} Returns itself to allow chaining
 	 */
 	dispose: function() {
 		if ( this.selection ) {

src/wp-admin/css/list-tables.css

@@ -904,7 +904,7 @@ tr:hover .row-actions,
 
 tr.inline-edit-row td {
 	padding: 0;
-	/* Prevents the focus style on .inline-edit-wrapper from being cutted-off */
+	/* Prevents the focus style on .inline-edit-wrapper from being cut-off */
 	position: relative;
 }
 

src/wp-content/themes/twentyfourteen/inc/featured-content.php

@@ -179,7 +179,7 @@ public static function get_featured_post_ids() {
 	}
 
 	/**
-	 * Return an array with IDs of posts maked as sticky.
+	 * Return an array with IDs of posts marked as sticky.
 	 *
 	 * @since Twenty Fourteen 1.0
 	 *

src/wp-content/themes/twentyseventeen/assets/css/colors-dark.css

@@ -126,8 +126,8 @@
 .colors-dark .widget .widget-title a:hover,
 .colors-dark .widget ul li a:focus,
 .colors-dark .widget ul li a:hover {
-	-webkit-box-shadow: inset 0 0 0 rgba(255, 255, 255, 0), 0 3px 0 rgba(255, 255, 255, 1); /* Equivalant to #fff */
-	box-shadow: inset 0 0 0 rgba(255, 255, 255, 0), 0 3px 0 rgba(255, 255, 255, 1); /* Equivalant to #fff */
+	-webkit-box-shadow: inset 0 0 0 rgba(255, 255, 255, 0), 0 3px 0 rgba(255, 255, 255, 1); /* Equivalent to #fff */
+	box-shadow: inset 0 0 0 rgba(255, 255, 255, 0), 0 3px 0 rgba(255, 255, 255, 1); /* Equivalent to #fff */
 }
 
 .colors-dark .entry-content a,
@@ -137,8 +137,8 @@
 .colors-dark .site-footer .widget-area a,
 .colors-dark .posts-navigation a,
 .colors-dark .widget_authors a strong {
-	-webkit-box-shadow: inset 0 -1px 0 rgba(240, 240, 240, 1); /* Equivalant to #f0f0f0 */
-	box-shadow: inset 0 -1px 0 rgba(240, 240, 240, 1); /* Equivalant to #f0f0f0 */
+	-webkit-box-shadow: inset 0 -1px 0 rgba(240, 240, 240, 1); /* Equivalent to #f0f0f0 */
+	box-shadow: inset 0 -1px 0 rgba(240, 240, 240, 1); /* Equivalent to #f0f0f0 */
 }
 
 body.colors-dark,
@@ -474,8 +474,8 @@ body.colors-dark,
 .colors-dark .widget ul li a,
 .colors-dark .site-footer .widget-area ul li a,
 .colors-dark .site-info a {
-	-webkit-box-shadow: inset 0 -1px 0 rgba(34, 34, 34, 1); /* Equivalant to #222 */
-	box-shadow: inset 0 -1px 0 rgba(34, 34, 34, 1); /* Equivalant to #222 */
+	-webkit-box-shadow: inset 0 -1px 0 rgba(34, 34, 34, 1); /* Equivalent to #222 */
+	box-shadow: inset 0 -1px 0 rgba(34, 34, 34, 1); /* Equivalent to #222 */
 }
 
 /* Fixes linked images */

src/wp-content/themes/twentytwelve/inc/block-patterns.php

@@ -100,7 +100,7 @@
 				<p class="has-drop-cap">' . esc_html__( 'Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts. Separated they live in Bookmarksgrove right at the coast of the Semantics, a large language ocean. A small river named Duden flows by their place and supplies it with the necessary regelialia. It is a paradisematic country, in which roasted parts of sentences fly into your mouth.', 'twentytwelve' ) . '</p>
 				<!-- /wp:paragraph -->
 				<!-- wp:paragraph -->
-				<p>' . esc_html__( 'The Big Oxmox advised her not to do so, because there were thousands of bad Commas, wild Question Marks and devious Semikoli, but the Little Blind Text didn&#8217;t listen. She packed her seven versalia, put her initial into the belt and made herself on the way. When she reached the first hills of the Italic Mountains, she had a last view back on the skyline of her hometown Bookmarksgrove, the headline of Alphabet Village and the subline of her own road, the Line Lane. Pityful a rethoric question ran over her cheek, then.', 'twentytwelve' ) . '</p>
+				<p>' . esc_html__( 'The Big Oxmox advised her not to do so, because there were thousands of bad Commas, wild Question Marks and devious Semikoli, but the Little Blind Text didn&#8217;t listen. She packed her seven versalia, put her initial into the belt and made herself on the way. When she reached the first hills of the Italic Mountains, she had a last view back on the skyline of her hometown Bookmarksgrove, the headline of Alphabet Village and the subline of her own road, the Line Lane. Pityful a rhetoric question ran over her cheek, then.', 'twentytwelve' ) . '</p>
 				<!-- /wp:paragraph -->
 				<!-- wp:paragraph -->
 				<p>' . esc_html__( 'It is a paradisematic country, in which roasted parts of sentences fly into your mouth. Even the all-powerful Pointing has no control about the blind texts it is an almost unorthographic life One day however a small line of blind text by the name of Lorem Ipsum decided to leave for the far World of Grammar. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts. Separated they live in Bookmarksgrove right at the coast of the Semantics, a large language ocean. A small river named Duden flows by their place and supplies it with the necessary regelialia. It is a paradisematic country, in which roasted parts of sentences fly into your mouth.', 'twentytwelve' ) . '</p>

src/wp-content/themes/twentytwenty/assets/js/index.js

@@ -331,7 +331,7 @@ twentytwenty.intrinsicRatioVideos = {
 		} );
 	}
 
-}; // twentytwenty.instrinsicRatioVideos
+}; // twentytwenty.intrinsicRatioVideos
 
 /*	-----------------------------------------------------------------------------------------------
 	Modal Menu

src/wp-content/themes/twentytwentyone/assets/sass/06-components/header.scss

@@ -173,7 +173,7 @@
 						margin-top: calc(0px - var(--button--padding-vertical) + (0.25 * var(--global--spacing-unit)));
 
 						#primary-mobile-menu {
-							// The 4.5px here is to offset the icon size horizontallly
+							// The 4.5px here is to offset the icon size horizontally
 							// (the icon's width is larger than the path's width and has extra space on the sides).
 							padding-left: calc(var(--global--spacing-horizontal) * 0.6 - 4.5px);
 							padding-right: calc(var(--global--spacing-horizontal) * 0.6 - 4.5px);

src/wp-includes/class-wp-theme-json.php

@@ -2893,7 +2893,7 @@ protected static function should_override_preset( $theme_json, $path, $override
 
 	/**
 	 * Returns the default slugs for all the presets in an associative array
-	 * whose keys are the preset paths and the leafs is the list of slugs.
+	 * whose keys are the preset paths and the leaves is the list of slugs.
 	 *
 	 * For example:
 	 *

src/wp-includes/embed.php

@@ -244,7 +244,7 @@ function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
 	$embed = $wp_embed->autoembed( sprintf( 'https://youtube.com/watch?v=%s', urlencode( $matches[2] ) ) );
 
 	/**
-	 * Filters the YoutTube embed output.
+	 * Filters the YouTube embed output.
 	 *
 	 * @since 4.0.0
 	 *

src/wp-includes/functions.php

@@ -2270,7 +2270,7 @@ function wp_is_writable( $path ) {
  * PHP has issues with Windows ACL's for determine if a
  * directory is writable or not, this works around them by
  * checking the ability to open files rather than relying
- * upon PHP to interprate the OS ACL.
+ * upon PHP to interpret the OS ACL.
  *
  * @since 2.8.0
  *

src/wp-includes/html-api/class-wp-html-tag-processor.php

@@ -2071,7 +2071,7 @@ private function after_tag() {
 		/*
 		 * Purge updates if there are too many. The actual count isn't
 		 * scientific, but a few values from 100 to a few thousand were
-		 * tests to find a practially-useful limit.
+		 * tests to find a practically-useful limit.
 		 *
 		 * If the update queue grows too big, then the Tag Processor
 		 * will spend more time iterating through them and lose the

src/wp-includes/ms-deprecated.php

@@ -145,7 +145,7 @@ function clear_global_post_cache( $post_id ) {
 }
 
 /**
- * Deprecated functionality to determin if the current site is the main site.
+ * Deprecated functionality to determine if the current site is the main site.
  *
  * @since MU (3.0.0)
  * @deprecated 3.0.0 Use is_main_site()

src/wp-includes/nav-menu-template.php

@@ -341,9 +341,9 @@ function _wp_menu_item_classes_by_context( &$menu_items ) {
 				if ( is_array( $terms ) ) {
 					$possible_object_parents = array_merge( $possible_object_parents, $terms );
 					$term_to_ancestor        = array();
-					foreach ( (array) $term_hierarchy as $anc => $descs ) {
-						foreach ( (array) $descs as $desc ) {
-							$term_to_ancestor[ $desc ] = $anc;
+					foreach ( (array) $term_hierarchy as $ancestor => $descendents ) {
+						foreach ( (array) $descendents as $desc ) {
+							$term_to_ancestor[ $desc ] = $ancestor;
 						}
 					}
 
@@ -365,9 +365,9 @@ function _wp_menu_item_classes_by_context( &$menu_items ) {
 	} elseif ( ! empty( $queried_object->taxonomy ) && is_taxonomy_hierarchical( $queried_object->taxonomy ) ) {
 		$term_hierarchy   = _get_term_hierarchy( $queried_object->taxonomy );
 		$term_to_ancestor = array();
-		foreach ( (array) $term_hierarchy as $anc => $descs ) {
-			foreach ( (array) $descs as $desc ) {
-				$term_to_ancestor[ $desc ] = $anc;
+		foreach ( (array) $term_hierarchy as $ancestor => $descendents ) {
+			foreach ( (array) $descendents as $desc ) {
+				$term_to_ancestor[ $desc ] = $ancestor;
 			}
 		}
 		$desc = $queried_object->term_id;
@@ -430,13 +430,13 @@ function _wp_menu_item_classes_by_context( &$menu_items ) {
 		) {
 			$classes[]                   = 'current-menu-item';
 			$menu_items[ $key ]->current = true;
-			$_anc_id                     = (int) $menu_item->db_id;
+			$ancestor_id                 = (int) $menu_item->db_id;
 
 			while (
-				( $_anc_id = (int) get_post_meta( $_anc_id, '_menu_item_menu_item_parent', true ) )
-				&& ! in_array( $_anc_id, $active_ancestor_item_ids, true )
+				( $ancestor_id = (int) get_post_meta( $ancestor_id, '_menu_item_menu_item_parent', true ) )
+				&& ! in_array( $ancestor_id, $active_ancestor_item_ids, true )
 			) {
-				$active_ancestor_item_ids[] = $_anc_id;
+				$active_ancestor_item_ids[] = $ancestor_id;
 			}
 
 			if ( 'post_type' === $menu_item->type && 'page' === $menu_item->object ) {
@@ -457,13 +457,13 @@ function _wp_menu_item_classes_by_context( &$menu_items ) {
 		) {
 			$classes[]                   = 'current-menu-item';
 			$menu_items[ $key ]->current = true;
-			$_anc_id                     = (int) $menu_item->db_id;
+			$ancestor_id                 = (int) $menu_item->db_id;
 
 			while (
-				( $_anc_id = (int) get_post_meta( $_anc_id, '_menu_item_menu_item_parent', true ) )
-				&& ! in_array( $_anc_id, $active_ancestor_item_ids, true )
+				( $ancestor_id = (int) get_post_meta( $ancestor_id, '_menu_item_menu_item_parent', true ) )
+				&& ! in_array( $ancestor_id, $active_ancestor_item_ids, true )
 			) {
-				$active_ancestor_item_ids[] = $_anc_id;
+				$active_ancestor_item_ids[] = $ancestor_id;
 			}
 
 			$active_parent_item_ids[] = (int) $menu_item->menu_item_parent;
@@ -494,13 +494,13 @@ function _wp_menu_item_classes_by_context( &$menu_items ) {
 			if ( $raw_item_url && in_array( $item_url, $matches, true ) ) {
 				$classes[]                   = 'current-menu-item';
 				$menu_items[ $key ]->current = true;
-				$_anc_id                     = (int) $menu_item->db_id;
+				$ancestor_id                 = (int) $menu_item->db_id;
 
 				while (
-					( $_anc_id = (int) get_post_meta( $_anc_id, '_menu_item_menu_item_parent', true ) )
-					&& ! in_array( $_anc_id, $active_ancestor_item_ids, true )
+					( $ancestor_id = (int) get_post_meta( $ancestor_id, '_menu_item_menu_item_parent', true ) )
+					&& ! in_array( $ancestor_id, $active_ancestor_item_ids, true )
 				) {
-					$active_ancestor_item_ids[] = $_anc_id;
+					$active_ancestor_item_ids[] = $ancestor_id;
 				}
 
 				if ( in_array( home_url(), array( untrailingslashit( $current_url ), untrailingslashit( $_indexless_current ) ), true ) ) {

src/wp-includes/post.php

@@ -3403,7 +3403,7 @@ function wp_post_mime_type_where( $post_mime_types, $table_alias = '' ) {
 		$post_mime_types = array_map( 'trim', explode( ',', $post_mime_types ) );
 	}
 
-	$wheres = array();
+	$where_clauses = array();
 
 	foreach ( (array) $post_mime_types as $mime_type ) {
 		$mime_type = preg_replace( '/\s/', '', $mime_type );
@@ -3431,14 +3431,14 @@ function wp_post_mime_type_where( $post_mime_types, $table_alias = '' ) {
 		}
 
 		if ( str_contains( $mime_pattern, '%' ) ) {
-			$wheres[] = empty( $table_alias ) ? "post_mime_type LIKE '$mime_pattern'" : "$table_alias.post_mime_type LIKE '$mime_pattern'";
+			$where_clauses[] = empty( $table_alias ) ? "post_mime_type LIKE '$mime_pattern'" : "$table_alias.post_mime_type LIKE '$mime_pattern'";
 		} else {
-			$wheres[] = empty( $table_alias ) ? "post_mime_type = '$mime_pattern'" : "$table_alias.post_mime_type = '$mime_pattern'";
+			$where_clauses[] = empty( $table_alias ) ? "post_mime_type = '$mime_pattern'" : "$table_alias.post_mime_type = '$mime_pattern'";
 		}
 	}
 
-	if ( ! empty( $wheres ) ) {
-		$where = ' AND (' . implode( ' OR ', $wheres ) . ') ';
+	if ( ! empty( $where_clauses ) ) {
+		$where = ' AND (' . implode( ' OR ', $where_clauses ) . ') ';
 	}
 
 	return $where;