Given the approvals on the PR, I've merged it and will consider this thread
closed.
CRB
On Monday, October 15, 2018 at 2:59:07 PM UTC-5, Chuck Burgess wrote:
>
> 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/4b6e9e56-002f-47df-9a1c-c298ca4666af%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
