[PSR-19] Allow FQSEN in @link

[Alexander Makarov]

Currently in @see tag FQSEN is allowed: https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#512-see but it's not allowed in @link https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#56-link so there's no way to reference a class in the description such as:

By default, {@link \Yii::$container} refers to a Container instance which is used by {@link \Yii::createObject()} to create new object instances.

For Yii we've invented our own syntax but we'd like to switch to standard one:

By default, [[\Yii::$container]] refers to a Container instance which is used by [[\Yii::createObject()]] to create new object instances.

[Google user]

why at all do you want to use the @link tag and don't want to use @see tag?

The @see tag indicates a reference from the associated "Structural Elements" to a website or other "Structural Elements".
The @link tag indicates a custom relation between the associated "Structural Element" and a website, which is identified by an absolute URI.

as we can see, the @link tag should be used for uris, and @see tag - for structural elements. why you want to use @link tag for a structural element?

or do you mean that you cannot use the @see tag inside a description using the inline syntax? then why don't you propose to allow the inline syntax for @see tag?

please support the following thread instead: https://groups.google.com/forum/#!msg/php-fig/BQXbVm8OYDk/vRHMZfU4CwAJ

otherwise, are you just proposing to make the @link tag just an alias to the @see tag? what will be the difference between them if php-fig will implement your proposition? i see no difference at all. can you point it out for me please?

[Alexander Makarov]

Yes. We need both structural element links and regular links in the description. Thanks for the link to the thread. That is exactly what we need.