Deprecate annotation classes (#187)

* Deprecate annotation classes

* More explicit deprecation message

---------

Co-authored-by: mgiraud <marc@mac.home>

Author: mgiraud

composer.json

@@ -11,6 +11,7 @@
     "require": {
         "php": "^8.1",
         "nikic/php-parser": "^5.0",
+        "symfony/deprecation-contracts": "^2.5 || ^3.0",
         "symfony/finder": "^5.4 || ^6.4 || ^7.0",
         "twig/twig": "^2.0 || ^3.0",
         "phpstan/phpdoc-parser": "^2.3"

src/Annotation/Desc.php

@@ -11,6 +11,7 @@
 
 namespace Translation\Extractor\Annotation;
 
+trigger_deprecation('php-translation/extractor', '2.3', 'The "%s" class is deprecated and will be removed soon. It is now considered as a PHPDoc tag.', Desc::class);
 /**
  * @deprecated since 2.3, this class is not used anymore. @Desc is now considered as a PHPDoc tag.
  *

src/Annotation/Ignore.php

@@ -11,6 +11,7 @@
 
 namespace Translation\Extractor\Annotation;
 
+trigger_deprecation('php-translation/extractor', '2.3', 'The "%s" class is deprecated and will be removed soon. It is now considered as a PHPDoc tag.', Ignore::class);
 /**
  * @deprecated since 2.3, this class is not used anymore. @Ignore is now considered as a PHPDoc tag.
  *

src/Annotation/Translate.php

@@ -11,6 +11,7 @@
 
 namespace Translation\Extractor\Annotation;
 
+trigger_deprecation('php-translation/extractor', '2.3', 'The "%s" class is deprecated and will be removed soon. It is now considered as a PHPDoc tag.', Translate::class);
 /**
  * @deprecated since 2.3, this class is not used anymore. @Translate is now considered as a PHPDoc tag.
  *