Generic/CallTimePassByReference: hard deprecate the sniff

Related to 921

Author: jrfnl

src/Standards/Generic/Sniffs/Functions/CallTimePassByReferenceSniff.php

@@ -10,10 +10,11 @@
 namespace PHP_CodeSniffer\Standards\Generic\Sniffs\Functions;
 
 use PHP_CodeSniffer\Files\File;
+use PHP_CodeSniffer\Sniffs\DeprecatedSniff;
 use PHP_CodeSniffer\Sniffs\Sniff;
 use PHP_CodeSniffer\Util\Tokens;
 
-class CallTimePassByReferenceSniff implements Sniff
+class CallTimePassByReferenceSniff implements Sniff, DeprecatedSniff
 {
 
 
@@ -138,4 +139,40 @@ public function process(File $phpcsFile, $stackPtr)
     }//end process()
 
 
+    /**
+     * Provide the version number in which the sniff was deprecated.
+     *
+     * @return string
+     */
+    public function getDeprecationVersion()
+    {
+        return 'v3.12.1';
+
+    }//end getDeprecationVersion()
+
+
+    /**
+     * Provide the version number in which the sniff will be removed.
+     *
+     * @return string
+     */
+    public function getRemovalVersion()
+    {
+        return 'v4.0.0';
+
+    }//end getRemovalVersion()
+
+
+    /**
+     * Provide a custom message to display with the deprecation.
+     *
+     * @return string
+     */
+    public function getDeprecationMessage()
+    {
+        return '';
+
+    }//end getDeprecationMessage()
+
+
 }//end class