aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/fdp-primer
diff options
context:
space:
mode:
authorYaroslav Tykhiy <ytykhiy@gmail.com>2005-09-12 16:01:07 +0000
committerYaroslav Tykhiy <ytykhiy@gmail.com>2005-09-12 16:01:07 +0000
commita08f137b33191ff7fa43346d5474265b55cd1341 (patch)
treef66b81021a03f8939c4d81c4818aa5ebce591951 /en_US.ISO8859-1/books/fdp-primer
parent3735e320fd2580ba852178e7dd9228472884bce3 (diff)
downloaddoc-a08f137b33191ff7fa43346d5474265b55cd1341.tar.gz
doc-a08f137b33191ff7fa43346d5474265b55cd1341.zip
Don't give a poor example of letting special characters slip
into text cut'n'pasted to a <pre> HTML element. Warn readers that such characters are likely to appear in plain-text sources often used to copy pre-formatted text from.
Notes
Notes: svn path=/head/; revision=25610
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer')
-rw-r--r--en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml13
1 files changed, 12 insertions, 1 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
index 01f262b2b9..631110fea7 100644
--- a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
+++ b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
@@ -332,11 +332,22 @@
There is a new copy of my primer for contributors to the FreeBSD
Documentation Project available at
- <URL:http://people.FreeBSD.org/~nik/primer/index.html>
+ &lt;URL:http://people.FreeBSD.org/~nik/primer/index.html&gt;
Comments appreciated.
N</pre>]]></programlisting>
+
+ <para>Keep in mind that <literal>&lt;</literal> and
+ <literal>&amp;</literal> still are recognized as special
+ characters in pre-formatted text. This is why the example
+ shown had to use <literal>&amp;lt;</literal> instead of
+ <literal>&lt;</literal>. For consistency,
+ <literal>&amp;gt;</literal> was used in place of
+ <literal>&gt;</literal>, too. Watch out for the special characters
+ that may appear in text copied from a plain-text source,
+ e.g., an e-mail message or program code.</para>
+
</example>
</sect3>