Merge pull request #149 from PHPCSStandards/docs/various-tag-order-fixes

Docs: various tag order fixes

Author: jrfnl

PHPCSUtils/Tokens/Collections.php

@@ -63,11 +63,11 @@ class Collections
     /**
      * Tokens which are used to create arrays.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$shortArrayTokens Related property containing only tokens used
      *                                                        for short arrays.
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $arrayTokens = [
@@ -82,11 +82,11 @@ class Collections
      * List which is backward-compatible with PHPCS < 3.3.0.
      * Should only be used selectively.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$shortArrayTokensBC Related property containing only tokens used
      *                                                          for short arrays (cross-version).
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $arrayTokensBC = [
@@ -165,11 +165,11 @@ class Collections
     /**
      * Tokens which are used to create lists.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$shortListTokens Related property containing only tokens used
      *                                                       for short lists.
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $listTokens = [
@@ -184,11 +184,11 @@ class Collections
      * List which is backward-compatible with PHPCS < 3.3.0.
      * Should only be used selectively.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$shortListTokensBC Related property containing only tokens used
      *                                                         for short lists (cross-version).
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $listTokensBC = [
@@ -202,10 +202,10 @@ class Collections
     /**
      * Tokens for the PHP magic constants.
      *
-     * @since 1.0.0
-     *
      * @link https://www.php.net/language.constants.predefined
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $magicConstants = [
@@ -433,10 +433,10 @@ class Collections
     /**
      * Tokens which are used for short arrays.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$arrayTokens Related property containing all tokens used for arrays.
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $shortArrayTokens = [
@@ -450,11 +450,11 @@ class Collections
      * List which is backward-compatible with PHPCS < 3.3.0.
      * Should only be used selectively.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$arrayTokensBC Related property containing all tokens used for arrays
      *                                                    (cross-version).
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $shortArrayTokensBC = [
@@ -467,10 +467,10 @@ class Collections
     /**
      * Tokens which are used for short lists.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$listTokens Related property containing all tokens used for lists.
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $shortListTokens = [
@@ -484,11 +484,11 @@ class Collections
      * List which is backward-compatible with PHPCS < 3.3.0.
      * Should only be used selectively.
      *
-     * @since 1.0.0
-     *
      * @see \PHPCSUtils\Tokens\Collections::$listTokensBC Related property containing all tokens used for lists
      *                                                    (cross-version).
      *
+     * @since 1.0.0
+     *
      * @var array <int|string> => <int|string>
      */
     public static $shortListTokensBC = [

PHPCSUtils/Utils/FunctionDeclarations.php

@@ -136,13 +136,13 @@ class FunctionDeclarations
      *
      * Alias for the {@see \PHPCSUtils\Utils\ObjectDeclarations::getName()} method.
      *
-     * @codeCoverageIgnore
-     *
      * @see \PHPCSUtils\BackCompat\BCFile::getDeclarationName() Original function.
      * @see \PHPCSUtils\Utils\ObjectDeclarations::getName()     PHPCSUtils native improved version.
      *
      * @since 1.0.0
      *
+     * @codeCoverageIgnore
+     *
      * @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
      * @param int                         $stackPtr  The position of the function keyword token.
      *
@@ -974,15 +974,15 @@ public static function isPHPDoubleUnderscoreMethodName($name)
     /**
      * Checks if a given function is a magic method or a PHP native double underscore method.
      *
+     * {@internal Not the most efficient way of checking this, but less efficient ways will get
+     *            less reliable results or introduce a lot of code duplication.}
+     *
      * @see \PHPCSUtils\Utils\FunctionDeclaration::isSpecialMethodName() For when you already know the name of the
      *                                                                   method and scope checking is done in the
      *                                                                   sniff.
      *
      * @since 1.0.0
      *
-     * {@internal Not the most efficient way of checking this, but less efficient ways will get
-     *            less reliable results or introduce a lot of code duplication.}
-     *
      * @param \PHP_CodeSniffer\Files\File $phpcsFile The file where this token was found.
      * @param int                         $stackPtr  The T_FUNCTION token to check.
      *