PSR-19. inline @see tag

[Google user]

in phpdocumentor's phpdoc documentation it's stated that @see tag does have inline syntax:

Syntax
@see [URI | FQSEN] [<description>]
or inline
{@see [URI | FQSEN] [<description>]}
http://docs.phpdoc.org/references/phpdoc/tags/see.html#syntax

 

why does psr-19 omits it?

Syntax
@see [URI | "FQSEN"] [<description>]
https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#syntax-11

 

imo, this is very useful feature, i'm convinced it should be allowed

what is the reason to exclude it from standard?

[Joe T.]

Hopefully this is just part of the early draft process and more work will be done to fully detail the already supported functionality to make it part of the standard. i'd hate to see existing features omitted from the PSR. That basically means phpDoc has two options:

1. Drop functionality many people find useful.
2. Ignore the PSR, defeating its purpose.

-jlt

[Chuck Burgess]

Correct... things were being pared out of the doc initially, in an attempt to get consensus on a minimum baseline of items.  Restoring some things would follow, as well as potential new things.

CRB

--
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 php-fig+u...@googlegroups.com.
To post to this group, send email to php...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/215b9c56-a9a0-45b6-a64c-040016c0d165%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Alexander Makarov]

Need that as well.