home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / utils / elm / sources / readme.os2 < prev    next >
Text File  |  1992-10-04  |  12KB  |  315 lines
  1. This is an OS/2 version of the ELM Mail System. It runs on OS/2
  2. 1.x and 2.x together with UUPC 1.11 and hopefully newer versions.
  3.  
  4. Elm was heavily hacked to run in this environment because it was a
  5. *real* Unix program, with many long pathnames and Unix dependen-
  6. cies hardcoded. I have made it independent of pathnames and
  7. constants defined at compile time. All files of the elm system are
  8. stored in the UUPC directory tree.
  9.  
  10. No extra environment variables have to be set for elm in additon
  11. to those already used by the UUPC software. It checks the UUPC
  12. system and user configuration files (usually uupc.rc and
  13. personal.rc) pointed to by the UUPCSYSRC and UUPCUSRRC environment
  14. variables for the UUPC location, hostname, domainname and other
  15. information.
  16.  
  17. The LOGNAME environment variable, UUPC passwd file (if any) and
  18. user configuration file (personal.rc) are checked for the user's
  19. name, full name and "home directory" which could be set in passwd
  20. to a subdirectory of the UUPC root directory for convenience.
  21.  
  22. Make sure you include the drive specification in the home
  23. directory fields in the passwd file if you want to call elm from
  24. another drive (don't worry about the : in the drive spec, because
  25. it is treated specially in the passwd lines, in which the fields
  26. are separated by : too).
  27.  
  28. The TMP environment variable is used to determine the directory
  29. where temporary files are created.
  30.  
  31. Elm uses the termcap database and library to access the screen.
  32. It uses the TERM (and possibly TERMCAP) environment variables and
  33. a file called termcap.dat under OS/2.
  34.  
  35. User selection/multiple users:
  36.  
  37. - Like UUPC, elm looks for an environment variable LOGNAME which
  38.   should contain the name of the current user. If it is not found
  39.   elm looks into the user config file (pointed to by UUPCUSRRC)
  40.   for the name to determine the user's incoming mailbox. The full
  41.   name of the user and his (her) "home directory" are read from
  42.   the passwd file in the UUPC configuration directory. If it
  43.   cannot be found (no passwd file or no matching entry in it) and
  44.   LOGNAME matches the name in the user config file, the full name
  45.   and home directory are read from the user config file. If an
  46.   entry in passwd is found for the user which owns the user config
  47.   file, the passwd entry has precedence over the user config file.
  48.  
  49. - By setting the LOGNAME variable, you can easily switch to
  50.   another user, if more than one user uses your OS/2 system for
  51.   e-mail. But this does only work for elm, not for the standard
  52.   UUPC mailer.
  53.  
  54. Restrictions:
  55.  
  56. - mailbox (folder) names are restricted to 8 characters on FAT
  57.   file systems. If you use the save command in elm to save a
  58.   message to the default folder (which has the same name as the
  59.   sender, =<sender>), you will get trouble if the sender's name
  60.   (login id in this case) exceeds 8 characters, but this is rarely
  61.   the case. This restriction does not apply to HPFS systems.
  62.  
  63. File name changes:
  64.  
  65. Because of the 8.3. restriction on FAT file systems, the following
  66. file names have been changed in the elm distribution. The manuals were
  67. not changed. Have these name changes in mind when reading the
  68. manuals. Note that /uupc is assumed as a sample UUPC directory
  69. here, substitute your UUPC directory for it. ~ denotes your home
  70. directory.
  71.  
  72.   EMERGENCY_MBOX               to  emergenc.mbx
  73.   MBOX.EMERGENCY               to  emerg.mbx
  74.  
  75.   /etc/passwd                  to  /uupc/passwd
  76.   /usr/mail/<name>             to  /uupc/mail/<name>
  77.   /tmp/mbox.<name>             to  /uupc/elm/<name>.mbx
  78.  
  79.   [Note that /uupc/mail may be different if you change the
  80.    MailDir= setting in the system config file.]
  81.  
  82.   /usr/local/lib/elm-help.*    to  /uupc/elm/elm-help.*
  83.   /usr/local/lib/aliases.text  to  /uupc/elm/aliases.txt
  84.   /usr/local/lib/aliases.hash  to  /uupc/elm/aliases.hsh
  85.   /usr/local/lib/aliases.data  to  /uupc/elm/aliases.dat
  86.  
  87.   ~/.elm/aliases.text          to  ~/elm/aliases.txt
  88.   ~/.elm/aliases.hash          to  ~/elm/aliases.hsh
  89.   ~/.elm/aliases.data          to  ~/elm/aliases.dat
  90.  
  91.   ~/.elm/elmrc                 to  ~/elm/elmrc
  92.   ~/.elm/elmheaders            to  ~/elm/elmhdrs
  93.  
  94.   ~/.elm/filter-rules          to  ~/elm/filter.rul
  95.   ~/.elm/filterlog             to  ~/elm/filter.log
  96.   ~/.elm/filtersum             to  ~/elm/filter.sum
  97.  
  98.   ~/.readmsg                   to  ~/current.msg
  99.  
  100.   /etc/autoreply.data          to  /uupc/elm/autorep.dat
  101.   /etc/autoreply.log           to  /uupc/elm/autorep.log
  102.  
  103. Some other temporary and lock file names were changed as needed.
  104.  
  105. Installation:
  106.  
  107. - put elm.exe and perhaps other programs of the elm distribution
  108.   into the directory where mail.exe and rmail.exe reside.
  109.  
  110. - Make a subdirectory ELM in the UUPC configuration directory
  111.   (ConfDir) and put there the following files from the
  112.   distribution:
  113.  
  114.   newalias.exe
  115.   elmrc.inf
  116.   elm-help.0
  117.   elm-help.1
  118.   elm-help.2
  119.   elm-help.3
  120.  
  121.   You may also want to create a system alias file called
  122.   aliases.txt here with system wide aliases. Run "newalias -g" to
  123.   create aliases.hsh and aliases.dat in this case. See the elm
  124.   manuals about the format of alias files.
  125.  
  126. - In your "home directory", where UUPC keeps your signature files
  127.   and mail folders, create a subdirectory ELM too. Put there your
  128.   personal configuration files, such as elmrc (created
  129.   automatically when you first change options in elm and save
  130.   them), your signature files (put their names into elmrc) and
  131.   personal alias file aliases.txt (also created and maintained
  132.   from within elm). The personal ELM directory is needed for every
  133.   elm user on the system. If you don't yet have such files (i.e.
  134.   don't have already used elm on a Unix system and are new to
  135.   elm), don't worry, the necessary files are created by elm
  136.   automatically.
  137.  
  138. - Make sure you have set UUPCSYSRC, UUPCUSRRC and perhaps LOGNAME
  139.   correctly.
  140.  
  141. - Set the environment variable EDITOR to the editor you wish to use
  142.   for editing mail and PAGER for the program you wish to use for
  143.   viewing mail messages. This step is optional, because both programs
  144.   can be set from within the elm options menu and are saved in the
  145.   elm configuration file for each user.
  146.  
  147. - If you don't yet have a termcap database file installed, copy
  148.   the termcap.dat file from the os2 subdirectory of the
  149.   distribution to a directory where you keep configuration files
  150.   and make sure it can be found using the PATH, DPATH or INIT
  151.   environment variables. Note that it is named termcap.dat, not
  152.   only termcap like under Unix.
  153.  
  154.  
  155. That's all.
  156.  
  157. Elm should work now if you call it and display your mailbox. The
  158. format of the UUPC mailbox folders is a bit different than under
  159. Unix, because the messages are separated by lines containing only
  160. 20 ASCII 001 characters. However, elm can also read standard Unix
  161. mailbox folders.
  162.  
  163. If you install UUPC and ELM on a LAN of OS/2 workstations, you can
  164. install them on a shared network drive. In this case, they serve as a
  165. local mailing system in the LAN too, with a bridge over UUPC to the
  166. outer world.
  167.  
  168. Besides elm.exe, other programs are included with the distribution:
  169.  
  170. - answer.exe, a program for secretaries or other people not too familiar
  171.   with computers, to send mail.
  172. - autorep.exe and arepdaem.exe, an "answering machine" for mail.
  173. - fastmail.exe, to send mass batch mail.
  174. - filter.exe, to filter your incoming mail.
  175. - from.exe, to show an overview of your mailbox contents.
  176. - listalias.exe, to list mail aliases.
  177. - newalias.exe, a subprogram called by elm to maintain alias files.
  178. - newmail.exe, which can monitor a mailbox in the background and notify
  179.   you of incoming mail. It can be copied to wnewmail.exe for a different
  180.   behaviour, see manuals.
  181. - readmsg.exe, to read single messages out of mailbox folders to feed
  182.   them into other programs over pipes (such as filter.exe). It is called
  183.   from within elm.exe too.
  184.  
  185. Documentation for the programs is included in the distribution in pre-
  186. formatted versions in the manuals subdirectory. The .PS files are
  187. PostScript files for the printed manuals while the .MAN files are
  188. preformatted online manual files.
  189.  
  190. Not all of these programs make sense in a standalone setup, for which
  191. probably only answer.exe, and filter.exe may be useful (and readmsg.exe
  192. and newalias.exe, of course, called by elm.exe). The other programs may
  193. be useful in LAN environments, where UUPC and ELM are used as a local
  194. mailing system as mentioned above.
  195.  
  196. The rmail.exe included with UUPC uses forward files like sendmail and
  197. thus allows to use filter.exe like mentioned for Unix with sendmail in
  198. the filter manual, i.e. allows to put "|filter" in your forward file.
  199. Put this line without the quotes in the forward file as specified in the
  200. UUPC installation manual.
  201.  
  202. Please read the documentation in the manuals directory carefully for
  203. further information.
  204.  
  205. The distribution contains full source code and diffs to the original
  206. files for those who want to adapt ELM to other mailers. ELM uses
  207. rmail.exe of UUPC in RFC-822 mode.
  208.  
  209. Please send bug reports (if any) to me.
  210.  
  211.  
  212. Initial release,
  213. March 22 1992
  214.  
  215. -----------------------------------------------------------------------
  216.  
  217. Bug fix release 1,
  218. March 29 1992
  219.  
  220. Changes:
  221.  
  222. - The UUPC system config file (usually uupc.rc) is checked for more
  223.   settings.
  224. - The mail directory is no longer fixed but read from MailDir in
  225.   uupc.rc.
  226. - The passwd file is now parsed correctly.
  227. - LOGNAME, user config file (personal.rc) and passwd usage strategy
  228.   cleaned up and documented in README.OS2
  229. - The missing termcap database file was added.
  230. - Mailbox file extension of UUPC is now supported.
  231. - A NULL pointer reference was fixed.
  232. - PATCH01.OS2 file added which contains list of changed files
  233.   in this bug fix release.
  234. - Some minor other bugs fixed.
  235.  
  236. -----------------------------------------------------------------------
  237.  
  238. Bug fix release 2,
  239. May 3 1992
  240.  
  241. Changes:
  242.  
  243. - Printing now works correctly.
  244. - The folder listing (? at the 'c' command) now works.
  245. - Some other minor bugs fixed.
  246.  
  247. -----------------------------------------------------------------------
  248.  
  249. Bug fix release 3,
  250. May 26 1992
  251.  
  252. Changes:
  253.  
  254. - Parsing of mail folders corrected/enhanced.
  255. - Forwarding of messages corrected.
  256. - Handling of (reply to) received forwarded messages corrected.
  257. - Support for UUPC's directory option added.
  258. - Folder editing fixed (close current folder before calling editor).
  259.  
  260. -----------------------------------------------------------------------
  261.  
  262. Bug fix release 4,
  263. Aug 16 1992
  264.  
  265. Changes:
  266.  
  267. - Keyboard timeout implemented (for mailbox check)
  268. - inclusion of ~/elm/elmhdrs fixed
  269. - uses BSD crypt routine now for encoded mail, 
  270.   but still doesn't work to/from Unix, no idea why
  271. - New -n option for "do not save outgoing mail", for batch mailing
  272. - New -u option for "scan UUPC mailbox more restrictive"
  273.  
  274. Note to -u: without it, the UUPC message separators (20 times ^A)
  275. are ignored and scanning like under Unix takes place. With -u and
  276. if the mailbox starts with a UUPC separator (and only then), only
  277. messages separated this way are recognized. This treats messages
  278. correctly which are part of the body of another message.
  279.  
  280. -----------------------------------------------------------------------
  281.  
  282. Bug fix release 5,
  283. Oct 04 1992
  284.  
  285. Changes:
  286.  
  287. - can now compiled to 32-bit version too (with emx+gcc 0.8e)
  288. - more cursor keys supported
  289. - uses GNU glibc crypt (ufc) routine now for encoded mail and
  290.   this does now really work to/from Unix systems!
  291. - correct README.OS2 on rmail searching method
  292. - fix some path names to use / and some to use \ depending on
  293.   what they are used for
  294.  
  295. -----------------------------------------------------------------------
  296.  
  297. Original elm authors:
  298.  
  299.    Dave Taylor, Syd Weinstein
  300.  
  301.    See the manual for regular mail and e-mail addresses.
  302.  
  303. Ported to OS/2 by:
  304.  
  305.    Kai Uwe Rommel
  306.    Zennerstrasse 1
  307.    D-8000 Muenchen 70
  308.    Germany
  309.  
  310.    Phone: +49 89 723 4101
  311.    Fax:   +49 89 723 7889
  312.  
  313.    E-Mail: rommel@jonas.ucrc.sub.org (primary, but UUCP-based, i.e. a bit slow)
  314.        rommel@informatik.tu-muenchen.de (large mails, faster turn-around)
  315.