home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / mh683u05.zip / README.OS2 < prev   
Text File  |  1996-09-23  |  54KB  |  1,551 lines
  1. ;;;
  2. ;;; $Id: README.OS2,v 1.5 1996/09/16 23:16:34 H.Ueno Exp $
  3. ;;;
  4. ::: Hiroshi Ueno <zodiac@ibm.net>
  5. :::
  6.  
  7. In this document, you can find the information of how you can install
  8. and configure MH under OS/2 environment.
  9.  
  10. This document is not intented for MH tutorial.  If you want the
  11. `How-To' information of MH, please consult the documents provided in
  12. the MH archive and man manuals, or try to find someone arround you who
  13. can kindly teach you what you wnat to know.
  14.  
  15.  
  16.  
  17. +---------------------------------+
  18. | 1.0 Introduction to MH for OS/2 |
  19. +---------------------------------+
  20.  
  21. MH for OS/2 is a set of patches for MH 6.8.3/6.8.4 and some other files
  22. which are used to make MH under OS/2 environment.  MH for OS/2 can be
  23. used from OS/2 command prompt or via Emacs+mh-e/Mew interface.
  24.  
  25. MH for OS/2 sends and receives the mails using TCP/IP (SMTP/POP, sendmail)
  26. or UUCP connection.  Most of the internet service providers support the 
  27. mail exchange via SMTP/POP and/or UUCP protocols.
  28.  
  29. The installation and configuration of MH for OS/2 is explained in the 
  30. following chapters of this document:
  31.  
  32. For SMTP/POP:
  33. "3.0 Installation and Configuration for SMTP/POP"
  34.  
  35. For sendmail/POP:
  36. "4.0 Installation and Configuration for sendmail/POP"
  37.  
  38. For UUCP:
  39. "5.0 Installation and Configuration for UUCP"
  40.  
  41.  
  42.  
  43. +-------------------+
  44. | 2.0 Prerequisites |
  45. +-------------------+
  46.  
  47. 1. OS/2 Version 2.1 or later.
  48.  
  49.  
  50. 2. MH 6.8.3 or MH 6.8.4 source files.
  51.  
  52.    This package only contains files required under OS/2 environment.
  53.    You need to have the MH 6.8.3 or MH 6.8.4 archive.  You can find 
  54.    the archive file at many anonymous ftp sites as `mh-6.8.3.tar.gz'
  55.    or `mh-6.8.4.tar.gz'
  56.  
  57.    If you have MH 6.8.3 sources, you do not need to update them to
  58.    MH 6.8.4 by yourself.  MH for OS/2 configuration program 
  59.    automatically updates MH 6.8.3 sources to 6.8.4 during its process.
  60.  
  61.  
  62. 3. You need the following programs to unpack an MH 6.8.3 archive:
  63.  
  64.       GNU gzip
  65.       GNU tar
  66.  
  67.    Also you need the following utilities to build and install MH for OS/2:
  68.  
  69.       Info-Zip UnZip 5.x
  70.       emx/gcc 0.9a or later (*1, *2)
  71.       GNU patch  (*3)
  72.       GNU make
  73.       GNU sed
  74.       GNU file utilities (gnufutil.zip)
  75.  
  76.    *1) If you use emx0.9a, make sure to apply fix06 before you start
  77.        making MH modules.  Some modules made with emx0.9a without fixes
  78.        may dump at the execution time.
  79.  
  80.    *2) You need to install bsddev.zip to make MH for OS/2.
  81.  
  82.    *3) I recommend you to rename GNU patch program to gpatch.exe.  It avoids
  83.        the conflict between OS/2's patch.exe.  Also configure.cmd expects
  84.        gpatch.exe as a GNU patch program by default.
  85.  
  86.    If you want to view man manuals, the following tools are required:
  87.  
  88.       GNU man
  89.       GNU grof
  90.       GNU text utiliies (gnututil.zip)
  91.       less
  92.  
  93.    You can find all these tools at ftp://hobbes.nmsu.edu or at its mirror
  94.    sites.  You can get those from Hobbes CD-ROM too.
  95.  
  96.    The following is a list of tools I used to make and test MH for
  97.    OS/2: 
  98.  
  99.  
  100.        Info-Zip UnZip 5.12
  101.        GNU gzip 1.2.4 (32bit)
  102.        GNU tar 1.10
  103.        GNU patch 2.1
  104.        GNU make 3.74
  105.        GNU sed 2.05
  106.        GNU file utilities 3.12
  107.  
  108.        emx/gcc 0.9a fix06
  109.        emx/gcc 0.9a fix06 + gcc 2.7.0
  110.        emx/gcc 0.9b fix05
  111.        emx/gcc 0.9c
  112.  
  113.        GNU man 1.0
  114.        GNU groff 1.09
  115.        GNU text utilities 1.12
  116.        less 2.91
  117.  
  118.        GNU Emacs 19.29.2/19.30.1/19.31/19.33
  119.        Mule 1.1m/2.3
  120.        mh-e 4.1/5.0
  121.  
  122.        UUPC/Extended 1.12k/1.12r
  123.  
  124.  
  125. 4. HPFS formatted disk with at least 20MB of free spaces in order to
  126.    make MH for OS/2.  Additional 6MB is required to install it.
  127.  
  128.  
  129. 5. One of the following software should have been installed and working:
  130.  
  131.    a) When you use MH over TCP/IP (sendmail/SMTP/POP) connection:
  132.  
  133.         - TCP/IP for OS/2 Version 2
  134.         - TCP/IP for OS/2 Version 3 included in Warp Connect
  135.         - Internet Access Kit (IAK)
  136.    
  137.       The LAN or the dial up connection (SLIP or PPP) can be used.
  138.  
  139.  
  140.    b) When you use MH over UUCP connection:
  141.  
  142.         - UUPC/Extended 1.12k or later
  143.  
  144.       UUPC/Extended can be found at 
  145.  
  146.            ftp://ftp.leo.org/pub/comp/os/os2/mail+news/
  147.  
  148.       or other ftp sites.
  149.  
  150.       Note: UUPC/Extented 1.12b, which can be found at hobbes, does
  151.             not work with MH for OS/2.
  152.    
  153.  
  154. 4. If you are using OS/2 2.x, REXX feature needs to be installed.
  155.  
  156.  
  157.  
  158. +-------------------------------------------------+
  159. | 3.0 Installation and Configuration for SMTP/POP |
  160. +-------------------------------------------------+
  161.  
  162. With this configuration, you can send mails via SMTP server and receive
  163. mails from POP host.
  164.  
  165. 3.1 Making MH
  166. -------------
  167.  
  168. 0. Install all requires utilities for making MH.  See
  169.    `Prerequisites' above.
  170.  
  171.  
  172. 1. Unpack MH 6.8.3 or 6.8.4 archive using GNU tar:
  173.  
  174.       tar zxvf mh-6.8.{3|4}.tar.gz
  175.  
  176.    This will create mh-6.8.3/ or mh-6.8.4/ directory and MH source
  177.    files will be places under that directory. mh-6.8.3/ is referred
  178.    as MH top directory hereafter.
  179.  
  180.  
  181. 2. Place an mhos2.zip file under the MH top directory.
  182.  
  183.  
  184. 3. Change the current directory to the MH top directory then unpack
  185.    an mhos2.zip file:
  186.  
  187.       cd mh-6.8.3
  188.       unzip mhos2.zip
  189.  
  190.  
  191. 4. Edit a `mh-6.8.3\conf\os2\os2.tcpip' file to suit your environment.
  192.    You can modify the following lines:
  193.  
  194.       bin        A directory which MH executables files will be copied to.
  195.       etc        A directory which MH library files will be copied to.
  196.  
  197.    If your POP server allows RPOP and you want to use it, add the
  198.    following statement.
  199.  
  200.       options RPOP
  201.  
  202.    If you want the man manuals for MH, please change the `manuals'
  203.    statement as below:
  204.  
  205.       manuals standard
  206.  
  207.    Then change the `mandir' statement so that it points to the
  208.    directory to which you want to install the man manuals.
  209.  
  210.    When you use emx/gcc 0.9c to compile and link MH for OS/2, you can
  211.    add -Zcrtdll to ldoptions line to reduce the size of MH executables.
  212.  
  213.  
  214. 5. Issue the following command from the MH top directory:
  215.  
  216.       configure tcpip
  217.  
  218.    A `configure.cmd' will;
  219.  
  220.       - delete *.orig and *.rej files.
  221.       - apply the patches to update to MH 6.8.4 if the souces are
  222.         MH 6.8.3.
  223.       - apply OS/2 patches to the MH source files
  224.       - create a backup of `mhos2.pat' as `mhos2.pa_' then delete
  225.         `mhos2.pat' 
  226.       - delete *.orig files created during applying patches
  227.       - make `mhconfig.exe'
  228.       - run `mhconfig.exe' to create configuration files and Makefiles
  229.       - issue `make clean' to clean up the grabage
  230.       - display messages if applying patches failed or mhconfig ended
  231.         with an error.
  232.  
  233.    When some of the patches failed to be applied, please apply those
  234.    patches manually. 
  235.  
  236.  
  237. 6. Now you are ready to build MH for OS/2.  Just issue `make' at the
  238.    MH top directory.
  239.  
  240.       make
  241.  
  242.    All MH executable and library files will be created.  The man
  243.    manuals will also be created if you specified in the configuration
  244.    file. 
  245.  
  246.  
  247.  
  248. 3.2 Install
  249. -----------
  250.  
  251. 1. Issue the following command at the MH top directory.  This will
  252.    install all files except the MH man manuals.
  253.  
  254.       make inst-all
  255.  
  256.    To install the MH man manuals,
  257.  
  258.       cd doc
  259.       make inst-all
  260.  
  261.  
  262.  
  263. 3.3 Configuration
  264. -----------------
  265.  
  266. 1. Edit a `services' file of TCP/IP product to specify a port number
  267.    for pop3 protocol.  It can be found under TCPIP\ETC or MPTN\ETC
  268.    directory.  Add a following statement to the file: 
  269.  
  270.       pop3            110/tcp
  271.  
  272.  
  273. 2. Edit a file named `mtstailor' which has been installed in the MH
  274.    library file directory. The MH library file directory is a
  275.    directory which is specified by `etc' statement in a
  276.    `conf\os2\os2.tcpip' file or a directory pointed to by MHETCPATH
  277.    environment variable mentioned below.
  278.  
  279.    You need the following statements in an `mtstailor' file:
  280.  
  281.  
  282.       pophost:        The host name of a default POP host.
  283.  
  284.       servers:        A list of the names of the SMTP servers. You can
  285.                       specify more than one SMTP servers by separating
  286.                       them by one or more blanks between them.
  287.  
  288.       localname:      The name of your POP service host  which will follow
  289.                       your user id and `@' in the `From' field of your
  290.                       sending mail.
  291.  
  292.  
  293.    Example 1:  My POP host is `pophost.provider.com', SMTP server is
  294.                `smtp.provider.com', and pop service host name is
  295.                `provider.net'. 
  296.  
  297.                       pophost:   pophost.provider.com
  298.                       servers:   smtp.provider.com
  299.                       localname: provider.net
  300.  
  301.    Example 2:  My POP host is `pophost.provider.com', SMTP server is
  302.                `smtp.provider.com'.  I have a secondary smpt server at
  303.                `smtp2.network.com'. A pop service host name is
  304.                `provider.net'. 
  305.  
  306.                       pophost:   pophost.provider.com
  307.                       servers:   smtp.provider.com smtp2.network.com
  308.                       localname: provider.net
  309.  
  310.    ** Important Note **
  311.  
  312.    Each line in a `mtstailor' file must end with CR(+LF).  Some
  313.    editors does not automatically insert CR(+LF) character at the end
  314.    of the last line so you need to intentionally insert it.  If there
  315.    is no CR(+LF) at the end in the above examples, you may experience
  316.    a bad `From:' mail header because the `localname:' statement,
  317.    the last line in a file without CR(+LF), is ignored.
  318.  
  319.  
  320. 3. Add the statements to your `CONFIG.SYS' to set the environmet
  321.    variables. MH for OS/2 uses the following envionment varaibles:
  322.  
  323.  
  324.       HOME            (Mundatory)
  325.                       Your home directory where `.mh_profile',
  326.                       `.netrc' etc. are placed.
  327.  
  328.                         example: SET HOME=D:\MY-HOME
  329.  
  330.  
  331.       USER            (Mundatory)
  332.                       Your user ID recognized by the SMTP/POP hosts.
  333.  
  334.  
  335.       TZ              (Optional)
  336.                       Your timezone.  You have to set this right to make the
  337.                       `Date:' field of your sending mail correct. 
  338.  
  339.                       See "6.0 TZ environment variable" for the format 
  340.                       of TZ environment variable.
  341.  
  342.  
  343.       MHBINPATH       (Optional)
  344.                       You need this environment variable only when
  345.                       the directory for the MH executable files is
  346.                       different from the directory specified by `bin'
  347.                       statement in a `conf\os2\os2.tcpip' file.
  348.  
  349.                       Set the full path of the directory where the MH
  350.                       executable files are placed.
  351.  
  352.                         example: SET MHBINPATH=D:\MH\MH-PROGS
  353.  
  354.  
  355.       MHETCPATH       (Optional)
  356.                       You need this environment variable only when
  357.                       the directory for the MH library files is
  358.                       different from the directory specified by `etc'
  359.                       statement in a `conf\os2\os2.tcpip' file.
  360.  
  361.                       Set the full path of the directory where the MH
  362.                       library files are placed.
  363.  
  364.                         example: SET MHETCPATH=D:\MH\MH-LIB
  365.  
  366.  
  367.       TMP             (Optional)
  368.                       Directory where MH places its temporary files.  If TMP
  369.                       environmet is not specified, the temporary files will
  370.                       be created under the current directory.
  371.  
  372.  
  373.       NOMHNPROC       (Optional)
  374.                       Now ``mhn'' command is available and it will be called
  375.                       by show/next/prev commands by default for the MIME mails.
  376.                       If you do not want to use ``mhn'' to show the mails or
  377.                       if you want show/next/prev commands act as the previous
  378.                       release of MH for OS/2, just set this envariable to
  379.                       completely disable ``mhn'' command.
  380.                       
  381.                         example: SET NOMHNPROC=1
  382.  
  383.  
  384. 4. Reboot the system to make the updated `CONFIG.SYS' effective.
  385.  
  386.  
  387. 5. Run `install-mh' program which has been installed under the MH
  388.    library file directory.  It prompts you the candidates of the mail 
  389.    directory where your mail will be saved.  After you answered `N' to
  390.    all the candidates, you can type in the whole path of your mail
  391.    directory. 
  392.  
  393.    An `install-mh' program creates a `.mh_profile' under your home 
  394.    directory if one does not exist.  It refuses to run when a
  395.    `.mh_profile' already exists so you have to edit a profile
  396.    manually. 
  397.  
  398.    When you issue a MH command, e.g. inc, without a `.mh_profile' in
  399.    your home directory, an install-mh command is called and it creates
  400.    a profile automatically.  In this case, your mail directory is set
  401.    to $HOME/Mail (Mail directory under your home drectory).
  402.  
  403.  
  404. 6. If your user ID for the POP host is not same as the one for the
  405.    SMTP server, try the following configuration.
  406.  
  407.    1) Set the user ID for SMTP server to USER environment variable.
  408.  
  409.    2) Add the statements like below to an .mh_profile (where xxxx is
  410.       your user ID for the POP host).
  411.  
  412.         inc:     -user xxxx
  413.         msgchk:  -user xxxx
  414.  
  415.  
  416.  
  417. 3.4 Verifying Setup
  418. -------------------
  419.  
  420. 1. Make sure you can access the POP server using ping or by some
  421.    means. 
  422.  
  423.  
  424. 2. Run msgchk command.  Type your pop3 password whem it prompts you to
  425.    enter the password.  If MH was built with RPOP capability or if you
  426.    have a .netrc file in your home directory, msgchk command will not
  427.    ask for your password.
  428.  
  429.  
  430. 3. You will see a message like below if you can successfully
  431.    communicate with the POP host.  The message can be of one of two
  432.    types depending on the existence of the waiting mails.
  433.  
  434.  
  435.     You don't have any mail waiting on pop.inter.net (No mail waiting)
  436.  
  437.     You have 5 messages (28818 bytes) on pop.inter.net (Mail waiting)
  438.  
  439.  
  440.    If msgchk command ends with one of a messsages listed below, you
  441.    have not properly set up the MH.  Take a proper action then try 
  442.    again.
  443.  
  444.  
  445.      Message:     You don't have any mail waiting
  446.  
  447.      Cause:       mtstailor does not exist.
  448.                   mtstailor is in the wrong directory.
  449.                   mtstailor does not have a valid `pophost:' statement
  450.  
  451.      Action:      Place a mtstailor file under the correct directory,
  452.                   which the etc statement of the configuration file or
  453.                   MHETCPATH environment variable points to.
  454.                   See `Configuration' section above for the mtstailor
  455.                   file format.
  456.  
  457.  
  458.      Message:     msgchk: no servers available
  459.  
  460.      Cause:       Could not access a pop host.
  461.                   A mtstailor file does not have a valid pophost:
  462.                   statement.
  463.  
  464.      Action:      Check the accessibility to the pop host.
  465.                   Add a valid pophost: statement to a mtstailor file.
  466.  
  467.  
  468.      Message:     msgchk: tcp/pop3: unknown service
  469.  
  470.      Cause:       No pop3 definition in a `services' file.
  471.  
  472.      Action:      Add a required statement to a TCPIP\ETC\SERVICES or
  473.                   a MPTS\ETC\SERVICES file. See `Configuration'
  474.                   section above.
  475.  
  476.  
  477. 4. Send some mails to yourself to check the validity of the headers of
  478.    your mails.  The insufficient or incorrect setup will lead to the
  479.    invalid headers, e.g. invalid `From:' or incorrect `Date:'.  Check
  480.    your setting of TZ environmet variable and the contents of the
  481.    mtstailor file to correct the error. See "6.0 TZ environment
  482.    variable" for the correct TZ setting.
  483.  
  484.    Check the following items if you failed to send mails to yourself:
  485.  
  486.       - Does your `mtstailor' file have a proper servers: statement
  487.         and it specifies a correct SMTP server name or address?
  488.  
  489.       - Is SMTP server accessible now?  Use `ping' or other tools to
  490.         confirm. 
  491.  
  492.       - Have you set USER environment variable correctly?
  493.  
  494.  
  495. 3.5 POP3 password
  496. -----------------
  497.  
  498. When you use POP3 protocol, you need to give your password to the POP
  499. host.  `Inc' and `msgchk' commands will prompt you to enter your
  500. password everytime it is invoked.  But that is not good for the Mew or
  501. mh-e users as there is no way to enter your password via Mew or mh-e
  502. interface.
  503.  
  504. If you want MH programs not to prompt for your password, you can save
  505. your password in `.netrc' file under your HOME directory.  A `.netrc'
  506. file need to have a line shown like below:
  507.  
  508.     machine POP-HOST-NAME passwd YOUR-PASSWORD
  509.  
  510. Example: If your POP host is pophost.inter.net and your password is
  511.          mypass.
  512.  
  513.            machine pophost.inter.net passwd mypass
  514.  
  515. WARNING:
  516.  
  517.   IF YOU SAVE YOUR PASSWORD IN A PLAIN TEXT FILE, IT IS POSSIBLE THAT
  518.   YOUR PASSWORD WILL BE EXPOSED TO SOMEONE ELSE.  IT IS YOUR
  519.   RESPONSIBILITY TO KEEP YOUR PASSWORD FROM OTHERS.  ESPECIALLY, YOU
  520.   MUST NOT PLACE IT TO THE NETWORK DRIVE OR ANY OTHER SHARED
  521.   RESOURCES. 
  522.  
  523.  
  524.  
  525. 3.6 Consideration for RPOP
  526. --------------------------
  527.  
  528. 1. You can build MH for OS/2 with RPOP capability (See `Making MH'
  529.    chapter).  However, most of the internet service providers do not
  530.    support RPOP.  You can simply disable RPOP feature of MH and let it
  531.    use the standard POP3 by adding the following statements to your
  532.    `.mh_profile' without re-building MH.
  533.  
  534.       inc:      -norpop
  535.       msgchk:   -norpop
  536.  
  537.  
  538.  
  539. +-----------------------------------------------------+
  540. | 4.0 Installation and Configuration for sendmail/POP |
  541. +-----------------------------------------------------+
  542.  
  543. With this configuration, you can send mails using OS/2 sendmail and 
  544. receive mails from POP host.
  545.  
  546. 4.1 Making MH
  547. -------------
  548.  
  549. 0. Install all requires utilities for making MH.  See
  550.    `Prerequisites' above.
  551.  
  552.  
  553. 1. Unpack MH 6.8.3 or 6.8.4 archive using GNU tar:
  554.  
  555.       tar zxvf mh-6.8.{3|4}.tar.gz
  556.  
  557.    This will create mh-6.8.3/ or mh-6.8.4/ directory and MH source
  558.    files will be places under that directory. mh-6.8.3/ is referred
  559.    as MH top directory hereafter.
  560.  
  561.  
  562. 2. Place an mhos2.zip file under the MH top directory.
  563.  
  564.  
  565. 3. Change the current directory to the MH top directory then unpack
  566.    an mhos2.zip file:
  567.  
  568.       cd mh-6.8.3
  569.       unzip mhos2.zip
  570.  
  571.  
  572. 4. Edit a `mh-6.8.3\conf\os2\os2.sendmail' file to suit your 
  573.    environment. You can modify the following lines:
  574.  
  575.       bin        A directory which MH executables files will be copied to.
  576.       etc        A directory which MH library files will be copied to.
  577.  
  578.    If your POP server allows RPOP and you want to use it, add the
  579.    following statement.
  580.  
  581.       options RPOP
  582.  
  583.    If you want the man manuals for MH, please change the `manuals'
  584.    statement as below:
  585.  
  586.       manuals standard
  587.  
  588.    Then change the `mandir' statement so that it points to the
  589.    directory to which you want to install the man manuals.
  590.  
  591.    When you use emx/gcc 0.9c to compile and link MH for OS/2, you can
  592.    add -Zcrtdll to ldoptions line to reduce the size of MH executables.
  593.  
  594.  
  595. 5. Issue the following command from the MH top directory:
  596.  
  597.       configure sendmail
  598.  
  599.    A `configure.cmd' will;
  600.  
  601.       - delete *.orig and *.rej files.
  602.       - apply the patches to update to MH 6.8.4 if the souces are
  603.         MH 6.8.3.
  604.       - apply OS/2 patches to the MH source files
  605.       - create a backup of `mhos2.pat' as `mhos2.pa_' then delete
  606.         `mhos2.pat' 
  607.       - delete *.orig files created during applying patches
  608.       - make `mhconfig.exe'
  609.       - run `mhconfig.exe' to create configuration files and Makefiles
  610.       - issue `make clean' to clean up the grabage
  611.       - display messages if applying patches failed or mhconfig ended
  612.         with an error.
  613.  
  614.    When some of the patches failed to be applied, please apply those
  615.    patches manually. 
  616.  
  617.  
  618. 6. Now you are ready to build MH for OS/2.  Just issue `make' at the
  619.    MH top directory.
  620.  
  621.       make
  622.  
  623.    All MH executable and library files will be created.  The man
  624.    manuals will also be created if you specified in the configuration
  625.    file. 
  626.  
  627.  
  628.  
  629. 4.2 Install
  630. -----------
  631.  
  632. 1. Issue the following command at the MH top directory.  This will
  633.    install all files except the MH man manuals.
  634.  
  635.       make inst-all
  636.  
  637.    To install the MH man manuals,
  638.  
  639.       cd doc
  640.       make inst-all
  641.  
  642.  
  643.  
  644. 4.3 Configuration
  645. -----------------
  646.  
  647. 1. Edit a `services' file of TCP/IP product to specify a port number
  648.    for pop3 protocol.  It can be found under TCPIP\ETC or MPTN\ETC
  649.    directory.  Add a following statement to the file: 
  650.  
  651.       pop3            110/tcp
  652.  
  653.  
  654. 2. MH for OS/2 forces OS/2 sendmail to use %ETC%\SENDMAIL.UML as its 
  655.    configuration file.  If you do not have it, you should create
  656.    it or copy SENDMAIL.CF to SENDMAIL.UML and edit it.  Please refer 
  657.    the TCP/IP manuals or other books to know how to setup your 
  658.    SENDMAIL.UML file.
  659.  
  660.    ** IMPORTANT NOTE **
  661.    Never use the editor like tedit.exe which replaces TAB characters
  662.    with spaces.  If TAB's are replaced with spaces, sendmail will trap
  663.    at execution time.
  664.  
  665.  
  666. 3. Edit a file named `mtstailor' which has been installed in the MH
  667.    library file directory. The MH library file directory is a
  668.    directory which is specified by `etc' statement in a
  669.    `conf\os2\os2.sendmail' file or a directory pointed to by MHETCPATH
  670.    environment variable mentioned below.
  671.  
  672.    MH for OS/2 retrieves the information which is set by IBM dialer. 
  673.    If you have set the required information in the IBM dialer, you can 
  674.    omit the optional portion of the `mtstailor'.  If you use the other 
  675.    dialer or you use the LAN connection, you should set all information
  676.    in the `mtstailor'.  The setting in the `mtstailor' overrides the 
  677.    setting in the IBM dialer.
  678.  
  679.    You need the following statements in an `mtstailor' file:
  680.  
  681.  
  682.       pophost:        The host name of a default POP host.
  683.  
  684.       servers:        (Optional) The host name or IP addess of the mail
  685.                       gateway which sendmail.exe talks to.  This 
  686.                       overrides the ``Mail Gateway'' setting of the 
  687.                       dialer.
  688.  
  689.       localname:      (Optional) The name of your POP service host 
  690.                       which will follow your user id and `@' in the 
  691.                       `From' field of your sending mail.  This 
  692.                       overrides the ``Reply Domain'' setting of the 
  693.                       dialer.
  694.  
  695.  
  696.    Example:    My POP host is `pophost.provider.com', mail gateway is
  697.                `smtp.provider.com', and pop service host name is
  698.                `provider.net'. 
  699.  
  700.                       pophost:   pophost.provider.com
  701.                       servers:   smtp.provider.com
  702.                       localname: provider.net
  703.  
  704.    ** Important Note **
  705.  
  706.    Each line in a `mtstailor' file must end with CR(+LF).  Some
  707.    editors does not automatically insert CR(+LF) character at the end
  708.    of the last line so you need to intentionally insert it.  If there
  709.    is no CR(+LF) at the end in the above examples, you may experience
  710.    a bad `From:' mail header because the `localname:' statement,
  711.    the last line in a file without CR(+LF), is ignored.
  712.  
  713.  
  714. 4. Add the statements to your `CONFIG.SYS' to set the environmet
  715.    variables. MH for OS/2 uses the following envionment varaibles:
  716.  
  717.  
  718.       HOME            (Mundatory)
  719.                       Your home directory where `.mh_profile',
  720.                       `.netrc' etc. are placed.
  721.  
  722.                         example: SET HOME=D:\MY-HOME
  723.  
  724.  
  725.       USER            (Mundatory)
  726.                       Your user ID recognized by the SMTP/POP hosts.
  727.  
  728.  
  729.       TZ              (Optional)
  730.                       Your timezone.  You have to set this right to make the
  731.                       `Date:' field of your sending mail correct. 
  732.  
  733.                       See "6.0 TZ environment variable" for the format 
  734.                       of TZ environment variable.
  735.  
  736.  
  737.       MHBINPATH       (Optional)
  738.                       You need this environment variable only when
  739.                       the directory for the MH executable files is
  740.                       different from the directory specified by `bin'
  741.                       statement in a `conf\os2\os2.sendmail' file.
  742.  
  743.                       Set the full path of the directory where the MH
  744.                       executable files are placed.
  745.  
  746.                         example: SET MHBINPATH=D:\MH\MH-PROGS
  747.  
  748.  
  749.       MHETCPATH       (Optional)
  750.                       You need this environment variable only when
  751.                       the directory for the MH library files is
  752.                       different from the directory specified by `etc'
  753.                       statement in a `conf\os2\os2.sendmail' file.
  754.  
  755.                       Set the full path of the directory where the MH
  756.                       library files are placed.
  757.  
  758.                         example: SET MHETCPATH=D:\MH\MH-LIB
  759.  
  760.  
  761.       TMP             (Optional)
  762.                       Directory where MH places its temporary files.  If TMP
  763.                       environmet is not specified, the temporary files will
  764.                       be created under the current directory.
  765.  
  766.  
  767.       NOMHNPROC       (Optional)
  768.                       Now ``mhn'' command is available and it will be called
  769.                       by show/next/prev commands by default for the MIME mails.
  770.                       If you do not want to use ``mhn'' to show the mails or
  771.                       if you want show/next/prev commands act as the previous
  772.                       release of MH for OS/2, just set this envariable to
  773.                       completely disable ``mhn'' command.
  774.                       
  775.                         example: SET NOMHNPROC=1
  776.  
  777.  
  778. 5. Reboot the system to make the updated `CONFIG.SYS' effective.
  779.  
  780.  
  781. 6. Run `install-mh' program which has been installed under the MH
  782.    library file directory.  It prompts you the candidates of the mail 
  783.    directory where your mail will be saved.  After you answered `N' to
  784.    all the candidates, you can type in the whole path of your mail
  785.    directory. 
  786.  
  787.    An `install-mh' program creates a `.mh_profile' under your home 
  788.    directory if one does not exist.  It refuses to run when a
  789.    `.mh_profile' already exists so you have to edit a profile
  790.    manually. 
  791.  
  792.    When you issue a MH command, e.g. inc, without a `.mh_profile' in
  793.    your home directory, an install-mh command is called and it creates
  794.    a profile automatically.  In this case, your mail directory is set
  795.    to $HOME/Mail (Mail directory under your home drectory).
  796.  
  797.  
  798.  
  799. 4.4 Verifying Setup
  800. -------------------
  801.  
  802. 1. Make sure you can access the POP server using ping or by some
  803.    means. 
  804.  
  805.  
  806. 2. Run msgchk command.  Type your pop3 password whem it prompts you to
  807.    enter the password.  If MH was built with RPOP capability or if you
  808.    have a .netrc file in your home directory, msgchk command will not
  809.    ask for your password.
  810.  
  811.  
  812. 3. You will see a message like below if you can successfully
  813.    communicate with the POP host.  The message can be of one of two
  814.    types depending on the existence of the waiting mails.
  815.  
  816.  
  817.     You don't have any mail waiting on pop.inter.net (No mail waiting)
  818.  
  819.     You have 5 messages (28818 bytes) on pop.inter.net (Mail waiting)
  820.  
  821.  
  822.    If msgchk command ends with one of a messsages listed below, you
  823.    have not properly set up the MH.  Take a proper action then try 
  824.    again.
  825.  
  826.  
  827.      Message:     You don't have any mail waiting
  828.  
  829.      Cause:       mtstailor does not exist.
  830.                   mtstailor is in the wrong directory.
  831.                   mtstailor does not have a valid `pophost:' statement
  832.  
  833.      Action:      Place a mtstailor file under the correct directory,
  834.                   which the etc statement of the configuration file or
  835.                   MHETCPATH environment variable points to.
  836.                   See `Configuration' section above for the mtstailor
  837.                   file format.
  838.  
  839.  
  840.      Message:     msgchk: no servers available
  841.  
  842.      Cause:       Could not access a pop host.
  843.                   A mtstailor file does not have a valid pophost:
  844.                   statement.
  845.  
  846.      Action:      Check the accessibility to the pop host.
  847.                   Add a valid pophost: statement to a mtstailor file.
  848.  
  849.  
  850.      Message:     msgchk: tcp/pop3: unknown service
  851.  
  852.      Cause:       No pop3 definition in a `services' file.
  853.  
  854.      Action:      Add a required statement to a TCPIP\ETC\SERVICES or
  855.                   a MPTS\ETC\SERVICES file. See `Configuration'
  856.                   section above.
  857.  
  858.  
  859. 4. Send some mails to yourself to check the validity of the headers of
  860.    your mails.  The insufficient or incorrect setup will lead to the
  861.    invalid headers, e.g. invalid `From:' or incorrect `Date:'.  Check
  862.    your setting of TZ environmet variable and the contents of the
  863.    mtstailor file to correct the error. See "6.0 TZ environment 
  864.    variable" for the correct TZ setting.
  865.  
  866.    Check the following items if you failed to send mails to yourself:
  867.  
  868.       - Does your `mtstailor' file have a proper servers: statement
  869.         and it specifies a correct mail gateway name or address?
  870.  
  871.       - Is mail gateway accessible now?  Use `ping' or other tools to
  872.         confirm. 
  873.  
  874.       - Is SENDMAIL.UML correct?
  875.  
  876.  
  877. 5. If you try to send a mail when your PC is off-line, it will be 
  878.    queued in %ETC%\MQUEUE directory.  You can send that mail by 
  879.    invoking MAILQ.EXE when your PC is on-line.  IBM dialer 
  880.    automatically calls MAILQ.EXE when the SLIP/PPP session is 
  881.    established and the queued mails are sent at this point.
  882.  
  883.    If you use the other dialer, you have to invoke MAILQ.EXE by 
  884.    yourself or, if possible, setup the dialer's auto-start program.
  885.  
  886.  
  887.  
  888. 4.5 POP3 password
  889. -----------------
  890.  
  891. When you use POP3 protocol, you need to give your password to the POP
  892. host.  `Inc' and `msgchk' commands will prompt you to enter your
  893. password everytime it is invoked.  But that is not good for the Mew or
  894. mh-e users as there is no way to enter your password via Mew or mh-e
  895. interface.
  896.  
  897. If you want MH programs not to prompt for your password, you can save
  898. your password in `.netrc' file under your HOME directory.  A `.netrc'
  899. file need to have a line shown like below:
  900.  
  901.     machine POP-HOST-NAME passwd YOUR-PASSWORD
  902.  
  903. Example: If your POP host is pophost.inter.net and your password is
  904.          mypass.
  905.  
  906.            machine pophost.inter.net passwd mypass
  907.  
  908. WARNING:
  909.  
  910.   IF YOU SAVE YOUR PASSWORD IN A PLAIN TEXT FILE, IT IS POSSIBLE THAT
  911.   YOUR PASSWORD WILL BE EXPOSED TO SOMEONE ELSE.  IT IS YOUR
  912.   RESPONSIBILITY TO KEEP YOUR PASSWORD FROM OTHERS.  ESPECIALLY, YOU
  913.   MUST NOT PLACE IT TO THE NETWORK DRIVE OR ANY OTHER SHARED
  914.   RESOURCES. 
  915.  
  916.  
  917.  
  918. 4.6 Consideration for RPOP
  919. --------------------------
  920.  
  921. 1. You can build MH for OS/2 with RPOP capability (See `Making MH'
  922.    chapter).  However, most of the internet service providers do not
  923.    support RPOP.  You can simply disable RPOP feature of MH and let it
  924.    use the standard POP3 by adding the following statements to your
  925.    `.mh_profile' without re-building MH.
  926.  
  927.       inc:      -norpop
  928.       msgchk:   -norpop
  929.  
  930.  
  931.  
  932. +---------------------------------------------+
  933. | 5.0 Installation and Configuration for UUCP |
  934. +---------------------------------------------+
  935.  
  936. With this configuration, you can exchange mails using UUCP/Extended.
  937.  
  938. 5.1 Making MH
  939. -------------
  940.  
  941. 0. Install all requires utilities for making MH.  See
  942.    `Prerequisites' above.
  943.  
  944.  
  945. 1. Unpack MH 6.8.3 or 6.8.4 archive using GNU tar:
  946.  
  947.       tar zxvf mh-6.8.{3|4}.tar.gz
  948.  
  949.    This will create mh-6.8.3/ or mh-6.8.4/ directory and MH source
  950.    files will be places under that directory. mh-6.8.3/ is referred
  951.    as MH top directory hereafter.
  952.  
  953.  
  954. 2. Place an mhos2.zip file under the MH top directory.
  955.  
  956.  
  957. 3. Change the current directory to the MH top directory then unpack
  958.    an mhos2.zip file:
  959.  
  960.       cd mh-6.8.3
  961.       unzip mhos2.zip
  962.  
  963.  
  964. 4. Edit a `mh-6.8.3\conf\os2\os2.uucp' file to suit your environment.
  965.    You can modify the following lines:
  966.  
  967.       bin        A directory which MH executables files will be copied to.
  968.       etc        A directory which MH library files will be copied to.
  969.  
  970.    If you want the man manuals for MH, please change the `manuals'
  971.    statement as below:
  972.  
  973.       manuals standard
  974.  
  975.    Then change the `mandir' statement so that it points to the
  976.    directory to which you want to install the man manuals.
  977.  
  978.    When you use emx/gcc 0.9c to compile and link MH for OS/2, you can
  979.    add -Zcrtdll to ldoptions line to reduce the size of MH executables.
  980.  
  981.  
  982. 5. Issue the following command from the MH top directory:
  983.  
  984.       configure uucp
  985.  
  986.    A `configure.cmd' will;
  987.  
  988.       - delete *.orig and *.rej files.
  989.       - apply the patches to update to MH 6.8.4 if the souces are
  990.         MH 6.8.3.
  991.       - apply OS/2 patches to the MH source files
  992.       - create a bakcup of `mhos2.pat' as `mhos2.pa_' then delete
  993.         `mhos2.pat' 
  994.       - delete *.orig files created during applying patches
  995.       - make `mhconfig.exe'
  996.       - run `mhconfig.exe' to create configuration files and Makefiles
  997.       - issue `make clean' to clean up the grabage
  998.       - display messages if applying patches failed or mhconfig ended
  999.         with an error.
  1000.  
  1001.    When some of the patches failed to be applied, please apply those
  1002.    patches manually. 
  1003.  
  1004.  
  1005. 6. Now you are ready to build MH for OS/2.  Just issue `make' at the
  1006.    MH top directory.
  1007.  
  1008.       make
  1009.  
  1010.    All MH executable and library files will be created.  The man
  1011.    manuals will also be created if you specified in the configuration
  1012.    file. 
  1013.  
  1014.  
  1015.  
  1016. 5.2 Install
  1017. -----------
  1018.  
  1019. 1. Issue the following command at the MH top directory.  This will
  1020.    install all files except the MH man manuals.
  1021.  
  1022.       make inst-all
  1023.  
  1024.    To install the MH man manuals,
  1025.  
  1026.       cd doc
  1027.       make inst-all
  1028.  
  1029.  
  1030.  
  1031. 5.3 Configuration
  1032. -----------------
  1033.  
  1034. 1. Edit a file named `mtstailor' which has been installed in the MH
  1035.    library file directory. The MH library file directory is a
  1036.    directory which is specified by `etc' statement in a
  1037.    `conf\os2\os2.uucp' file or a directory pointed to by MHETCPATH
  1038.    environment variable mentioned below.
  1039.  
  1040.    You do not need to have a `mtstailor' if you have properly
  1041.    configured the UUPC/Extended.  MH gets the necessary information
  1042.    from the $UPCSYSRC and $UUPCUSRRC.  The values in the mtstailor
  1043.    override what are defined in the UUPC/Exteded configuration files.
  1044.  
  1045.    You need the following statements in an `mtstailor' file:
  1046.  
  1047.  
  1048.       systemname:     (Optional) The name of the local host in the
  1049.                       UUCP domain.  If omitted, the value from the
  1050.                       `Domain='  statement in $UUPCSYSRC is used.
  1051.  
  1052.       uucpldir:       (Optional) The name of the directory where UUCP
  1053.                       maildrops are kept.  If omitted, the directory
  1054.                       is determined in the following order:
  1055.  
  1056.                       1) A directory specified by `MailDir=' directive
  1057.                          in $UUPCSYSRC.
  1058.                       2) "Mail" directory under the directory specified
  1059.                          by `ConfDir=' directive in $UUPCSYSRC.
  1060.                       3) "Mail" directory under the directory where 
  1061.                          $UUPCSYSRC is in.
  1062.  
  1063.                       (Example) uucpldir: d:/uupc/mail
  1064.  
  1065.       uucplfil:       (Optional) The name of the maildrop file in the
  1066.                       directory where UUCP maildrops are kept.  If
  1067.                       omitted, a file name is determined from
  1068.                       `MailBox=' in $UUPCUSRRC and `MailExt=' in
  1069.                       $UUPCSYSRC. 
  1070.  
  1071.                       (Example) uucplfil: zodiac.SPB
  1072.  
  1073.       mmdfldir:       (Optional) 
  1074.                       The directory where the maildrops in Unix formal,
  1075.                       converted from UUCP mail spool, are kept.  If
  1076.                       omitted, your home directory is used.
  1077.  
  1078.       mmdflfil:       (Optional)
  1079.                       The name of the maildrop file in the directory 
  1080.                       where Unix format maildrops are kept. If omitted,
  1081.                       the user's login name, gotten from USER environment
  1082.                       variable, is used.
  1083.  
  1084.    Example 1:  My local UUCP domain name is `xxx.yyy.uucp', UUCP maildrop
  1085.                file is `d:/uupc/mail/myname.SPB'.
  1086.  
  1087.                       uucpldir:    d:/uupc/mail
  1088.                       uucplfil:    myname.SPB
  1089.                       systemname:  xxx.yyy.uucp
  1090.  
  1091.    ** Important Note **
  1092.  
  1093.    Each line in a `mtstailor' file must end with CR(+LF).  Some
  1094.    editors does not automatically insert CR(+LF) character at the end
  1095.    of the last line so you need to intentionally insert it.  If there
  1096.    is no CR(+LF) at the end in the above examples, you may experience
  1097.    a bad `From:' mail header because the `localname:' statement,
  1098.    the last line in a file without CR(+LF), is ignored.
  1099.  
  1100.  
  1101. 2. Add the statements to your `CONFIG.SYS' to set the environmet
  1102.    variables. MH for OS/2 uses the following envionment varaibles:
  1103.  
  1104.  
  1105.       HOME            (Mundatory)
  1106.                       Your home directory where `.mh_profile' etc.
  1107.                       are placed.
  1108.  
  1109.                         example: SET HOME=D:\MY-HOME
  1110.  
  1111.  
  1112.       USER            (Mundatory)
  1113.                       UUCP node name.
  1114.  
  1115.  
  1116.       TZ              (Optional)
  1117.                       Your timezone.  You have to set this right to make the
  1118.                       `Date:' field of your sending mail correct. 
  1119.  
  1120.                       See "6.0 TZ environment variable" for the format 
  1121.                       of TZ environment variable.
  1122.  
  1123.  
  1124.       MHBINPATH       (Optional)
  1125.                       You need this environment variable only when
  1126.                       the directory for the MH executable files is
  1127.                       different from the directory specified by `bin'
  1128.                       statement in a `conf\os2\os2.uucp' file.
  1129.  
  1130.                       Set the full path of the directory where the MH
  1131.                       executable files are placed.
  1132.  
  1133.                         example: SET MHBINPATH=D:\MH\MH-PROGS
  1134.  
  1135.  
  1136.       MHETCPATH       (Optional)
  1137.                       You need this environment variable only when
  1138.                       the directory for the MH library files is
  1139.                       different from the directory specified by `etc'
  1140.                       statement in a `conf\os2\os2.uucp' file.
  1141.  
  1142.                       Set the full path of the directory where the MH
  1143.                       library files are placed.
  1144.  
  1145.                         example: SET MHETCPATH=D:\MH\MH-LIB
  1146.  
  1147.  
  1148.       TMP             (Optional)
  1149.                       Directory where MH places its temporary files.  If TMP
  1150.                       environmet is not specified, the temporary files will
  1151.                       be created under the current directory.
  1152.  
  1153.  
  1154.       NOMHNPROC       (Optional)
  1155.                       Now ``mhn'' command is available and it will be called
  1156.                       by show/next/prev commands by default for the MIME mails.
  1157.                       If you do not want to use ``mhn'' to show the mails or
  1158.                       if you want show/next/prev commands act as the previous
  1159.                       release of MH for OS/2, just set this envariable to
  1160.                       completely disable ``mhn'' command.
  1161.                       
  1162.                         example: SET NOMHNPROC=1
  1163.  
  1164.  
  1165. 3. Reboot the system to make the updated `CONFIG.SYS' effective.
  1166.  
  1167.  
  1168. 4. Run `install-mh' program which has been installed under the MH
  1169.    library file directory.  It prompts you the candidates of the mail 
  1170.    directory where your mail will be saved.  After you answered `N' to
  1171.    all the candidates, you can type in the whole path of your mail
  1172.    directory. 
  1173.  
  1174.    An `install-mh' program creates a `.mh_profile' under your home 
  1175.    directory if one does not exist.  It refuses to run when a
  1176.    `.mh_profile' already exists so you have to edit a profile
  1177.    manually. 
  1178.  
  1179.    When you issue a MH command, e.g. inc, without a `.mh_profile' in
  1180.    your home directory, an install-mh command is called and it creates
  1181.    a profile automatically.  In this case, your mail directory is set
  1182.    to $HOME/Mail (Mail directory under your home drectory).
  1183.  
  1184.  
  1185.  
  1186. 5.4 Verifying Setup
  1187. -------------------
  1188.  
  1189. 1. Before using MH with UUPC/Extended, you have to make sure that you
  1190.    can exchange the mails via UUPC/Extended alone.  MH sends the mails
  1191.    by queuing them via rmail.exe of UUPC/Extended.  MH incorporates the
  1192.    mails from the UUCP mail spool where the maildrops received by
  1193.    UUPC/Extended are kept.
  1194.  
  1195.  
  1196. 2. First, make sure your UUCP mail spool is empty.  Then send mails to
  1197.    yourself locally using MH and the mails are spooled in the mail
  1198.    spool file.
  1199.  
  1200.    Run `msgchk' command to see if MH can recognize the mail existence.
  1201.    It displays the message like below when it finds the mails in the
  1202.    mail spool.
  1203.  
  1204.        You have new old-style bell mail waiting
  1205.  
  1206.  
  1207.    If msgchk command ends with  a messsage like below, you have not 
  1208.    properly set up the MH.  Take a proper action then try again.
  1209.  
  1210.  
  1211.      Message:     You don't have any mail waiting
  1212.  
  1213.      Cause:       You have a wrong mtstailor.
  1214.                   rmail of UUPC/Extended was not executed properly.
  1215.  
  1216.      Action:      Check the mtstailor contents.
  1217.                   See `Configuration' section above for the mtstailor
  1218.                   file format.
  1219.  
  1220.                   Make sure rmail.exe in somewhere pointed to by PATH.
  1221.  
  1222.  
  1223. 3. Run `inc' command to incorporate the mails from UUPC mail spool.
  1224.  
  1225.    Check the validity of the headers of your mails.  The insufficient
  1226.    or incorrect setup will lead to the invalid headers, e.g. invalid
  1227.    `From:' or incorrect `Date:'.  Check your setting of TZ environmet
  1228.    variable and the contents of the mtstailor file to correct the error.
  1229.    See "6.0 TZ environment variable" for the correct TZ setting.
  1230.  
  1231.  
  1232.  
  1233. 5.5 Effective UUPC/Extended Settings
  1234. ------------------------------------
  1235.  
  1236. 1. The following UUPC/Extended settings are effective for MH:
  1237.  
  1238.    $UUPCSYSRC             $UUPCUSRRC
  1239.  
  1240.      Domain=                MailDir=
  1241.      MailExt=               ConfDir=
  1242.                             MailBox=
  1243.                             Name=
  1244.                             Home=
  1245.                             FileSent=
  1246.                             Signature= and options=[no]autosign
  1247.  
  1248.  
  1249. 5.6 Name Aliases
  1250. ----------------
  1251.  
  1252. 1. When you use MH with UUPC/Extended, the alias file of the
  1253.    UUPC/Extended is not reffered.  You need to setup the MH's
  1254.    alias file if you want to use the name aliases.
  1255.  
  1256.  
  1257.  
  1258. +-----------------------------------+
  1259. | 6.0 TZ environment variable       |
  1260. +-----------------------------------+
  1261.  
  1262. You have to set `TZ' environment variable right to make the `Date:'
  1263. field of your sending mail correct. TZ has the followng format:
  1264.  
  1265.     <TZ1>[<OFF>[<TZ2>[,<SM>,<SW>,<SD>,<ST>,<EM>,<EW>,<ED>,<ET>,<SHIFT>]]]
  1266.  
  1267. <TZ1> is the three-letter name of the standard timezone.
  1268.  
  1269. <OFF> is the offset to Coordinated Universal Time; positive values
  1270. are to the west of the Prime Meridian, negative values are to the
  1271. east of the Prime Meridian.  The offset can be specified as hours,
  1272. hours and minutes, or hours, minutes, and seconds.  Hours,
  1273. minutes, and seconds are separated by colons.  If <OFF> is not
  1274. specified, an offset of 0 will be used (this may change in the
  1275. future).
  1276.  
  1277. <TZ2> is the three-letter name of the summer timezone (daylight
  1278. saving time).  If <TZ2> is not specified, daylight saving time
  1279. does not apply.  If <TZ2> is specified, daylight saving time does
  1280. apply.
  1281.  
  1282. The remainder of the TZ's value specifies when and how to
  1283. change to and back from daylight saving time and only valid with
  1284. emx 0.9c or later.  If you are using emx 0.9a or 0.9b, you should
  1285. not set it.
  1286.  
  1287. <SM> through <ST> define, in current local time, when to switch 
  1288. from standard time to daylight saving time, <EM> through <ET> define,
  1289. in current local time, when to switch from daylight saving time to 
  1290. standard time.  (On the southern hemisphere, the end date precedes 
  1291. the start date.)  <SHIFT> is the amount of change in seconds.
  1292.  
  1293. <SM> specifies the month (1 through 12) of the change.  <SW>
  1294. specifies the week of the change; if this value is zero, <SD>
  1295. specifies the day of month (1 through 31).  If <SW> is positive (1
  1296. through 4), the change occurs on weekday <SD> (0=Sunday through
  1297. 6=Saturday) of the <SW>th week of the specified month.  The first
  1298. week of a month starts on the first Sunday of the month.  If <SW>
  1299. is negative (-1 through -4), the change occurs on weekday <SD>
  1300. (0=Sunday through 6=Saturday) of the -<SW>th week of the specified
  1301. month, counted from the end of the month (that is, -1 specifies
  1302. the last week of the month).  The last week of a month starts on
  1303. the last Sunday of the month.  <ST> specifies the time of the
  1304. change, in seconds.  Note that <ST> is specified in local standard
  1305. time and <ET> is specified in local daylight saving time.
  1306. Example:
  1307.  
  1308.     CET-1CED,3,-1,0,7200,10,-1,0,10800,3600
  1309.  
  1310. In this example, the name of the standard time zone is CET, the
  1311. name of the summer time zone is CED.  Daylight saving time starts
  1312. at 2:00 on the last Sunday of March and ends at 3:00 on the last
  1313. Sunday of October.  Time changes by one hour in daylight saving
  1314. time.
  1315.  
  1316. If no characters follow <TZ2>, the rule
  1317. `,4,1,0,3600,10,-1,0,7200,3600' will be used: Daylight saving time
  1318. starts at 1:00 on the first Sunday of April and ends at 2:00 on
  1319. the last Sunday of October.  Time changes by one hour in daylight
  1320. saving time.
  1321.  
  1322. If TZ is not set, Coordinated Universal Time will be used.
  1323.  
  1324.  
  1325.  
  1326. +---------------------------+
  1327. | 7.0 Using mh-e under OS/2 |
  1328. +---------------------------+
  1329.  
  1330. 1. If you are an mh-e user, I recommend you to use mh-e 5.  The mh-e 4
  1331.    is not compatible with OS/2 and it needs patches to mh-utils.el to
  1332.    work under OS/2 environment.  If you have to use mh-e 4 by some
  1333.    reason, please apply a `os2/mh4-utils.el.diff' patch.
  1334.  
  1335.  
  1336. 2. You need to add the following 2 lines to your ~/.emacs file. (Please
  1337.    change the names of the directories to match to your environment)
  1338.  
  1339.        (setq mh-progs (cond (t "d:/mh/mh-progs/")))
  1340.        (setq mh-lib   (cond (t "d:/mh/mh-lib/")))
  1341.  
  1342.  
  1343. 3. Some functions of mh-e hard-coded `/bin/sh' as a shell program and
  1344.    uses a sh shell script to perform their functions.  Therefore,
  1345.    those functions does not work if you are using OS/2's standard
  1346.    cmd.exe or any other non-Unix shell.  Some of those functions are:
  1347.  
  1348.     mh-redistribute  (ESC d) 
  1349.     mh-edit-mhn      (C-c C-e)
  1350.  
  1351.    A `os2/mh5-os2cmd.diff' file contains patches for mh-e 5.0 to make
  1352.    those functions work with cmd.exe.
  1353.  
  1354.    Some other functions may not work under OS/2 by other reasons.
  1355.    Currently, I do not have a list of the mh-e functions which are
  1356.    incompatible under OS/2.
  1357.  
  1358.  
  1359. 4. You need yo add a following statement to your `.emacs' to avoid the
  1360.    problem where `mh-rmail' reports `no current message' even after it
  1361.    successfully incorporates the incoming mails into your inbox folder.
  1362.  
  1363.        (setq mh-auto-folder-collect nil)
  1364.  
  1365.    This disables the mh-e's feature to automatically gather the folder
  1366.    names in the backgound at mh-e startup time.  An `mh-rmail'
  1367.    function kicks `folders' process then call `inc'.  When `inc' is
  1368.    called before the `folder' process finishes, the problem takes
  1369.    place. 
  1370.  
  1371.  
  1372.  
  1373. +----------------+
  1374. | 8.0 About MIME |
  1375. +----------------+
  1376.  
  1377. 1. If you use MH with mh-e on the Emacs editor, you can use a `tm'
  1378.    package for the MIME message manipulation. The additional package 
  1379.    for OS/2, `tm-os2', is also available.  You can get tm and tm-os2 
  1380.    from the following anonymous ftp site:
  1381.    
  1382.       ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime
  1383.  
  1384.    Beta testing of tm version 7 is currently under way (as of Sep
  1385.    21, 1995).  It is a powerful MIME tool for Emacs providing the
  1386.    fuctions to compose and view a various types of MIME messages.
  1387.  
  1388.  
  1389.  
  1390. +---------------------------+
  1391. | 9.0 Consideration for mhn |
  1392. +---------------------------+
  1393.  
  1394. 1. Mhn command is invoked by show/prev/next commands by defualt for
  1395.    the MIME mails.  If you do not want to use mhn command, just set
  1396.    the following envariable:
  1397.  
  1398.      SET NOMHNPROC=1 
  1399.  
  1400.    This will disable the use of mhn and force show/prev/next commands
  1401.    act as the previous release of MH for OS/2.
  1402.  
  1403.  
  1404. 2. A file named ``mhn_defaults'' is created in your MH library directory
  1405.    during MH installtion.  The installer searches the programs in your
  1406.    PATH directories and adds the entries for each MIME type.
  1407.  
  1408.    You can modify a ``mhn_defaults'' file by yourself to add entries
  1409.    for new MIME types or to modify the existing entries set by the
  1410.    installer.   You can find the information of the mhn_defaults
  1411.    syntax in the man manual.  Also, you may want to get more
  1412.    information for mhn and mhn_defaults from:
  1413.  
  1414.       ftp://ftp.ics.uci.edu/mh/contrib/multimedia/mhn-tutorial.ps.Z
  1415.       ftp://ftp.ics.uci.edu/mh/contrib/multimedia/mhn-tutorial.tex.Z
  1416.  
  1417.  
  1418. 3. OS/2 mhn has the following default values for showing `text/plain' 
  1419.    and `message/rfc822' MIME types:
  1420.  
  1421.       mhn-show-text/plain: %pless %F
  1422.       mhn-show-message/rfc822: %pless %F
  1423.  
  1424.     
  1425.  
  1426. +--------------------+
  1427. | 10.0 Compatibility |
  1428. +--------------------+
  1429.  
  1430. 1. The group can not be specified in an alias file.  That is, you can
  1431.    not use identifiers like `=' and `+'.
  1432.  
  1433.  
  1434. 2. The default showproc is `mhl' in OS/2 while `more' is default in
  1435.    Unix.  The default moreproc is not defined in OS/2 while the
  1436.    default is `more' in Unix.
  1437.  
  1438.  
  1439. 3. The environment variables MHBINPATH and MHETCPATH are OS/2 unique
  1440.    enhancements.  With these variables, you can move MH binaries to
  1441.    the other PC's without re-compiling them.
  1442.  
  1443.  
  1444. 4. The pipe (`|') action of slocal calls the shell program which is
  1445.    pointed to by COMSPEC environment variable, while Unix version of MH
  1446.    alway calls /bin/sh. 
  1447.  
  1448.  
  1449.  
  1450. +-----------------------+
  1451. | 11.0 Trouble Shooting |
  1452. +-----------------------+
  1453.  
  1454. 1. Configure.cmd fails and no Makefiles are generated.
  1455.  
  1456.    - If you are using an Unix like shell, back up to a CMD.EXE then
  1457.      start configuration.  After you complete making and installing
  1458.      MH, you can restore the Unix shell.
  1459.  
  1460.  
  1461. 2. Error occurs during making uip/Makefile.
  1462.  
  1463.    - You may have GNU sed 3.0 which has a bug. GNU sed 3.0 was
  1464.      re-release for the bug fix.  Make sure you have a newer GNU
  1465.      sed 3.0.
  1466.  
  1467.  
  1468. 3. Make.exe traps during making doc/Makefile.
  1469.  
  1470.    - New GNU make with a fix to this problem is available on hobbes
  1471.      and leo.
  1472.  
  1473.  
  1474. 4. Compilation fails wirh ``netdb.h: No such file or directory''
  1475.    message.
  1476.  
  1477.    - Install bsddev.zip of emx/gcc package.
  1478.  
  1479.  
  1480. 5. Msgchk, inc, or send generates core dump.
  1481.  
  1482.    - If you are using emx/gcc 0.9a, apply the latest fix, fix06, then
  1483.      make MH modules again.
  1484.  
  1485.  
  1486. 6. Cannot read a MIME mail due to mhn error.
  1487.  
  1488.    - Mhn will fail when it processes a mail with CR+LF.  If you have
  1489.      used MH for OS/2 Rev 01, the mail files incorporated by it have
  1490.      CR+LF EOL codes.  You can convert EOL from CR+LF to LF by once
  1491.      packing folder with packf command then unpack it with inc command.
  1492.      The mail files with LF EOL can be properly handled by mhn.
  1493.  
  1494.    - You may get the error message like below from mhn:
  1495.  
  1496.         mhn: don't know how to display content
  1497.              (content xxxxxxx in message y)
  1498.  
  1499.      You need to add an entry for MIME type of xxxxxxx to your 
  1500.      mhn_defaults file to let mhn know how to process that MIME type.
  1501.  
  1502.  
  1503. 7. `Date:' field of an outgoing mail is wrong.
  1504.  
  1505.    - You should correctly set TZ environment variable.  See "6.0 TZ
  1506.      environment variable" for the detail.
  1507.  
  1508.  
  1509. 8. OS/2 sendmail.exe traps while sending a mail.
  1510.  
  1511.    - If you edited SENDMAIL.UML with the editor like tedit.exe which 
  1512.      replaces TAB with spaces, you may encounter this problem.
  1513.  
  1514.  
  1515.  
  1516. +-------------------+
  1517. | 12.0 Restrictions |
  1518. +-------------------+
  1519.  
  1520. 1. The following commands are not available:
  1521.  
  1522.        vmh  wmh  rcvtty
  1523.  
  1524.  
  1525. 2. When you use MH with UUPC/Extended, the alias file of the
  1526.    UUPC/Extended is not reffered.  You need to setup the MH's
  1527.    alias file if you want to use the name aliases.
  1528.  
  1529.  
  1530.  
  1531. +-----------------+
  1532. | 13.0 Bug Report |
  1533. +-----------------+
  1534.  
  1535. When you find a bug, please send an e-mail to
  1536.  
  1537.     Hiroshi Ueno <zodiac@ibm.net>
  1538.  
  1539. I will fix your problem as much as I can, However, I can not garantee
  1540. that I will be able to fix all of your problems.  Also, my response 
  1541. may be delayed, depending on the time I can spend for MH for OS/2.
  1542.  
  1543.  
  1544. There is NO WARRANTY in this program.  Use this program on your own
  1545. risk and responsibility.
  1546.  
  1547. ;;; @
  1548. ;;; Local Variables:
  1549. ;;; mode: text
  1550. ;;; End:
  1551.