home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TMAIL116.ZIP / README < prev    next >
Text File  |  1992-12-11  |  6KB  |  126 lines
  1.                            TMail release notes
  2.                              (version 1.15)
  3.  
  4.    TMail is a mail/news shell for use on 80x86-based personal computers 
  5.    running DOS or something like it.  Sorry, no Mac or Unix versions 
  6.    exist.  TMail also won't run on 8088 or 8086-based machines, and 
  7.    frankly if you're still using one you have far worse problems.
  8.  
  9.    If you are already using UUPC's mail or PCElm, you can start TMail 
  10.    right up.  All three mailers are interchangeable, although TMail
  11.    will handle much larger mailboxes than the UUPC mail program.  Just 
  12.    load the TMail.EXE and TMail.OVR files somewhere on your path and
  13.    type TMAIL.  Alternatly, 'TMAIL filespec' will use 'filespec' as
  14.    your configuration file (section 3, 'Quickstart', below).  TMAIL
  15.    supports a default incoming mailbox, a default incoming news file,
  16.    and separate default archives for news and mail.
  17.  
  18. 1) Help:
  19.    TMail supports an online help facility.  This first cut is a 
  20.    long, long way from what it should be but I'll be working on it.  
  21.    Your feedback will be greatly appreciated since I know the program
  22.    too well to tell.  TMail.HLP should be loaded in the same
  23.    directory as the TMail.EXE and TMail.OVR files.
  24.  
  25. 2) Documentation:
  26.    Nada.  Any volunteers?
  27.  
  28. 3) Quickstart:
  29.    Hey, folks!  This program is menu-driven using a mouse.  What you DO
  30.    need is an AT clone (8088 need not apply) running DOS version 3.0
  31.    or later.  Actually, 2.x will mostly work, but why bother?  TMail 
  32.    needs about 256K of free RAM to run, which shouldn't be a big
  33.    problem on real machines.  TMail gets along with Windows just fine,
  34.    thanks.
  35.  
  36.    Although I use UUPC, TMail should work with just about any 
  37.    connectivity software.  The only shared data dependency is in the
  38.    UNIX-style mailbox format (ctl-A line message separators) for
  39.    incoming news and mail.  Outgoing news and mail are passed to 
  40.    external utilities such as RMAIL and PostNews.  (Since UUPC
  41.    doesn't come with a PostNews utility, I wrote one.)
  42.  
  43.    TMail maintains all of its configuration data in a configuration
  44.    file (not supplied).  If you don't specify a configuration file on 
  45.    the command line, TMail defaults to a file in the same directory as
  46.    TMail.EXE and TMail.OVR (or whatever you renamed them to), with the
  47.    same name and an extension of '.CFG'.
  48.  
  49.    If this file does not exist, TMail defaults to a setup which is
  50.    quite useless.  Instructive, maybe, but useless.  To change the
  51.    setup select the 'Setup' menu and its submenus, then 'Save Setup'.
  52.    WARNING: some of the available color combinations would gag a 
  53.    vulture.
  54.  
  55.    TMail's online help file (TMail.HLP) must also be in the same 
  56.    directory as the TMail executable file.  TMail will run without it, 
  57.    but you'll get nasty messages instead of help if it's not found.
  58.  
  59. 4) License, bugs, and feedback:
  60.    TMail is shareware.  You are welcome (even encouraged) to try it, 
  61.    abuse it, even COMPLAIN about it, for 29 days.  If you're still using 
  62.    it after that you really should register it.  Aside from the karmic 
  63.    benefits of registration, I'll be doing my best to make it worth the 
  64.    entirely nominal registration charge.  (See file REGISTER.TXT)
  65.  
  66.    Since TMail is worthless without connectivity, I will NOT be 
  67.    distributing, supporting, or updating it except via the Internet. 
  68.    This makes the 'network address' field on your registration 
  69.    absolutely crucial, so please make sure it specifies a well-known net 
  70.    node.  Before cashing your check I'll send you the registered TMail 
  71.    package (that's a promise).
  72.  
  73.    In a moment of moral ascendency over self-interest, I decided to 
  74.    license TMail FREE to real-live charitable organizations.  If you
  75.    represent one, drop me some e-mail and I'll fill in the details.
  76.  
  77.    TMail isn't industrial-strength software -- yet.  I'm sure that there 
  78.    are bugs in it which have escaped my earnest efforts to track them 
  79.    down.  Should you discover one, please do me the courtesy of 
  80.    narrowing the circumstances enough that I have a chance of 
  81.    reproducing it and then send me a report at <dcs@witsend.tnet.com>.
  82.  
  83. 5) News support:
  84.    TMail takes a giant step backwards and treats news as a special case
  85.    of mail.  This package includes three executables and two batch files 
  86.    to support news in a UUPC environment:
  87.      getbatch.exe    - preprocesses incoming news batches for
  88.               decompression by the standard compress
  89.      putnews.exe    - processes decompressed batches into mailbox
  90.               format
  91.      extract.bat    - You may need to midify this one for your
  92.               setup; it pipes getbatch, putnews, and 
  93.               putnews, appends the output to a mailbox,and 
  94.               deletes the source batch.
  95.      getnews.bat    - barring miracles, you WILL need to alter this
  96.               one for your setup.  It applies 'extract' to
  97.               all of the incoming batches in a directory and
  98.               sends the results to a (you name it) mailbox.
  99.      postnews.exe    - sends a preformatted article file to UUCP
  100.               for transfer.  This program relies an 
  101.               environment variable (UUPCNEWS) which 
  102.               specifies the path to the news working files
  103.               POST.LOG and NSEQ.  I use
  104.               UUPCNEWS=D:\UUPC\NEWS
  105.               for instance.
  106.  
  107.    One user has observed that TMail gets pretty slow when loading more
  108.    than a megabyte of newsfile.  He's right.  If you routinely read 
  109.    through several megabytes of news in a day, use something else.  
  110.    Unless, of course, you have a few minutes for the file to load.
  111.    (You're reading MEGABYTES of news -- daily -- and are too BUSY?!?)
  112.  
  113. 6) Extensions
  114.    One user has requested a whole slew of enhancements to support 
  115.    binaries distribution groups such as comp.binaries.PC.  IMHO, too few 
  116.    users would need such extensions to justify the added complexity, 
  117.    code size, and hassle of adding them to the TMail core.  On the other 
  118.    hand, they can be implemented rather easily as add-on filters in the 
  119.    'getnews' pipeline and even do better there.  I have suggested that
  120.    he do so (probably in AWK).
  121.  
  122.    Anyone who comes up with this sort of useful addition is encouraged 
  123.    to share it with the world.  If you need help with creating 
  124.    extensions, I'll be glad to explain some of TMail's internals and in 
  125.    some instances share parts of the code.
  126.