Various minor doc fixes

... picked up along the way.

Author: jrfnl

autoload.php

@@ -298,7 +298,7 @@ public static function getLoadedClassName($path)
          *
          * @param string $class The name of the class.
          *
-         * @throws \Exception If the class name has not been loaded
+         * @throws \Exception If the class name has not been loaded.
          * @return string
          */
         public static function getLoadedFileName($class)

src/Fixer.php

@@ -225,7 +225,7 @@ public function fixFile()
      *
      * @return string
      *
-     * @throws \PHP_CodeSniffer\Exceptions\RuntimeException when the diff command fails.
+     * @throws \PHP_CodeSniffer\Exceptions\RuntimeException When the diff command fails.
      */
     public function generateDiff($filePath=null, $colors=true)
     {

src/Standards/Generic/Sniffs/CodeAnalysis/JumbledIncrementerSniff.php

@@ -101,7 +101,7 @@ public function process(File $phpcsFile, $stackPtr)
      * Get all used variables in the incrementer part of a for statement.
      *
      * @param array<int, array>    $tokens Array with all code sniffer tokens.
-     * @param array<string, mixed> $token  Current for loop token
+     * @param array<string, mixed> $token  Current for loop token.
      *
      * @return string[] List of all found incrementer variables.
      */

src/Tokenizers/PHP.php

@@ -3538,10 +3538,10 @@ public static function resolveSimpleToken($token)
      * Finds a "closer" token (closing parenthesis or square bracket for example)
      * Handle parenthesis balancing while searching for closing token
      *
-     * @param array           $tokens       The list of tokens to iterate searching the closing token (as returned by token_get_all)
-     * @param int             $start        The starting position
-     * @param string|string[] $openerTokens The opening character
-     * @param string          $closerChar   The closing character
+     * @param array           $tokens       The list of tokens to iterate searching the closing token (as returned by token_get_all).
+     * @param int             $start        The starting position.
+     * @param string|string[] $openerTokens The opening character.
+     * @param string          $closerChar   The closing character.
      *
      * @return int|null The position of the closing token, if found. NULL otherwise.
      */
@@ -3575,8 +3575,8 @@ private function findCloser(array &$tokens, $start, $openerTokens, $closerChar)
      * PHP 8 attributes parser for PHP < 8
      * Handles single-line and multiline attributes.
      *
-     * @param array $tokens   The original array of tokens (as returned by token_get_all)
-     * @param int   $stackPtr The current position in token array
+     * @param array $tokens   The original array of tokens (as returned by token_get_all).
+     * @param int   $stackPtr The current position in token array.
      *
      * @return array|null The array of parsed attribute tokens
      */

src/Tokenizers/Tokenizer.php

@@ -76,7 +76,7 @@ abstract class Tokenizer
     /**
      * Initialise and run the tokenizer.
      *
-     * @param string                         $content The content to tokenize,
+     * @param string                         $content The content to tokenize.
      * @param \PHP_CodeSniffer\Config | null $config  The config data for the run.
      * @param string                         $eolChar The EOL char used in the content.
      *

tests/Core/Tokenizer/BackfillExplicitOctalNotationTest.php

@@ -17,7 +17,7 @@ final class BackfillExplicitOctalNotationTest extends AbstractTokenizerTestCase
      * Test that explicitly-defined octal values are tokenized as a single number and not as a number and a string.
      *
      * @param string     $marker      The comment which prefaces the target token in the test file.
-     * @param string     $value       The expected content of the token
+     * @param string     $value       The expected content of the token.
      * @param int|string $nextToken   The expected next token.
      * @param string     $nextContent The expected content of the next token.
      *

tests/Core/Tokenizer/TypedConstantsTest.php

@@ -109,8 +109,8 @@ public static function dataUntypedConstant()
     /**
      * Test the tokens in the type of a typed constant as well as the constant name are tokenized correctly.
      *
-     * @param string $testMarker The comment prefacing the target token.
-     * @param string $sequence   The expected token sequence.
+     * @param string            $testMarker The comment prefacing the target token.
+     * @param array<int|string> $sequence   The expected token sequence.
      *
      * @dataProvider dataTypedConstant
      * @dataProvider dataNullableTypedConstant
@@ -151,7 +151,7 @@ public function testTypedConstant($testMarker, array $sequence)
      *
      * @see testTypedConstant()
      *
-     * @return array<string, array<string, string>>
+     * @return array<string, array<string, string|array<int|string>>>
      */
     public static function dataTypedConstant()
     {

tests/Core/Util/HelpTest.php

@@ -454,7 +454,7 @@ public function testReportWidthCalculations($reportWidth, $longOptions, $expecte
     /**
      * Data provider.
      *
-     * @return array<string, array<string, int|string>>
+     * @return array<string, array<string, int|string|array<string>>>
      */
     public static function dataReportWidthCalculations()
     {
@@ -576,8 +576,8 @@ public static function dataColorizeVariableInput()
     /**
      * Test the various option types within a category get displayed correctly.
      *
-     * @param array<string, array<string, string> $input         The options to print.
-     * @param array<string, string>               $expectedRegex Regexes to validate expected output.
+     * @param array<string, array<string, string>> $input         The options to print.
+     * @param array<string, string>                $expectedRegex Regexes to validate expected output.
      *
      * @dataProvider dataPrintCategoryOptions
      *
@@ -611,8 +611,8 @@ public function testPrintCategoryOptionsNoColor($input, $expectedRegex)
     /**
      * Test the various option types within a category get displayed correctly.
      *
-     * @param array<string, array<string, string> $input         The options to print.
-     * @param array<string, string>               $expectedRegex Regexes to validate expected output.
+     * @param array<string, array<string, string>> $input         The options to print.
+     * @param array<string, string>                $expectedRegex Regexes to validate expected output.
      *
      * @dataProvider dataPrintCategoryOptions
      *

tests/Core/Util/SuggestTypeTest.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * Tests for the \PHP_CodeSniffer\Util\Sniffs\Comments::suggestType() method.
+ * Tests for the \PHP_CodeSniffer\Util\Sniffs\Common::suggestType() method.
  *
  * @author    Juliette Reinders Folmer <[email protected]>
  * @copyright 2019 Juliette Reinders Folmer. All rights reserved.
@@ -13,7 +13,7 @@
 use PHPUnit\Framework\TestCase;
 
 /**
- * Tests for the \PHP_CodeSniffer\Util\Sniffs\Comments::suggestType() method.
+ * Tests for the \PHP_CodeSniffer\Util\Sniffs\Common::suggestType() method.
  *
  * @covers \PHP_CodeSniffer\Util\Common::suggestType
  */