Squiz/EmbeddedPhp: document the behaviour for closed tag block at end of file [1]

As things are, the last tag block in a file, at the end of a file, will always be ignored if it contains a PHP close tag, even when it would otherwise trigger errors.

These tests document this behaviour.

Author: jrfnl

src/Standards/Squiz/Tests/PHP/EmbeddedPhpUnitTest.14.inc

@@ -0,0 +1,8 @@
+<?php
+// This test case file MUST always start with a long open PHP tag set (with this comment) to prevent
+// the tests running into the "first PHP open tag excepted" condition breaking the tests.
+// Tests related to that "first PHP open tag excepted" condition should go in separate files.
+?>
+<!-- The complete tag block will be ignored when it is the last (closed) tag block in a file, even when it is an empty tag set. -->
+<?php
+?>

src/Standards/Squiz/Tests/PHP/EmbeddedPhpUnitTest.15.inc

@@ -0,0 +1,9 @@
+<?php
+// This test case file MUST always start with a long open PHP tag set (with this comment) to prevent
+// the tests running into the "first PHP open tag excepted" condition breaking the tests.
+// Tests related to that "first PHP open tag excepted" condition should go in separate files.
+?>
+<!-- The complete tag block will be ignored when it is the last (closed) tag block in a file, even when it is an empty tag set. -->
+<!-- Note: with short open tags, the empty PHP tag set is a parse error. -->
+<?=
+?>

src/Standards/Squiz/Tests/PHP/EmbeddedPhpUnitTest.16.inc

@@ -0,0 +1,8 @@
+<?php
+// This test case file MUST always start with a long open PHP tag set (with this comment) to prevent
+// the tests running into the "first PHP open tag excepted" condition breaking the tests.
+// Tests related to that "first PHP open tag excepted" condition should go in separate files.
+?>
+<!-- The complete tag block will be ignored when it is the last (closed) tag block in a file, even when it would otherwise trigger errors. -->
+<?php
+    echo 'too much indent and close tag not on own line'; ?>

src/Standards/Squiz/Tests/PHP/EmbeddedPhpUnitTest.17.inc

@@ -0,0 +1,8 @@
+<?php
+// This test case file MUST always start with a long open PHP tag set (with this comment) to prevent
+// the tests running into the "first PHP open tag excepted" condition breaking the tests.
+// Tests related to that "first PHP open tag excepted" condition should go in separate files.
+?>
+<!-- The complete tag block will be ignored when it is the last (closed) tag block in a file, even when it would otherwise trigger errors. -->
+<?=
+    'too much indent and close tag not on own line'; ?>