Docs: various grammar/spelling/inline mark-up fixes

Author: jrfnl

PHPCSUtils/Tokens/Collections.php

@@ -406,7 +406,7 @@ class Collections
      * The method supports PHPCS 2.6.0 and up.
      *
      * Notable differences:
-     * - The method will include the `T_ARRAY_HINT` and the `T_RETURN_TYPE tokens when used with PHPCS 2.x and 3.x.
+     * - The method will include the `T_ARRAY_HINT` and the `T_RETURN_TYPE` tokens when used with PHPCS 2.x and 3.x.
      *   These token constants will no longer exist in PHPCS 4.x.
      * - The method will include the `T_ARRAY` token which is needed for select arrow functions in PHPCS < 3.5.4.
      *
@@ -661,7 +661,7 @@ public static function propertyTypeTokensBC()
      * The method supports PHPCS 2.6.0 and up.
      *
      * Notable differences:
-     * - The method will include the `T_ARRAY_HINT` and the `T_RETURN_TYPE tokens when used with PHPCS 2.x and 3.x.
+     * - The method will include the `T_ARRAY_HINT` and the `T_RETURN_TYPE` tokens when used with PHPCS 2.x and 3.x.
      *   These token constants will no longer exist in PHPCS 4.x.
      * - The method will include the `T_ARRAY` token which is needed for select arrow functions in PHPCS < 3.5.4.
      *

PHPCSUtils/Utils/ControlStructures.php

@@ -200,7 +200,7 @@ public static function isElseIf(File $phpcsFile, $stackPtr)
      * Get the scope opener and closer for a `declare` statement.
      *
      * A `declare` statement can be:
-     * - applied to the rest of the file, like `declare(ticks=1);`;
+     * - applied to the rest of the file, like `declare(ticks=1);`
      * - applied to a limited scope using curly braces;
      * - applied to a limited scope using the alternative control structure syntax.
      *
@@ -358,7 +358,7 @@ public static function getDeclareScopeOpenClose(File $phpcsFile, $stackPtr)
      * @return array
      *
      * @throws \PHP_CodeSniffer\Exceptions\RuntimeException If the specified $stackPtr is not of
-     *                                                      type T_CATCH or doesn't exist or in case
+     *                                                      type T_CATCH, doesn't exist or in case
      *                                                      of a parse error.
      */
     public static function getCaughtExceptions(File $phpcsFile, $stackPtr)

PHPCSUtils/Utils/FunctionDeclarations.php

@@ -201,7 +201,7 @@ public static function getName(File $phpcsFile, $stackPtr)
      * @return array
      *
      * @throws \PHP_CodeSniffer\Exceptions\RuntimeException If the specified position is not a T_FUNCTION
-     *                                                      or T_CLOSURE token nor an arrow function.
+     *                                                      or T_CLOSURE token, nor an arrow function.
      */
     public static function getProperties(File $phpcsFile, $stackPtr)
     {
@@ -604,7 +604,7 @@ public static function getParameters(File $phpcsFile, $stackPtr)
      *                                               T_STRING token as those are the only two
      *                                               tokens which can be the arrow function keyword.
      *
-     * @return bool TRUE is the token is the "fn" keyword for an arrow function. FALSE when not or
+     * @return bool TRUE if the token is the "fn" keyword for an arrow function. FALSE when not or
      *              in case of live coding/parse error.
      */
     public static function isArrowFunction(File $phpcsFile, $stackPtr)

PHPCSUtils/Utils/Lists.php

@@ -260,7 +260,7 @@ public static function getOpenClose(File $phpcsFile, $stackPtr, $isShortList = n
      *                                                 // second item in `list($a, , $b)`.
      *         'is_nested_list'       => bool,         // Whether this is a nested list.
      *         'variable'             => string|false, // The base variable being assigned to or
-     *                                                 // FALSE in case of a nested list or avariable variable.
+     *                                                 // FALSE in case of a nested list or a variable variable.
      *                                                 // I.e. `$a` in `list($a['key'])`.
      *         'assignment_token'     => int|false,    // The start pointer for the assignment.
      *         'assignment_end_token' => int|false,    // The end pointer for the assignment.

PHPCSUtils/Utils/Numbers.php

@@ -95,7 +95,7 @@ class Numbers
         `ixD';
 
     /**
-     * Regex to determine is a T_STRING following a T_[DL]NUMBER is part of a numeric literal sequence.
+     * Regex to determine if a T_STRING following a T_[DL]NUMBER is part of a numeric literal sequence.
      *
      * PHP cross-version compat for PHP 7.4 numeric literals with underscore separators.
      *
@@ -144,7 +144,7 @@ class Numbers
      * Helper function to deal with numeric literals, potentially with underscore separators.
      *
      * PHP < 7.4 does not tokenize numeric literals containing underscores correctly.
-     * As of PHPCS 3.5.3, PHPCS contains a back-fill, but this backfill was buggy in the initial
+     * As of PHPCS 3.5.3, PHPCS contains a backfill, but this backfill was buggy in the initial
      * implementation. A fix for this broken backfill is included in PHPCS 3.5.4.
      *
      * Either way, this function provides a backfill for all PHPCS/PHP combinations where

PHPCSUtils/Utils/ObjectDeclarations.php

@@ -219,7 +219,7 @@ public static function getClassProperties(File $phpcsFile, $stackPtr)
      * Works for classes, anonymous classes and interfaces, though it is strongly recommended
      * to use the {@see \PHPCSUtils\Utils\ObjectDeclarations::findExtendedInterfaceNames()}
      * method to examine interfaces instead. Interfaces can extend multiple parent interfaces,
-     * and that use case is not handled by this method.
+     * and that use-case is not handled by this method.
      *
      * Main differences with the PHPCS version:
      * - Bugs fixed:

phpcsutils-autoload.php

@@ -102,7 +102,7 @@ class_alias('\PHP_CodeSniffer_Exception', '\PHP_CodeSniffer\Exceptions\Tokenizer
     /*
      * Alias the PHPUnit 4/5 TestCase class to its PHPUnit 6+ name.
      *
-     * This allows the both the PHPCSUtils native unit tests as well as the
+     * This allows both the PHPCSUtils native unit tests as well as the
      * `UtilityMethodTestCase` class to work cross-version with PHPUnit
      * below 6.x and above.
      *