From 300c5466a7c9cfe3ed22bba2a88ba21058406402 Mon Sep 17 00:00:00 2001
From: Hans Bolinder <hasse@erlang.org>
Date: Thu, 4 Oct 2012 15:58:26 +0200
Subject: [stdlib, kernel] Introduce Unicode support for Erlang source files

Expect modifications, additions and corrections.

There is a kludge in file_io_server and
erl_scan:continuation_location() that's not so pleasing.
---
 lib/stdlib/doc/src/io_lib.xml | 66 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 65 insertions(+), 1 deletion(-)

(limited to 'lib/stdlib/doc/src/io_lib.xml')

diff --git a/lib/stdlib/doc/src/io_lib.xml b/lib/stdlib/doc/src/io_lib.xml
index 506c1792f1..32ef2893eb 100644
--- a/lib/stdlib/doc/src/io_lib.xml
+++ b/lib/stdlib/doc/src/io_lib.xml
@@ -4,7 +4,7 @@
 <erlref>
   <header>
     <copyright>
-      <year>1996</year><year>2011</year>
+      <year>1996</year><year>2012</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -42,6 +42,12 @@
     <datatype>
       <name name="chars"/>
     </datatype>
+    <datatype>
+      <name name="unicode_chars"/>
+    </datatype>
+    <datatype>
+      <name name="unicode_string"/>
+    </datatype>
     <datatype>
       <name name="continuation"/>
       <desc><p>A continuation as returned by <seealso marker="#fread/3"><c>fread/3</c></seealso>.</p>
@@ -208,6 +214,23 @@
           as a string.</p>
       </desc>
     </func>
+    <func>
+      <name name="write_unicode_string" arity="1"/>
+      <fsummary>Write a Unicode string</fsummary>
+      <desc>
+        <p>Returns the list of characters needed to print
+          <c><anno>UnicodeString</anno></c> as a string.</p>
+      </desc>
+    </func>
+    <func>
+      <name name="write_unicode_string_as_latin1" arity="1"/>
+      <fsummary>Write a Unicode string</fsummary>
+      <desc>
+        <p>Returns the list of characters needed to print
+          <c><anno>UnicodeString</anno></c> as a string. Non-Latin-1
+          characters are escaped.</p>
+      </desc>
+    </func>
     <func>
       <name name="write_char" arity="1"/>
       <fsummary>Write a character</fsummary>
@@ -216,6 +239,23 @@
           constant in the ISO-latin-1 character set.</p>
       </desc>
     </func>
+    <func>
+      <name name="write_unicode_char" arity="1"/>
+      <fsummary>Write a Unicode character</fsummary>
+      <desc>
+        <p>Returns the list of characters needed to print a character
+          constant in the Unicode character set.</p>
+      </desc>
+    </func>
+    <func>
+      <name name="write_unicode_char_as_latin1" arity="1"/>
+      <fsummary>Write a Unicode character</fsummary>
+      <desc>
+        <p>Returns the list of characters needed to print a character
+          constant in the Unicode character set. Non-Latin-1 characters
+          are escaped.</p>
+      </desc>
+    </func>
     <func>
       <name name="indentation" arity="2"/>
       <fsummary>Indentation after printing string</fsummary>
@@ -232,6 +272,14 @@
           characters in the ISO-latin-1 range, otherwise it returns <c>false</c>.</p>
       </desc>
     </func>
+    <func>
+      <name name="unicode_char_list" arity="1"/>
+      <fsummary>Test for a list of Unicode characters</fsummary>
+      <desc>
+        <p>Returns <c>true</c> if <c><anno>Term</anno></c> is a flat list of
+          characters in the Unicode range, otherwise it returns <c>false</c>.</p>
+      </desc>
+    </func>
     <func>
       <name name="deep_char_list" arity="1"/>
       <fsummary>Test for a deep list of characters</fsummary>
@@ -240,6 +288,14 @@
           of characters in the ISO-latin-1 range, otherwise it returns <c>false</c>.</p>
       </desc>
     </func>
+    <func>
+      <name name="deep_unicode_char_list" arity="1"/>
+      <fsummary>Test for a deep list of Unicode characters</fsummary>
+      <desc>
+        <p>Returns <c>true</c> if <c><anno>Term</anno></c> is a, possibly deep, list
+          of characters in the Unicode range, otherwise it returns <c>false</c>.</p>
+      </desc>
+    </func>
     <func>
       <name name="printable_list" arity="1"/>
       <fsummary>Test for a list of printable ISO-latin-1 characters</fsummary>
@@ -248,6 +304,14 @@
           printable ISO-latin-1 characters, otherwise it returns <c>false</c>.</p>
       </desc>
     </func>
+    <func>
+      <name name="printable_unicode_list" arity="1"/>
+      <fsummary>Test for a list of printable Unicode characters</fsummary>
+      <desc>
+        <p>Returns <c>true</c> if <c><anno>Term</anno></c> is a flat list of
+          printable Unicode characters, otherwise it returns <c>false</c>.</p>
+      </desc>
+    </func>
   </funcs>
 </erlref>
 
-- 
cgit v1.2.3