Merge pull request #151 from PHPCSStandards/docs/link-tags-add-descriptions

Docs: add description to `@link` tags

Author: jrfnl

PHPCSUtils/Tokens/Collections.php

@@ -202,7 +202,7 @@ class Collections
     /**
      * Tokens for the PHP magic constants.
      *
-     * @link https://www.php.net/language.constants.predefined
+     * @link https://www.php.net/language.constants.predefined PHP Manual on magic constants
      *
      * @since 1.0.0
      *
@@ -287,7 +287,7 @@ class Collections
     /**
      * Tokens types used for "forwarding" calls within OO structures.
      *
-     * @link https://www.php.net/language.oop5.paamayim-nekudotayim
+     * @link https://www.php.net/language.oop5.paamayim-nekudotayim PHP Manual on OO forwarding calls
      *
      * @since 1.0.0
      *

PHPCSUtils/Utils/ControlStructures.php

@@ -213,7 +213,7 @@ public static function isElseIf(File $phpcsFile, $stackPtr)
      * control structure syntax into account, this method can be used to retrieve the
      * scope opener/closer for the declare statement.
      *
-     * @link https://github.com/squizlabs/PHP_CodeSniffer/pull/2843
+     * @link https://github.com/squizlabs/PHP_CodeSniffer/pull/2843 PHPCS PR #2843
      *
      * @since 1.0.0
      *

PHPCSUtils/Utils/Numbers.php

@@ -74,7 +74,7 @@ class Numbers
     /**
      * Regex to determine whether the contents of an arbitrary string represents a float.
      *
-     * @link https://www.php.net/language.types.float
+     * @link https://www.php.net/language.types.float PHP Manual on floats
      *
      * @since 1.0.0
      *
@@ -157,8 +157,8 @@ class Numbers
      * are tokenized incorrectly - with the exception of PHPCS 3.5.3 as the buggyness of the original
      * backfill implementation makes it impossible to provide reliable results.
      *
-     * @link https://github.com/squizlabs/PHP_CodeSniffer/issues/2546
-     * @link https://github.com/squizlabs/PHP_CodeSniffer/pull/2771
+     * @link https://github.com/squizlabs/PHP_CodeSniffer/issues/2546 PHPCS issue #2546
+     * @link https://github.com/squizlabs/PHP_CodeSniffer/pull/2771   PHPCS PR #2771
      *
      * @since 1.0.0
      *

PHPCSUtils/Utils/Orthography.php

@@ -27,7 +27,7 @@ class Orthography
     /**
      * Characters which are considered terminal points for a sentence.
      *
-     * @link https://www.thepunctuationguide.com/terminal-points.html
+     * @link https://www.thepunctuationguide.com/terminal-points.html Punctuation guide on terminal points.
      *
      * @since 1.0.0
      *

PHPCSUtils/Utils/Variables.php

@@ -38,7 +38,7 @@ class Variables
      *
      * @since 1.0.0
      *
-     * @link http://php.net/reserved.variables
+     * @link http://php.net/reserved.variables PHP Manual on reserved variables
      *
      * @var array <string> => <bool>
      */