Polishing Up "TestDox.php' PHPDoc Blocks for Clarity

Added the missing parenthesis and period for proper punctuation and formatted the doc block to meet PHPDocumentor standards.
This commit is contained in:
Sarfaraz Muhammad Sajib
2023-10-16 10:56:06 +06:00
committed by GitHub
parent 502f37d280
commit 9fb64599de

View File

@ -14,13 +14,12 @@ final class TestDox implements AddsAnnotations
*/ */
public function __invoke(TestCaseMethodFactory $method, array $annotations): array public function __invoke(TestCaseMethodFactory $method, array $annotations): array
{ {
/* /*
* escapes docblock according to * Escapes docblock according to
* https://manual.phpdoc.org/HTMLframesConverter/default/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#basics.desc * https://manual.phpdoc.org/HTMLframesConverter/default/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#basics.desc
* *
* note: '@' escaping is not needed as it cannot be the first character of the line (it always starts with @testdox * note: '@' escaping is not needed as it cannot be the first character of the line (it always starts with @testdox).
*/ */
assert($method->description !== null); assert($method->description !== null);
$methodDescription = str_replace('*/', '{@*}', $method->description); $methodDescription = str_replace('*/', '{@*}', $method->description);