Add aparagraph that notes CDATA and RCDATA is not validated, and

suggest that SGML examples are validated externally.

Approved by:	   nik
Original idea by:  Michael Lucas <mwlucas@blackhelicopters.org>
This commit is contained in:
Giorgos Keramidas 2001-11-14 01:16:34 +00:00
parent 12edac9ef8
commit 6f5417d33e
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=11197

View file

@ -1372,6 +1372,15 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
parser encounters this it will ignore the &lt; and &amp; symbols
embedded in the content.</para>
<note>
<para>When you use <literal>CDATA</literal> or
<literal>RCDATA</literal> in examples of text marked up in SGML,
keep in mind that the content of <literal>CDATA</literal> is not
validated. You have to check the included SGML text using other
means. You could, for example, write the example in another
document, validate the example code, and then paste it to your
<literal>CDATA</literal> content.</para>
</note>
<!-- The nesting of CDATA within the next example is disgusting -->
<example>