Announce removal of deprecated methods (#5956)

Refs vimeo/psalm#4700

src/Psalm/DocComment.php

@@ -52,7 +52,7 @@ class DocComment
      * @psalm-return array{description:string, specials:array<string, array<int, string>>}
      * @psalm-suppress PossiblyUnusedMethod
      *
-     * @deprecated use parsePreservingLength instead
+     * @deprecated use parsePreservingLength instead, going to be removed in Psalm 5
      *
      * @psalm-pure
      */

src/Psalm/Internal/Analyzer/TypeAnalyzer.php

@@ -19,7 +19,7 @@ class TypeAnalyzer
     /**
      * Does the input param type match the given param type
      *
-     * @deprecated in favour of UnionTypeComparator
+     * @deprecated in favour of UnionTypeComparator, going to be removed in Psalm 5
      * @psalm-suppress PossiblyUnusedMethod
      */
     public static function isContainedBy(
@@ -45,7 +45,7 @@ class TypeAnalyzer
     /**
      * Does the input param atomic type match the given param atomic type
      *
-     * @deprecated in favour of AtomicTypeComparator
+     * @deprecated in favour of AtomicTypeComparator, going to be removed in Psalm 5
      * @psalm-suppress PossiblyUnusedMethod
      */
     public static function isAtomicContainedBy(

src/Psalm/Issue/CodeIssue.php

@@ -39,7 +39,7 @@ abstract class CodeIssue
     }
 
     /**
-     * @deprecated
+     * @deprecated going to be removed in Psalm 5
      * @psalm-suppress PossiblyUnusedMethod
      */
     public function getLocation(): CodeLocation
@@ -70,7 +70,7 @@ abstract class CodeIssue
     }
 
     /**
-     * @deprecated
+     * @deprecated going to be removed in Psalm 5
      * @psalm-suppress PossiblyUnusedMethod for convenience
      */
     public function getFileName(): string
@@ -79,7 +79,7 @@ abstract class CodeIssue
     }
 
     /**
-     * @deprecated
+     * @deprecated going to be removed in Psalm 5
      * @psalm-suppress PossiblyUnusedMethod
      */
     public function getMessage(): string