Docs: various tag order fixes

Includes moving inline `{@internal}` tags up as they can only be part of the long description as otherwise they are interpreted as meaning the function is _internal_.

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 = [
@@ -430,10 +430,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 = [
@@ -447,11 +447,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 = [
@@ -464,10 +464,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 = [
@@ -481,11 +481,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

@@ -134,13 +134,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 declaration token
      *                                               which declared the function.
@@ -954,15 +954,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.
      *