home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / elm23-2.zip / README.OS2 < prev    next >
Text File  |  1997-02-02  |  21KB  |  527 lines
  1. This is an OS/2 version of the Elm Mail System. It runs on OS/2 2.0
  2. or newer together with UUPC 1.11 (rmail transport agent) and newer
  3. versions or with IBM TCP/IP 1.2.1 or newer (sendmail transport).  The
  4. included executables require the emx runtime library, you should be
  5. able to find it (emxrt.zip) where you got this Elm distribution.
  6.  
  7. Elm was heavily hacked to run in this environment because it was a
  8. *real* Unix program, with many long pathnames and Unix dependen- cies
  9. hardcoded. I have made it independent of pathnames and constants
  10. defined at compile time. All files of the Elm system are stored in the
  11. runtime-settable directories. Elm uses the UUPC config (.rc) file(s)
  12. to determine the location of all files. For TCP/IP, a dummy UUPC .rc
  13. file is used (see below and README.TCP for more information).
  14.  
  15. No extra environment variables have to be set for Elm in additon to
  16. those already used by the UUPC software. It checks the UUPC system and
  17. user configuration files (usually uupc.rc and personal.rc) pointed to
  18. by the UUPCSYSRC and UUPCUSRRC environment variables for the UUPC
  19. location, hostname, domainname and other information.
  20.  
  21. The LOGNAME environment variable, UUPC (or TCP/IP) passwd file (if
  22. any) and user configuration file (personal.rc) are checked for the
  23. user's name, full name and "home directory" which could be set in
  24. passwd to a subdirectory of the UUPC root directory for convenience.
  25.  
  26. Make sure you include the drive specification in the home directory
  27. fields in the passwd file if you want to call Elm from another drive
  28. (don't worry about the : in the drive spec, because it is treated
  29. specially in the passwd lines, in which the fields are separated by :
  30. too).
  31.  
  32. The settings required to be set in the UUPC .rc files for Elm to
  33. function properly are NodeName, Domain, ConfDir, MailDir, TempDir,
  34. Mailbox, Name, Home, Editor and Pager. Optionally you can set
  35. FromDomain (for UUPC site hiding) and ReplyTo. It is possible but not
  36. recommended to use the UUPC setting MailExt and the UUPC option
  37. Directory. See the UUPC documentation for an explanation of these
  38. settings. The sample TCP/IP .rc file (see also README.TCP) also
  39. contains exactly the required set of settings, for reference.
  40.  
  41. Elm uses the termcap database and library to access the screen (a very
  42. common method for Unix programs). It uses the TERM (and possibly
  43. TERMCAP) environment variables and a file called termcap.dat under
  44. OS/2.
  45.  
  46. User selection/multiple users:
  47.  
  48. - Like UUPC, Elm looks for an environment variable LOGNAME which
  49.   should contain the name of the current user. If it is not found
  50.   Elm looks into the user config file (pointed to by UUPCUSRRC)
  51.   for the name to determine the user's incoming mailbox. The full
  52.   name of the user and his (her) "home directory" are read from
  53.   the passwd file in the UUPC configuration directory. If it
  54.   cannot be found (no passwd file or no matching entry in it) and
  55.   LOGNAME matches the name in the user config file, the full name
  56.   and home directory are read from the user config file. If an
  57.   entry in passwd is found for the user which owns the user config
  58.   file, the passwd entry has precedence over the user config file.
  59.  
  60. - By setting the LOGNAME variable, you can easily switch to
  61.   another user, if more than one user use your OS/2 system for
  62.   e-mail. But this does only work for Elm, not for the standard
  63.   UUPC mailer.
  64.  
  65. Restrictions:
  66.  
  67. - mailbox (folder) names are restricted to 8 characters on FAT
  68.   file systems. If you use the save command in Elm to save a
  69.   message to the default folder (which has the same name as the
  70.   sender, =<sender>), you will get trouble if the sender's name
  71.   (login id in this case) exceeds 8 characters, but this is rarely
  72.   the case. This restriction does not apply to HPFS systems.
  73.  
  74. File name changes:
  75.  
  76. Because of the 8.3. restriction on FAT file systems, the following
  77. file names have been changed in the Elm distribution. The manuals were
  78. not changed. Have these name changes in mind when reading the
  79. manuals. Note that /uupc is assumed as a sample UUPC directory
  80. here, substitute your UUPC directory for it. ~ denotes your home
  81. directory.
  82.  
  83.   EMERGENCY_MBOX               to  emergenc.mbx
  84.   MBOX.EMERGENCY               to  emerg.mbx
  85.  
  86.   /etc/passwd                  to  /uupc/passwd
  87.   /usr/mail/<name>             to  /uupc/mail/<name>
  88.   /tmp/mbox.<name>             to  /uupc/elm/<name>.mbx
  89.  
  90.   [Note that /uupc/mail may be different if you change the
  91.    MailDir= setting in the system config file.]
  92.  
  93.   /usr/local/lib/elm-help.*    to  /uupc/elm/elm-help.*
  94.   /usr/local/lib/aliases.text  to  /uupc/elm/aliases.txt
  95.   /usr/local/lib/aliases.hash  to  /uupc/elm/aliases.hsh
  96.   /usr/local/lib/aliases.data  to  /uupc/elm/aliases.dat
  97.  
  98.   ~/.elm/aliases.text          to  ~/elm/aliases.txt
  99.   ~/.elm/aliases.hash          to  ~/elm/aliases.hsh
  100.   ~/.elm/aliases.data          to  ~/elm/aliases.dat
  101.  
  102.   ~/.elm/elmrc                 to  ~/elm/elmrc
  103.   ~/.elm/elmheaders            to  ~/elm/elmhdrs
  104.  
  105.   ~/.elm/filter-rules          to  ~/elm/filter.rul
  106.   ~/.elm/filterlog             to  ~/elm/filter.log
  107.   ~/.elm/filtersum             to  ~/elm/filter.sum
  108.  
  109.   ~/.readmsg                   to  ~/current.msg
  110.  
  111.   /etc/autoreply.data          to  /uupc/elm/autorep.dat
  112.   /etc/autoreply.log           to  /uupc/elm/autorep.log
  113.  
  114. Some other temporary and lock file names were changed as needed.
  115.  
  116. Installation:
  117.  
  118. - Put elm.exe and perhaps other programs of the Elm distribution into
  119.   the directory where mail.exe and rmail.exe (or sendmail.exe if you
  120.   are using TCP/IP) reside, put the emx runtime DLL's (if required) in
  121.   a directory in LIBPATH. Make sure you always keep the newest
  122.   versions of these DLL's and have only one copy in your LIBPATH.
  123.  
  124. - Make a subdirectory ELM in the UUPC configuration directory
  125.   (ConfDir) and put there the following files from the
  126.   distribution:
  127.  
  128.   elmrc.inf
  129.   elm-help.0
  130.   elm-help.1
  131.   elm-help.2
  132.   elm-help.3
  133.  
  134.   You may also want to create a system alias file called
  135.   aliases.txt here with system wide aliases. Run "newalias -g" to
  136.   create aliases.hsh and aliases.dat in this case. See the Elm
  137.   manuals about the format of alias files.
  138.  
  139. - In your "home directory", where UUPC keeps your signature files
  140.   and mail folders, create a subdirectory ELM too. Put there your
  141.   personal configuration files, such as elmrc (created
  142.   automatically when you first change options in Elm and save
  143.   them), your signature files (put their names into elmrc) and
  144.   personal alias file aliases.txt (also created and maintained
  145.   from within Elm). The personal ELM directory is needed for every
  146.   Elm user on the system. If you don't yet have such files (i.e.
  147.   don't have already used Elm on a Unix system and are new to
  148.   Elm), don't worry, the necessary files are created by Elm
  149.   automatically.
  150.  
  151. - Make sure you have set UUPCSYSRC, UUPCUSRRC and perhaps LOGNAME
  152.   correctly.
  153.  
  154. - Set the environment variable EDITOR to the editor you wish to use
  155.   for editing mail and PAGER for the program you wish to use for
  156.   viewing mail messages. This step is optional, because both programs
  157.   can be set from within the Elm options menu and are saved in the
  158.   Elm configuration file for each user.
  159.  
  160. - If you don't yet have a termcap database file installed, copy
  161.   the termcap.dat file from the os2 subdirectory of the
  162.   distribution to a directory where you keep configuration files
  163.   and make sure it can be found using the PATH, DPATH or INIT
  164.   environment variables. Note that it is named termcap.dat, not
  165.   only termcap like under Unix.
  166.  
  167. That's all.
  168.  
  169. Elm should work now if you call it and display your mailbox. The
  170. format of the UUPC mailbox folders is a bit different than under
  171. Unix, because the messages are separated by lines containing only
  172. 20 ASCII 001 characters. However, Elm can also read standard Unix
  173. mailbox folders. TCP/IP's sendmail delivers incoming mail as one
  174. message per file in the \tcpip\etc\mail directory. If configured for
  175. TCP/IP, elm.exe and the other programs know about this fact and always
  176. first move any new incoming mail into the user's normal mailbox file,
  177. also with the UUPC style separators (see also README.TCP).
  178.  
  179. If you install UUPC and Elm on a LAN of OS/2 workstations, you can
  180. install them on a shared network drive. In this case, they serve as a
  181. local mailing system in the LAN too, with a bridge to the outer world
  182. via UUPC.
  183.  
  184. Besides elm.exe, other programs are included with the distribution:
  185.  
  186. - answer.exe, a program for secretaries or other people not too familiar
  187.   with computers, to send mail.
  188. - autorep.exe and arepdaem.exe, an "answering machine" for mail.
  189. - fastmail.exe, to send mass batch mail.
  190. - filter.exe, to filter your incoming mail.
  191. - from.exe, to show an overview of your mailbox contents.
  192. - listalias.exe, to list mail aliases.
  193. - newalias.exe, a subprogram called by Elm to maintain alias files.
  194. - newmail.exe, which can monitor a mailbox in the background and notify
  195.   you of incoming mail. It can be copied to wnewmail.exe for a different
  196.   behaviour, see manuals.
  197. - readmsg.exe, to read single messages out of mailbox folders to feed
  198.   them into other programs over pipes (such as filter.exe). It is called
  199.   from within elm.exe too.
  200. - sndmail.exe, a "wrapper" program to call the TCP/IP sendmail
  201.   program. It is only needed if you use Elm with IBM TCP/IP.  
  202.  
  203. Documentation for the programs is included in the distribution in pre-
  204. formatted versions in the manuals subdirectory. The .PS files are
  205. PostScript files for the printed manuals while the .MAN files are
  206. preformatted online manual files.
  207.  
  208. Not all of these programs make sense in a standalone setup, for which
  209. probably only answer.exe, and filter.exe may be useful (and
  210. readmsg.exe and newalias.exe, of course, called by elm.exe). The other
  211. programs may be useful in LAN environments, where UUPC and Elm are
  212. used as a local mailing system as mentioned above. If you are using
  213. TCP/IP (sendmail), you must install the small sndmail.exe utility
  214. program, in any case.
  215.  
  216. The rmail.exe included with UUPC uses forward files and thus allows to
  217. use filter.exe like mentioned for Unix with sendmail in the filter
  218. manual, i.e. allows to put "|filter" in your forward file.  Put this
  219. line without the quotes in the forward file as specified in the UUPC
  220. installation manual. However, the current setting of the LOGNAME
  221. variable or UUPC user name will be used by filter at runtime, not
  222. necessarily the recipient of the filtered message, due to a deficieny
  223. in UUPC's rmail.exe (which doesn't set the recipient's name in LOGNAME
  224. before calling filter.exe). The included OS/2 version thus has a new
  225. option "-u user" so you can put "|filter -u yourname" into your forward
  226. file to work around this problem.
  227.  
  228. Please read the documentation in the manuals directory carefully for
  229. further information.
  230.  
  231. The distribution contains full source code and diffs to the original
  232. files for those who want to adapt Elm to other mailers. Elm uses
  233. rmail.exe of UUPC in RFC-822 mode.
  234.  
  235. Please send bug reports (if any) to me.
  236.  
  237.  
  238. Initial release,
  239. March 22 1992
  240.  
  241. -----------------------------------------------------------------------
  242.  
  243. Bug fix release 1,
  244. March 29 1992
  245.  
  246. Changes:
  247.  
  248. - The UUPC system config file (usually uupc.rc) is checked for more
  249.   settings.
  250. - The mail directory is no longer fixed but read from MailDir in
  251.   uupc.rc.
  252. - The passwd file is now parsed correctly.
  253. - LOGNAME, user config file (personal.rc) and passwd usage strategy
  254.   cleaned up and documented in README.OS2
  255. - The missing termcap database file was added.
  256. - Mailbox file extension of UUPC is now supported.
  257. - A NULL pointer reference was fixed.
  258. - Some minor other bugs fixed.
  259.  
  260. -----------------------------------------------------------------------
  261.  
  262. Bug fix release 2,
  263. May 3 1992
  264.  
  265. Changes:
  266.  
  267. - Printing now works correctly.
  268. - The folder listing (? at the 'c' command) now works.
  269. - Some other minor bugs fixed.
  270.  
  271. -----------------------------------------------------------------------
  272.  
  273. Bug fix release 3,
  274. May 26 1992
  275.  
  276. Changes:
  277.  
  278. - Parsing of mail folders corrected/enhanced.
  279. - Forwarding of messages corrected.
  280. - Handling of (reply to) received forwarded messages corrected.
  281. - Support for UUPC's directory option added.
  282. - Folder editing fixed (close current folder before calling editor).
  283.  
  284. -----------------------------------------------------------------------
  285.  
  286. Bug fix release 4,
  287. Aug 16 1992
  288.  
  289. Changes:
  290.  
  291. - Keyboard timeout implemented (for mailbox check)
  292. - inclusion of ~/elm/elmhdrs fixed
  293. - uses BSD crypt routine now for encoded mail, 
  294.   but still doesn't work to/from Unix, no idea why
  295. - New -n option for "do not save outgoing mail", for batch mailing
  296. - New -u option for "scan UUPC mailbox more restrictive"
  297.  
  298. Note to -u: without it, the UUPC message separators (20 times ^A)
  299. are ignored and scanning like under Unix takes place. With -u and
  300. if the mailbox starts with a UUPC separator (and only then), only
  301. messages separated this way are recognized. This treats messages
  302. correctly which are part of the body of another message.
  303.  
  304. -----------------------------------------------------------------------
  305.  
  306. Bug fix release 5,
  307. Oct 04 1992
  308.  
  309. Changes:
  310.  
  311. - can now compiled to 32-bit version too (with emx+gcc 0.8e)
  312. - more cursor keys supported
  313. - uses GNU glibc crypt (ufc) routine now for encoded mail and
  314.   this does now really work to/from Unix systems!
  315. - correct README.OS2 on rmail searching method
  316. - fix some path names to use / and some to use \ depending on
  317.   what they are used for
  318.  
  319. -----------------------------------------------------------------------
  320.  
  321. Bug fix release 6,
  322. Nov 06 1993
  323.  
  324. Changes:
  325.  
  326. - only compilation with emx+gcc (currently 0.8g) is really tested/supported,
  327.   but compilation with MS C 6.00A may still work
  328. - included executables are 32-bit and require emx runtime DLL's 
  329.   (which are included too)
  330. - updates to text above in README.OS2
  331. - fixed bug where Elm added CR/LF's incorrectly in long To: and Cc: etc.
  332.   lines instead of adding only LF's
  333. - fixed incompatibility with UUPC/rmail, which can only handle one
  334.   address per To:, Cc: and Bcc: line (needs continuation lines)
  335. - fixed incompatibility with RFC822 in In-Reply-To: fields (from Frank Behrens)
  336. - fixed incompatibility with RFC822 in Date: fields for non-US time zones,
  337.   always use numeric time zone specifications now 
  338. - fixed bug with timeout for new mail check (keyboard input)
  339. - fixed bug with "bounce" command
  340. - fixed bug with temp name generation in "bounce" command
  341. - fixed bug in folder type detection, case sensitivity (from Frank Behrens)
  342. - fixed bug with "forward" command, added Resent-Headers (from Frank Behrens)
  343. - support added for ReplyTo= in personal UUPC-RC-file (from Frank Behrens)
  344. - support added for FromDomain= in system UUPC-RC-file
  345. - support added for IBM TCP/IP sendmail transport instead of UUPC rmail,
  346.   see README.TCP
  347. - support added for encryption/decryption with PGP 2.3 and newer
  348.   (idea from Rodney Korte), see README.PGP
  349.  
  350. -----------------------------------------------------------------------
  351.  
  352. Bug fix release 7,
  353. Apr 22 1994
  354.  
  355. Changes:
  356.  
  357. - fixed calculation of numeric time zone on day borders
  358. - fixed path name conversion for external editor calls
  359. - fixed message separation for TCP/IP (movemail)
  360. - fixed pathname expansion for signature files
  361. - fixed Bcc: handling with UUPC (rmail)
  362. - fixed newmail to correctly move mail on every scan with TCP/IP
  363. - Elm can now start sendmail to run in the background, optionally
  364. - Filter does now have an option to explicitly specify the user, so
  365.   you can put "|filter -u user" into your forward file to get it working
  366.   correctly with UUPC.
  367. - Elm now correctly interprets the TERMCAP environment variable if
  368.   it contains the full path name to the termcap database file.
  369. - updated README.OS2 to reflect required settings in the UUPC .rc
  370.   files and differences when using TCP/IP  
  371.  
  372. -----------------------------------------------------------------------
  373.  
  374. Bug fix release 8,
  375. Apr 27 1994
  376.  
  377. Changes:
  378.  
  379. - fixed calculation of numeric time zone again, emx unsigned time_t trap
  380. - user name lookup in passwd file is now case insensitive
  381. - added ASCII formatted documentation files
  382.  
  383. -----------------------------------------------------------------------
  384.  
  385. Bug fix release 9,
  386. Jun 23 1994
  387.  
  388. Changes:
  389.  
  390. - fixed (hopefully) incoming mail transfer for TCP/IP mail transport
  391. - replaced messages.cmd /bin/sh script with a REXX script
  392.  
  393. -----------------------------------------------------------------------
  394.  
  395. Bug fix release 10,
  396. Jul 10 1994
  397.  
  398. Changes:
  399.  
  400. - fixed iritating interpretation of now obsolete UUPC Rmail= settings
  401. - made elm compatible with IBM's TCP/IP passwd file convention of using
  402.   semicolons instead of colons in path names
  403.  
  404. -----------------------------------------------------------------------
  405.  
  406. Bug fix release 11,
  407. Aug 04 1994
  408.  
  409. Changes:
  410.  
  411. - fixed (finally!) incoming mail transfer for TCP/IP mail transport
  412.  
  413. -----------------------------------------------------------------------
  414.  
  415. Bug fix release 12,
  416. Aug 16 1994
  417.  
  418. Changes:
  419.  
  420. - corrected root and doc Makefile
  421. - fixed mailbox file inheritance problem with TCP/IP mail transport
  422. - fixed host/domain name recognition
  423. - removed rest of debug information from executables
  424.  
  425. -----------------------------------------------------------------------
  426.  
  427. Bug fix release 14,
  428. Feb 3 1995
  429.  
  430. Changes:
  431.  
  432. - added 'S' command to save by recipient name instead of sender name
  433.   like 's' (this is not perfect yet, may guess the wrong name sometimes)
  434. - fixed PGP decryption for PGP 2.6 and above (use it's -o option)
  435. - added a user's (Scott Drumm, sdrumm@rocket.cc.umr.edu) description
  436.   about how to set up Elm with POP3 mail
  437.  
  438. -----------------------------------------------------------------------
  439.  
  440. Bug fix release 15,
  441. May 04 1995
  442.  
  443. Changes:
  444.  
  445. - internal pager now display 8-bit characters
  446. - enabled runtime debugging options
  447. - make mailer configurable via rmail= setting in the .rc files 
  448.   (but "sendmail" still selects TCP/IP while anything else is treated
  449.    like being UUPC "rmail" in terms of command line syntax)
  450. - let PGP decryption prompt appear on the correct line
  451. - let it correctly handle extremely long "From " lines such as
  452.   ones in saved news articles in mailbox format
  453.  
  454. -----------------------------------------------------------------------
  455.  
  456. Release 16b,
  457. August 10 1995
  458.  
  459. Changes:
  460.  
  461. - renamed PGP-encryption directive from [pgp] to [pgp-encrypt]
  462. - added signature-only directive for pgp: [pgp-sign]
  463. - added checking of signature-only (not encrypted) messages
  464. - updated README.PGP documentation for PGP support
  465. - fixed "execute" rules for filter.exe
  466. - fixed typo that caused [pgp-encrypt] to try to encrypt for a
  467.   key id of "encrypt"
  468.  
  469. -----------------------------------------------------------------------
  470.  
  471. Bug fix release 17,
  472. Mar 09 1996
  473.  
  474. Changes:
  475.  
  476. - made Elm call sendmail with less arguments but -t instead
  477. - again correct time zone calculation error
  478.  
  479. -----------------------------------------------------------------------
  480.  
  481. Bug fix release 18,
  482. Oct 13 1996
  483.  
  484. - added logging option to sendmail wrapper sndmail.exe
  485. - added sendmail delivery agent rcvmail.exe, changed TCP/IP operation
  486.   accordingly, see README.TCP (it even supports ~/forward files)
  487. - fixed bouncing via sendmail (remove "From ")
  488. - added return key recognition from modified less external
  489.   pager for better integration (see lesselm.rc), from Kurt Swanson
  490. - fixed "From " line parsing for those with appended "remote from foobar"
  491. - fixed some screen output flushing bugs
  492. - Reply-To: field in send message header config menu now also
  493.   has automatic alias expansion
  494. - include sample sndmail/rcvmail REXX filters for MIME en/decoding
  495.   (sndfilt.cmd, rcvfilt.cmd)
  496.  
  497. -----------------------------------------------------------------------
  498.  
  499. Bug fix release 19,
  500. Feb 2 1997
  501.  
  502. - fixed rcvmail and the sndfilt.cmd/rcvfilt.cmd filters
  503. - added rmailm.cmd filter for MIME and rmail transport
  504.   (to be used via "Rmail=rmailm" in UUPC's system .RC file)
  505.  
  506. This is likely to be the last release of Elm 2.3 for OS/2. I have no
  507. idea if I will ever find time to port Elm 2.4 nor if it is worth doing
  508. that or if I will switch to Emacs, Notes or something else. Should I ever
  509. do Elm 2.4 for OS/2, it will probably only interface to sendmail as the MTA.
  510.  
  511. -----------------------------------------------------------------------
  512.  
  513. Original Elm authors:
  514.  
  515.    Dave Taylor, Syd Weinstein
  516.  
  517.    See the manual for regular mail and e-mail addresses.
  518.  
  519. Ported to OS/2 by:
  520.  
  521.    Kai Uwe Rommel
  522.    Germany
  523.  
  524.    E-Mail: rommel@ars.de, rommel@leo.org
  525.    CompuServe: 100265,2651
  526.    Fax: +49 89 324 4524
  527.