Index: openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml,v
diff -u -r1.5 -r1.5.6.1
--- openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml	17 Jul 2006 05:38:38 -0000	1.5
+++ openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml	15 May 2009 12:42:20 -0000	1.5.6.1
@@ -686,48 +686,45 @@
 install instructions for both PostgreSQL and Oracle.</remark></para>
 </blockquote>
 
-</sect2><sect2 id="VI.I_Email_and_Messaging"><title>Email and
-Messaging</title>
+</sect2>
 
-<para>When sending an email message, just as when delivering the
-content in web page over an HTTP connection, it is necessary to be
-able to specify what character set encoding to use.
-</para>
+  <sect2 id="VI.I_Email_and_Messaging">
 
-<blockquote>
-<para><emphasis>110.10</emphasis> The email message sending API
-will allow for a character set encoding to be specified.</para>
+    <title>Email and Messaging</title>
 
-<para><emphasis>110.20</emphasis> The email accepting API will
-allow for character set to be parsed correctly (hopefully a well
-formatted message will have a MIME character set content type header) </para>
-</blockquote>
+    <para>When sending an email message, just as when delivering the
+      content in web page over an HTTP connection, it is necessary to be
+      able to specify what character set encoding to use, defaulting to UTF-8.</para>
 
-    <para>Mail is not internationalized.  The following issues
-must be addressed.</para>
+    <blockquote>
+      <para><emphasis>110.10</emphasis> The email message sending API
+        will allow for a character set encoding to be specified.</para>
+
+      <para><emphasis>110.20</emphasis> The email accepting API 
+        allows for character set to be parsed correctly (the message has a MIME 
+        character set content type header) </para>
+    </blockquote>
+
+    <para>Mail is not internationalized.  The following issues must be addressed.</para>
     <itemizedlist>
-      <listitem><para>
-        Six different functions currently call ns_sendmail.  This
-        means that there are six different end points for sending
-        mail.  This should be brought down to no more than two (one
-        for acs_mail and one for acs_mail_lite), and ideally just
-        one.  Functions that currently call ns_sendmail directly
-        should instead call acs_mail_lite.
-</para>      </listitem>
-      <listitem><para>
-        Outgoing email functions (acs_mail and acs_mail_lite) must do
-        the following: 1) Determine the appropriate language or
-        languages to use for the message subject and message body.  2)
-        Encode the subject and body appropriately and set message
-        headers, in accordance with RFC 3282
-        (http://www.ietf.org/rfc/rfc3282.txt) and other RFCs.
-</para>
+      <listitem>
+        <para>
+          Many functions still call ns_sendmail.  This
+          means that there are different end points for sending
+          mail. This should be changed to use the acs-mail-lite API instead.
+        </para>      
       </listitem>
       <listitem>
-        <para>Extreme Use case: Web site has a default language of Danish.  A forum is set up for Swedes, so the forum has a package_id and a language setting of Swedish.  A poster posts to the forum in Russian (is this possible?).  A user is subscribed to the forum and has a language preference of Chinese.  What should be in the message body and message subject?
-INCOMPLETE - The mail functions in acs_mail and acs_mail_lite
-are not internationalized.</para>
+        <para>
+          Consumers of email services must do
+          the following: Determine the appropriate language or
+          languages to use for the message subject and message body
+          and localize them (as in notifications).
+        </para>
       </listitem>
+      <listitem>
+        <para>Extreme Use case: Web site has a default language of Danish.  A forum is set up for Swedes, so the forum has a package_id and a language setting of Swedish.  A poster posts to the forum in Russian (is this possible?).  A user is subscribed to the forum and has a language preference of Chinese.  What should be in the message body and message subject?</para>
+      </listitem>
       <listitem><para>Incoming mail should be localized.</para>
       </listitem>
     </itemizedlist>