From e8f54f255a7295fc0da368390706b1ae5d90268c Mon Sep 17 00:00:00 2001
From: ross <unknown>
Date: Thu, 13 Jan 2005 14:44:24 +0000
Subject: [haddock @ 2005-01-13 14:44:24 by ross] Describe numeric character
 references.

---
 doc/haddock.xml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

(limited to 'doc')

diff --git a/doc/haddock.xml b/doc/haddock.xml
index 0b97c92c..df1dc4a7 100644
--- a/doc/haddock.xml
+++ b/doc/haddock.xml
@@ -1229,6 +1229,28 @@ module A where
 	can also be escaped using <literal>\</literal>.</para>
       </section>
 
+      <section>
+	<title>Character references</title>
+
+	<para>Although Haskell source files may contain any character
+	from the Unicode character set, the encoding of these characters
+	as bytes varies between systems, so that only source files
+	restricted to the ASCII character set are portable.  Other
+	characters may be specified in character and string literals
+	using Haskell character escapes.  To represent such characters
+	in documentation comments, Haddock supports SGML-style numeric
+	character references of the forms
+	<literal>&amp;#</literal><replaceable>D</replaceable><literal>;</literal>
+	and
+	<literal>&amp;#x</literal><replaceable>H</replaceable><literal>;</literal>
+	where <replaceable>D</replaceable> and <replaceable>H</replaceable>
+	are decimal and hexadecimal numbers denoting a code position
+	in Unicode (or ISO 10646).  For example, the references
+	<literal>&amp;#x3BB;</literal>, <literal>&amp;#x3bb;</literal>
+	and <literal>&amp;#955;</literal> all represent the lower-case
+	letter lambda.</para>
+      </section>
+
       <section>
 	<title>Code Blocks</title>
 
-- 
cgit v1.2.3