aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
diff options
context:
space:
mode:
authorGiorgos Keramidas <keramida@FreeBSD.org>2001-11-14 01:16:34 +0000
committerGiorgos Keramidas <keramida@FreeBSD.org>2001-11-14 01:16:34 +0000
commit6f5417d33eea443459131b9657ebdf284aa0c67c (patch)
treecb56f32591f6b0c53d18e1075378d5d6ea916ac2 /en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
parent12edac9ef8492c9bc85bb4b757c092e4c964dcba (diff)
downloaddoc-6f5417d33eea443459131b9657ebdf284aa0c67c.tar.gz
doc-6f5417d33eea443459131b9657ebdf284aa0c67c.zip
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>
Notes
Notes: svn path=/head/; revision=11197
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml')
-rw-r--r--en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml9
1 files changed, 9 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
index 18add92569..b966912874 100644
--- a/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
+++ b/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
@@ -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>