Add extra deprecation

phpDocumentor · Mar 20, 2024 · f2057d4 · f2057d4
1 parent fc9a233
commit f2057d4
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/src/DocBlock/Tags/Factory/ParamFactory.php b/src/DocBlock/Tags/Factory/ParamFactory.php
@@ -4,6 +4,7 @@
 
 namespace phpDocumentor\Reflection\DocBlock\Tags\Factory;
 
+use Doctrine\Deprecations\Deprecation;
 use phpDocumentor\Reflection\DocBlock\DescriptionFactory;
 use phpDocumentor\Reflection\DocBlock\Tag;
 use phpDocumentor\Reflection\DocBlock\Tags\Param;
@@ -37,6 +38,14 @@ public function create(PhpDocTagNode $node, Context $context): Tag
         $tagValue = $node->value;
 
         if ($tagValue instanceof InvalidTagValueNode) {
+            Deprecation::trigger(
+                'phpdocumentor/reflection-docblock',
+                'https://github.com/phpDocumentor/ReflectionDocBlock/issues/362',
+                sprintf(
+                    'Param tag value "%s" is invalid, falling back to legacy parsing. Please update your docblocks.',
+                    $tagValue->value
+                )
+            );
             return Param::create($tagValue->value, $this->typeResolver, $this->descriptionFactory, $context);
         }