From 684db666822ea5b0d208f6b38182b85cb1874156 Mon Sep 17 00:00:00 2001 From: jrfnl Date: Tue, 10 Sep 2024 01:30:53 +0200 Subject: [PATCH] Docs: improve type specificity --- PHPCSDebug/Sniffs/Debug/TokenListSniff.php | 6 +++--- PHPCSDebug/Tests/Debug/TokenListCssTest.php | 2 +- PHPCSDebug/Tests/Debug/TokenListJsTest.php | 2 +- PHPCSDebug/Tests/Debug/TokenListUnitTest.php | 2 +- Scripts/CheckSniffCompleteness.php | 14 +++++++------- Scripts/FileList.php | 2 +- Tests/DocsXsd/DocsXsdTest.php | 4 ++-- Tests/IOTestCase.php | 8 ++++---- 8 files changed, 20 insertions(+), 20 deletions(-) diff --git a/PHPCSDebug/Sniffs/Debug/TokenListSniff.php b/PHPCSDebug/Sniffs/Debug/TokenListSniff.php index 020e067..67aef3c 100644 --- a/PHPCSDebug/Sniffs/Debug/TokenListSniff.php +++ b/PHPCSDebug/Sniffs/Debug/TokenListSniff.php @@ -28,7 +28,7 @@ class TokenListSniff implements Sniff /** * A list of tokenizers this sniff supports. * - * @var array + * @var array */ public $supportedTokenizers = [ 'PHP', @@ -41,7 +41,7 @@ class TokenListSniff implements Sniff * * This prevents issues with "undefined index" notices in case of rare tokenizer issues. * - * @var array + * @var array> */ private $tokenDefaults = [ 'type' => '?', @@ -57,7 +57,7 @@ class TokenListSniff implements Sniff /** * Returns an array of tokens this test wants to listen for. * - * @return array + * @return array */ public function register() { diff --git a/PHPCSDebug/Tests/Debug/TokenListCssTest.php b/PHPCSDebug/Tests/Debug/TokenListCssTest.php index 8e39cc8..ae391d4 100644 --- a/PHPCSDebug/Tests/Debug/TokenListCssTest.php +++ b/PHPCSDebug/Tests/Debug/TokenListCssTest.php @@ -33,7 +33,7 @@ final class TokenListCssTest extends UtilityMethodTestCase /** * Set the name of a sniff to pass to PHPCS to limit the run (and force it to record errors). * - * @var array + * @var array */ protected static $selectedSniff = ['PHPCSDebug.Debug.TokenList']; diff --git a/PHPCSDebug/Tests/Debug/TokenListJsTest.php b/PHPCSDebug/Tests/Debug/TokenListJsTest.php index d81914b..1c308f0 100644 --- a/PHPCSDebug/Tests/Debug/TokenListJsTest.php +++ b/PHPCSDebug/Tests/Debug/TokenListJsTest.php @@ -33,7 +33,7 @@ final class TokenListJsTest extends UtilityMethodTestCase /** * Set the name of a sniff to pass to PHPCS to limit the run (and force it to record errors). * - * @var array + * @var array */ protected static $selectedSniff = ['PHPCSDebug.Debug.TokenList']; diff --git a/PHPCSDebug/Tests/Debug/TokenListUnitTest.php b/PHPCSDebug/Tests/Debug/TokenListUnitTest.php index a831684..3cbed60 100644 --- a/PHPCSDebug/Tests/Debug/TokenListUnitTest.php +++ b/PHPCSDebug/Tests/Debug/TokenListUnitTest.php @@ -26,7 +26,7 @@ final class TokenListUnitTest extends UtilityMethodTestCase /** * Set the name of a sniff to pass to PHPCS to limit the run (and force it to record errors). * - * @var array + * @var array */ protected static $selectedSniff = ['PHPCSDebug.Debug.TokenList']; diff --git a/Scripts/CheckSniffCompleteness.php b/Scripts/CheckSniffCompleteness.php index b060351..77eb508 100644 --- a/Scripts/CheckSniffCompleteness.php +++ b/Scripts/CheckSniffCompleteness.php @@ -66,7 +66,7 @@ class CheckSniffCompleteness /** * The target directories to examine. * - * @var array + * @var array */ protected $targetDirs = []; @@ -80,7 +80,7 @@ class CheckSniffCompleteness /** * Directories to exclude from the scan. * - * @var array + * @var array */ protected $excludedDirs = [ 'vendor', @@ -89,14 +89,14 @@ class CheckSniffCompleteness /** * List of all files in the repo. * - * @var array + * @var array Key is a file name, value irrelevant. */ protected $allFiles = []; /** * List of all sniff files in the repo. * - * @var array + * @var array */ protected $allSniffs = []; @@ -105,7 +105,7 @@ class CheckSniffCompleteness * * Keys are the strings to search for, values the replacement values. * - * @var array + * @var array */ private $sniffToDoc = [ '/Sniffs/' => '/Docs/', @@ -117,7 +117,7 @@ class CheckSniffCompleteness * * Keys are the strings to search for, values the replacement values. * - * @var array + * @var array */ private $sniffToUnitTest = [ '/Sniffs/' => '/Tests/', @@ -127,7 +127,7 @@ class CheckSniffCompleteness /** * Possible test case file extensions. * - * @var array + * @var array */ private $testCaseExtensions = [ '.inc', diff --git a/Scripts/FileList.php b/Scripts/FileList.php index e12b674..1636c20 100644 --- a/Scripts/FileList.php +++ b/Scripts/FileList.php @@ -95,7 +95,7 @@ public function getIterator() /** * Retrieve the filtered file list as an array. * - * @return array + * @return array */ public function getList() { diff --git a/Tests/DocsXsd/DocsXsdTest.php b/Tests/DocsXsd/DocsXsdTest.php index fc32ae7..d978967 100644 --- a/Tests/DocsXsd/DocsXsdTest.php +++ b/Tests/DocsXsd/DocsXsdTest.php @@ -58,7 +58,7 @@ public function testXsdValidationPassedWithValidXml($fixtureFile) /** * Data provider for valid test cases. * - * @return array + * @return array> */ public function dataValidXsd() { @@ -108,7 +108,7 @@ public function testXsdValidationFailsForInvalidXml($fixtureFile, $expectedStdOu /** * Data provider for invalid test cases. * - * @return array + * @return array> */ public function dataInvalidXsd() { diff --git a/Tests/IOTestCase.php b/Tests/IOTestCase.php index a538376..d7ccb71 100644 --- a/Tests/IOTestCase.php +++ b/Tests/IOTestCase.php @@ -28,10 +28,10 @@ abstract class IOTestCase extends XTestCase * Note: if the command itself already contains a "working directory" argument, * this parameter will normally not need to be passed. * - * @return array Format: - * 'exitcode' int The exit code from the command. - * 'stdout' string The output send to stdout. - * 'stderr' string The output send to stderr. + * @return array Format: + * 'exitcode' int The exit code from the command. + * 'stdout' string The output send to stdout. + * 'stderr' string The output send to stderr. * * @throws \RuntimeException When the passed arguments do not comply. * @throws \RuntimeException When no resource could be obtained to execute the command.