Docs: use the alpha version nr in @since

Until 1.0.0 has been released, it is important to know in which alpha certain things were introduced.

Once 1.0.0 comes out, this should be reverted to read `1.0.0`.

Author: jrfnl

PHPCSUtils/BackCompat/Helper.php

@@ -173,7 +173,7 @@ public static function getTabWidth(File $phpcsFile)
      * Get the applicable (file) encoding as passed to PHP_CodeSniffer from the
      * command-line or the ruleset.
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @param \PHP_CodeSniffer\Files\File|null $phpcsFile Optional. The current file being processed.
      *

PHPCSUtils/TestUtils/UtilityMethodTestCase.php

@@ -103,7 +103,7 @@ abstract class UtilityMethodTestCase extends TestCase
     /**
      * The PHPCS version the tests are being run on.
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @var string
      */
@@ -275,7 +275,7 @@ public static function setUpTestFile()
      * Note: This is a PHPUnit cross-version compatible {@see \PHPUnit\Framework\TestCase::setUp()}
      * method.
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @before
      *

PHPCSUtils/Tokens/Collections.php

@@ -204,7 +204,7 @@ class Collections
      *
      * @link https://www.php.net/language.constants.predefined PHP Manual on magic constants
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @var array <int|string> => <int|string>
      */
@@ -289,7 +289,7 @@ class Collections
      *
      * @link https://www.php.net/language.oop5.paamayim-nekudotayim PHP Manual on OO forwarding calls
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @var array <int|string> => <int|string>
      */
@@ -307,7 +307,7 @@ class Collections
      * echo namespace\Sub\ClassName::method();
      * ```
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @var array <int|string> => <int|string>
      */
@@ -520,7 +520,7 @@ class Collections
      *
      * Note: this is a method, not a property as the `T_FN` token for arrow functions may not exist.
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha2
      *
      * @return array <int|string> => <int|string>
      */
@@ -549,7 +549,7 @@ public static function arrowFunctionTokensBC()
      *
      * @see \PHPCSUtils\Tokens\Collections::functionDeclarationTokensBC() Related method (PHPCS 2.6.0+).
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @return array <int|string> => <int|string>
      */
@@ -590,7 +590,7 @@ public static function functionDeclarationTokens()
      * @see \PHPCSUtils\Tokens\Collections::functionDeclarationTokens() Related method (PHPCS 3.5.3+).
      * @see \PHPCSUtils\Utils\FunctionDeclarations::isArrowFunction()   Arrow function verification.
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @return array <int|string> => <int|string>
      */
@@ -622,7 +622,7 @@ public static function functionDeclarationTokensBC()
      *
      * @see \PHPCSUtils\Tokens\Collections::$parameterTypeTokens Related property (PHPCS 3.3.0+).
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @return array <int|string> => <int|string>
      */
@@ -654,7 +654,7 @@ public static function parameterTypeTokensBC()
      *
      * @see \PHPCSUtils\Tokens\Collections::$propertyTypeTokens Related property (PHPCS 3.3.0+).
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @return array <int|string> => <int|string>
      */
@@ -680,7 +680,7 @@ public static function propertyTypeTokensBC()
      *
      * @see \PHPCSUtils\Tokens\Collections::$returnTypeTokens Related property (PHPCS 3.5.4+).
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @return array <int|string> => <int|string>
      */

PHPCSUtils/Utils/ControlStructures.php

@@ -348,7 +348,7 @@ public static function getDeclareScopeOpenClose(File $phpcsFile, $stackPtr)
     /**
      * Retrieve the exception(s) being caught in a CATCH condition.
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
      * @param int                         $stackPtr  The position of the token we are checking.

PHPCSUtils/Utils/NamingConventions.php

@@ -22,7 +22,7 @@
  * - {@link https://www.php.net/language.variables.basics variable} names;
  * - {@link https://www.php.net/language.constants constant} names.
  *
- * @since 1.0.0
+ * @since 1.0.0-alpha3
  */
 class NamingConventions
 {

PHPCSUtils/Utils/UseStatements.php

@@ -368,7 +368,7 @@ public static function splitImportUseStatement(File $phpcsFile, $stackPtr)
      * @see \PHPCSUtils\AbstractSniffs\AbstractFileContextSniff
      * @see \PHPCSUtils\Utils\UseStatements::splitImportUseStatement()
      *
-     * @since 1.0.0
+     * @since 1.0.0-alpha3
      *
      * @param \PHP_CodeSniffer\Files\File $phpcsFile             The file where this token was found.
      * @param int                         $stackPtr              The position in the stack of the `T_USE` token.