===========================================================================
  conv2nmail4    Mail converter for Nmail4   <version 0.6.1>

      Date   : 14 Sep 1999
      Author : R.Kawagishi <kawagisi@yk.rim.or.jp>
===========================================================================

INDEX
   1. Introduction
   2. Install
   3. Mail format
   4. Import mail from Unix Mailer
   5. Import mail from Windows Mailer
   6. Import mail from Macintosh Mailer
   7. Using conv2nmail4
   8. I18N --- How to fit your language
   9. Error
  10. Bugs and Todo
  11. Hisory
  12. Others

I am poor in writing in English. I welcome any changes or additions to
this document to make it better, and easier to read.

1. INTRODUCTION
  conv2nmail4 is mail converter for Nmail4.
  conv2nmail4 can now import mail from following mailers and also can 
  import probably from other mailer.

  [Linux]   Nmail 3.02
  [Linux]   Netscape Messenger
  [Windows] AL-Mail32 (Japanese famous shareware mailer)
  [Windows] MS Outlook Express (use "MailExp")
            "MailExp" is mail converter working under MS Windows Japanese
            edition.

  conv2nmail4 requires Tcl/Tk (Tcl7.4/Tk 4.2 or higher version).
  conv2nmail4 is I18N(Internationalization) application.

2. INSTALL
  The package conv2nmail4-x.x.tar.gz includes following files.
    conv2nmail4            (Tcl/Tk scripts)
    conv2nmail4-msg.en     (message catalogue in English)
    conv2nmail4-msg.ja     (message catalogue in Japanese)
    conv2nmail4_RAEDME.en  (Online Help file in English. This document.)
    conv2nmail4_RAEDME.ja  (Online Help file in Japanese)

  Untar this package as follows.
    $ su
    # mkdir /usr/local/lib/conv2nmail4
    # cd    /usr/local/lib/conv2nmail4
    # tar zxvf conv2nmail4-x.x.tar.gz

  Place the excutable file in proper directory as follows.
    # cp conv2nmail4 /usr/local/bin
  or,
    # ln -s /usr/local/lib/conv2nmail4/conv2nmail4 /usr/local/bin

  If need, change some variables of top of conv2nmail4 to fit your system.
  (1) path for "locale.alias" file
      set locale_alias_path1  /usr/lib/X11/locale
      set locale_alias_path2  /usr/local/share/locale
  (2) path for online help file (conv2nmail4-RAEDME.??)
      set help_file_path     /usr/local/lib/conv2nmail4
  (3) path for message catalog (conv2nmail4-msg.??)
      set message_file_path  /usr/local/lib/conv2nmail4

  To run the conv2nmail4, type following on xterm.
  $ conv2nmail4 &

3. Mail file format

   one mail in one file style ---
       Nmail 3.0x, Nmail4, and etc.

   mbox (multiple mails in one file) style --- 
       Unix mail command, Netscape Messenger, Microsoft Outlook, and etc.

4. Import mail from Unix Mailer

 4.1 Nmail 3.0x
     For example mail is saved in the ~/.nmail/inbox directory.
     It is "one mail in one file" style.
     conv2nmail4 can import these mail.

 4.2 Netscape Messenger
     For example mail is saved in the ~/nsmail directory.
     Each mail is separated by "From " line in the file.
     conv2nmail4 can import these mail.

 4.3 Unix mail command
     For example mail is saved in the /var/spool/mail directory.
     Each mail is separated by "From " line in the file.
     conv2nmail4 can import these mail.

 4.4 Emacs, mule (it's mail mode, mh-e, Mew)
     For example mail is saved in the ~/mbox file or ~/Mail/inbox/ directory.
     Each mail is separated by "From " line in the file.
     conv2nmail4 can import these mail.

5. Import mail from Windows Mailer

   There are many mailer for MS Windows and I don't know each mail's format.

   MS Outlook mail is very special format so conv2nmail4 cannot import this.
   But I can import Outlook mail by using "MailExp" which is mail converter
   working under MS Windows Japanese edition.
   First, I convert Outlook mail to "From " style by "MailExp" then
   conv2nmail4 can import "From " style mail.

   I think you can find nice mail converter working at MS Windows from 
   anywhere. Try it, and please tell me.

6. Import mail from Macintosh Mailer

   I am not Mac user and don't know mail format.
   Please anyone try it and tell me the result.

7. Using conv2nmail4

   (1) If Nmail4 is working, exit Nmail4.
   (2) Invoke conv2nmail4 on xterm.
       $ conv2nmail4 &
   (3) select Split or NoSplit
   (4) specify Import File (when select Split) or Import Directory (when
       select NoSplit)
   (5) select Line Code (Unix/DOS/Mac)
   (6) specify Save Directory
   (7) click Start button
   (8) When importing is completed, then invoke Nmail4.
       You can find old mail list and you can read each mail.

8. I18N --- How to fit your language

  This program is I18N(Internationalization) application.
  To fit your language folow as below. 
  (for example KOREAN, language code is "ko")

   (1) $ cp conv2nmail4-msg.en conv2nmail4-msg.ko
   (2) The format of conv2nmail4-msg.ko is
       set xxxxx "yyyyy"
       "yyyyy" is English message. Replace the string "yyyyy" to Korean.
   (3) $ cp conv2nmail4_RAEDME.en conv2nmail4_RAEDME.ko
   (4) Translate conv2nmail4_RAEDME.ko to Korean.
   (5) Check locale's Environment variable (LANG, LC_ALL, LANGUAGE)
       If need then set environment variable as follows.
       $ export LANG=ko_KR.euc
       The priority is LANG < LC_ALL < LANGUAGE

   cf. : Language Name Codes is available at:
         http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt

         ISO 3166 Codes (Countries) is available at:
         http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html

9. Error

10. Bugs and Todo

11. HISTORY
  version 0.1    02,Aug 1999  Test. Only work from Nmail3.0x
  version 0.2    05,Aug 1999  same above
  version 0.3    09,Aug 1999  available from other mailer
  version 0.4    23,Aug 1999  some bugs fixed
  version 0.5    26,Aug 1999  open to the limited user
  version 0.6    12,Sep 1999  I18N
  version 0.6.1  14,Sep 1999  some changes for message catalog

12. OTHERS

  [LICENSE] GPL2 (GNU GENERAL PUBLIC LICENSE Version 2)

  [AUTHOR]  Ryoji Kawagishi
            E-Mail   : kawagisi@yk.rim.or.jp
            Homepage : http://www.yk.rim.or.jp/~kawagisi/