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?

On Tuesday, 14 May 2019 14:28:54 UTC+3, Alexander Makarov wrote:
>
> 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.
>
>

-- 
You received this message because you are subscribed to the Google Groups "PHP 
Framework Interoperability Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/php-fig/cf6666a5-017b-437b-aa52-978a7210ac7b%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
  • [PSR-19] Allo... 'Alexander Makarov' via PHP Framework Interoperability Group
    • Re: [PSR... Google user
      • Re: ... 'Alexander Makarov' via PHP Framework Interoperability Group

Reply via email to