Fix spelling and grammar in documentation

Author: sirreal

src/wp-includes/html-api/class-wp-css-complex-selector-list.php

@@ -21,7 +21,7 @@
  * A subset of the CSS selector grammar is supported. The grammar is defined in the CSS Syntax
  * specification, which is available at {@link https://www.w3.org/TR/selectors/#grammar}.
  *
- * This class is rougly analogous to the <selector-list> in the grammar.
+ * This class is roughly analogous to the <selector-list> in the grammar.
  * See {@see WP_CSS_Compound_Selector_List} for more details on the grammar.
  *
  * This class supports the same selector syntax as {@see WP_CSS_Compound_Selector_List} as well as
@@ -32,7 +32,7 @@
  * Combinators may only be used with type selectors in the non-final position, for example:
  *   - `div [type=input]` is valid because the `div` type selector appears in a non-final position.
  *   - `[disabled] option` is NOT valid, because the `[disabled]` attribute selector appears
- *     a non-final position.
+ *     in a non-final position.
  *
  * These combinators are not supported:
  *   - Next sibling (`former-sibling + next-sibling`)

src/wp-includes/html-api/class-wp-css-complex-selector.php

@@ -12,7 +12,7 @@
  *
  * This class is used to test for matching HTML tags in a {@see WP_HTML_Processor}.
  *
- * A compound selector is at least a single compound selector. There may be additional selectors
+ * A complex selector is at least a single compound selector. There may be additional selectors
  * with combinators.
  *
  * @since {WP_VERSION}

src/wp-includes/html-api/class-wp-css-compound-selector-list.php

@@ -59,7 +59,7 @@
  * - Pseudo-element selectors (`::before`)
  * - Pseudo-class selectors (`:hover` or `:nth-child(2)`)
  * - Namespace prefixes (`svg|title` or `[xlink|href]`)
- * - No combinators are supported (descendant, child, next sibling, subsequent sibling)
+ * - Combinators are not supported (descendant, child, next sibling, subsequent sibling)
  *
  * Future ideas:
  * - Namespace type selectors could be implemented with select namespaces in order to

src/wp-includes/html-api/class-wp-css-selector-parser-matcher.php

@@ -8,7 +8,7 @@
  */
 
 /**
- * Base class for all CSS Selector praser/matcher classes.
+ * Base class for all CSS Selector parser/matcher classes.
  *
  * @since 6.8.0
  *
@@ -50,7 +50,7 @@ abstract public static function parse( string $input, int &$offset );
 	 *
 	 * @param string $input The selector string.
 	 * @param int    $offset The offset into the string. The offset is passed by reference and will
-	 *                       be update to the byte after the whitespace sequence.
+	 *                       be updated to the byte after the whitespace sequence.
 	 * @return bool True if whitespace was consumed.
 	 */
 	final protected static function parse_whitespace( string $input, int &$offset ): bool {
@@ -258,7 +258,7 @@ final protected static function consume_escaped_codepoint( $input, &$offset ): s
 	/**
 	 * Parse an ident token
 	 *
-	 * CAUTION: This method is _not_ for parsing and ID selector!
+	 * CAUTION: This method is _not_ for parsing an ID selector!
 	 *
 	 * > 4.3.11. Consume an ident sequence
 	 * > This section describes how to consume an ident sequence from a stream of code points. It returns a string containing the largest name that can be formed from adjacent code points in the stream, starting from the first.