[PSR-19] deprecate double closing brace on inline internal tag

[Chuck Burgess]

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

[Chuck Burgess]

Given the approvals on the PR, I've merged it and will consider this thread closed.

CRB