explaining shorttags warnings

1 files changed, 40 insertions, 0 deletions

diff --git a/share/templates/en_US/error_messages.cfg b/share/templates/en_US/error_messages.cfg
index 6fe0cc9..bb76cef 100644
--- a/share/templates/en_US/error_messages.cfg
+++ b/share/templates/en_US/error_messages.cfg
@@ -1187,6 +1187,16 @@
 </msg>
 <msg 246>
   original = "unclosed start-tag requires SHORTTAG YES"
+    verbose <<.EOF.
+    <div class="ve mid-246">
+      <p>
+        The construct &lt;foo&lt;bar&gt; is valid in HTML (it is an example of the rather obscure “Shorttags” feature)
+        but <a href="http://www.w3.org/TR/html4/appendix/notes.html#h-B.3.7">its use is not recommended</a>.
+        In most cases, this is a typo that you will want to fix. If you really want to use shorttags, 
+        be aware that they are not well implemented by browsers.
+      </p>
+    </div>
+  .EOF.
 </msg>
 <msg 247>
   original = "NET-enabling start-tag requires SHORTTAG YES"
@@ -1205,6 +1215,16 @@
 </msg>
 <msg 248>
   original = "unclosed end-tag requires SHORTTAG YES"
+    verbose <<.EOF.
+    <div class="ve mid-248">
+      <p>
+        The construct &lt;/foo&lt;bar&gt; is valid in HTML (it is an example of the rather obscure “Shorttags” feature)
+        but <a href="http://www.w3.org/TR/html4/appendix/notes.html#h-B.3.7">its use is not recommended</a>.
+        In most cases, this is a typo that you will want to fix. If you really want to use shorttags, 
+        be aware that they are not well implemented by browsers.
+      </p>
+    </div>
+  .EOF.
 </msg>
 <msg 249>
   original = "DTDs other than base allowed only if CONCUR YES or EXPLICIT YES"
@@ -1469,9 +1489,29 @@
 </msg>
 <msg 333>
   original = "empty start-tag"
+    verbose <<.EOF.
+    <div class="ve mid-334">
+      <p>
+        The construct &lt;&gt; is sometimes valid in HTML (it is an example of the rather obscure “Shorttags” feature)
+        but <a href="http://www.w3.org/TR/html4/appendix/notes.html#h-B.3.7">its use is not recommended</a>.
+        In most cases, this is a typo that you will want to fix. If you really want to use shorttags, 
+        be aware that they are not well implemented by browsers.
+      </p>
+    </div>
+.EOF.
 </msg>
 <msg 334>
   original = "empty end-tag"
+    verbose <<.EOF.
+    <div class="ve mid-334">
+      <p>
+        The construct &lt;/&gt; is valid in HTML (it is an example of the rather obscure “Shorttags” feature)
+        but <a href="http://www.w3.org/TR/html4/appendix/notes.html#h-B.3.7">its use is not recommended</a>.
+        In most cases, this is a typo that you will want to fix. If you really want to use shorttags, 
+        be aware that they are not well implemented by browsers.
+      </p>
+    </div>
+.EOF.
 </msg>
 <msg 335>
   original = "unused short reference map %1"