Merge pull request #983 from Muhammad-Sarfaraz/patch-1

Polishing Up "TestDox.php' PHPDoc Blocks for Clarity
This commit is contained in:
Nuno Maduro
2023-10-17 10:02:08 +01:00
committed by GitHub

View File

@ -14,13 +14,12 @@ final class TestDox implements AddsAnnotations
*/
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
*
* 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);
$methodDescription = str_replace('*/', '{@*}', $method->description);