Following historical precedence from phpDocumentor 1.x, the inline
`@internal` tag used an unusual syntax:
`{@internal*}}*` (note the double closing braces)
>From the 1.x manual:
Unlike other inline tags, {@internal}} may contain other inline tags due to
its purpose. To terminate an {@internal}} inline tag, you must use two
ending brackets "}}"
(http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.inlineinternal.pkg.html)
I can only assume this need had something to do with the state of parsers
back then.
When PSR-5 was first drafted, this syntax drew ire from many due to how
IDEs would treat it as an unbalanced brace.
I have issued a pull request
(https://github.com/php-fig/fig-standards/pull/1100) that seeks to remove
this behavior, while at least acknowledging its existence in the past. I'm
now asking for feedback on this proposed change.
*Please discuss this draft change here on this mailing list thread, rather
than on the PR.*
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 [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/029a2abf-29b3-4bd2-bc86-2ca9128b07a2%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
