home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / ftnsoup1.zip / FTNSOUP.DOC < prev    next >
Text File  |  1995-08-26  |  8KB  |  170 lines
  1.  
  2.                                FTNSOUP v1.00
  3.  
  4.                    Internet/Fidonet Mail Packet Processor
  5.  
  6.                              (c) Adrian Walker
  7.  
  8. 8 Aug 1995
  9.  
  10.  
  11. WHAT
  12. ====
  13.  
  14.    Ftnsoup is a mail packet tosser/scanner which provides a conversion
  15.    between Internet Soup-style mail packets and Fidonet *.msg messages.  It
  16.    will toss a downloaded Internet Soup packet into a *.msg base, and will
  17.    scan out *.msg format messages into Soup packets for sending into the
  18.    Internet.
  19.  
  20.    This allows you to continue using your favourite Fidonet message editor,
  21.    provided you are using a *.msg format for the affected message areas,
  22.    but to send and receive email and newsgroups through a SLIP/PPP Internet
  23.    connection.
  24.  
  25.    Since this is only a tosser/scanner, I have to assume that you already
  26.    have:
  27.  
  28.         1.  A SLIP or PPP connection and account with a local Internet
  29.             service provider.
  30.  
  31.         2.  Trumpet Winsock or similar log-on utility to establish the
  32.             connection with your provider.
  33.  
  34.         3.  WSSoup [(c) Copyright 1995 Magnus Cameron, magnus@world.net],
  35.             or similar Soup packet mail exchanger.
  36.  
  37.         4.  This has also been tested against inbound mail from the OS/2 
  38.             Soup Mailer, Souper v1.3 - POP3 mail and NNTP news to SOUP by
  39.             Chin Huang, cthuang@io.org
  40.  
  41. WHY
  42. ===
  43.  
  44.    Why did I do this?  After getting my first SLIP account, and doing my
  45.    first exploration of the Internet, after several years doing mail with
  46.    DOS-based Fidonet message editors I found the indistinct graphical
  47.    environment of Windows-based mail and news readers to be less than
  48.    satisfactory (so maybe I should get a better monitor!).  In addition,
  49.    the proprietary formats used by these readers to store downloaded
  50.    messages prevented me from forwarding them easily to Fidonet addressees,
  51.    or even to do any editing of them.
  52.  
  53.    Since the Soup packet format [(c) 1992-1993 Rhys Weatherley,
  54.    rhys@cs.uq.oz.au] is essentially a flat ASCII file, with only 4
  55.    extended-ASCII characters at the start of each message to denote the
  56.    message size, the conversion was essentially a matter of a little string
  57.    manipulation, well within the capabilities of an amateur programmer like
  58.    myself.
  59.  
  60. HOW
  61. ===
  62.  
  63.    Put the FTNSOUP EXE and CFG files into a directory and edit the CFG file
  64.    as detailed in the sample provided.
  65.  
  66.    Make a separate sub-directory for each message base you plan to use,
  67.    i.e. one for email and one for each newsgroup, just as you would for a
  68.    Fidonet *.MSG type base.
  69.  
  70.    Insert the details of the email and newsgroup bases into the CFG file of
  71.    your favourite Fidonet message editor.  Treat the email base as you
  72.    would a netmail area, and the newsgroup bases as echoes.  Here is the
  73.    extract from my editor's area config file (Golded):
  74.  
  75.    AREA email                "Email"      FN u:\internet\msgs\email\  PVT
  76.    AREA alt.winsock          "Winsock"    FE u:\internet\msgs\winsock\
  77.    AREA alt.winsock.trumpet  "Trumpet"    FE u:\internet\msgs\wintrump\
  78.  
  79. WHEN
  80. ====
  81.  
  82.    After connecting to your provider and running WSSoup (or equivalent),
  83.    you should have mail and news Soup packets in the inbound sub-directory
  84.    which WSSoup has been told to use in the WSSOUP.INI file.
  85.  
  86.    Run "FTNSOUP TOSS" (without the quotes).
  87.  
  88.    After all the magic has been done on screen, start up your favourite
  89.    Fidonet message editor and turn to the email and news areas you set up
  90.    above.  Enjoy reading.
  91.  
  92.    So you want to reply to someone?
  93.  
  94.    For email, just enter the message in the appropriate area in your
  95.    editor, using as the "To:" name the full Internet name@address
  96.    for your correspondent (e.g.: awalker@portal.ca).  When tossing
  97.    email, Ftnsoup inserts the Internet name@address of the author, so if
  98.    you are quoting the message, the correct reply address should
  99.    automatically be inserted into the "To:" field by your FTN message
  100.    editor.
  101.  
  102.    When tossing news, Ftnsoup puts the real name of the author (if
  103.    known) into the message's "From:" field, but since there is no "To:"
  104.    field in a news message, when replying you can either put "All" into
  105.    the "To:" field or leave it as the real name of the original author,
  106.    since that field will be ignored.  The Fidonet addresses are also
  107.    ignored by Ftnsoup, so it doesn't matter what they are. The
  108.    FTNSOUP.CFG file takes care of the Fidonet address.
  109.  
  110.    After saving the message(s), exit the editor and run "FTNSOUP SCAN".
  111.    This will do more magic and scan out all new messages into Soup packets
  112.    in the outbound sub-directory.  Note that the inbound and outbound
  113.    sub-directories MUST be consistent between WSSOUP.INI and FTNSOUP.CFG if
  114.    the two programs are to work with each other.
  115.  
  116.    All sent messages are then moved automatically into a separate directory
  117.    for posted mail.  This avoids the same message being scanned out a
  118.    second time, and avoids having a duplicate when the news server at your
  119.    provider sends back the 'official copy' with your daily news.
  120.  
  121.    How big a message can you send?  Well, the 4-character extended-ASCII
  122.    field at the start of each Soup packet message allows for
  123.    256x256x256x256 bytes, which is a 4.3 gigabyte message.  If you really
  124.    think I am going to bother coding the calculation to allow for that,
  125.    you'll have to think again!  <grin>  I have allowed for a 16.7 megabyte
  126.    message (still WAY more than anyone should write to their Mother), which
  127.    means that the first character of the 4-character string will always be
  128.    a null.  Don't worry - it does this all by itself!
  129.  
  130. ADDED BENIFITS    (this section documentation by Ervin Jay 1:153/767
  131. ==============                                   ejay@direct.ca)
  132.  
  133.    For those running Fidonet Systems.
  134.  
  135.    FTNSoup can be used to process Newsgroups and Email to/from your BBS 
  136.    bases.   Because your users will not have a valid internet address 
  137.    for replies sent via your Internet provider, FTNSoup has been written
  138.    to handle them a wee bit differently from your own messages.
  139.  
  140.    FTNSoup will, upon encountering a message in a newgroup from a user
  141.    on your BBS, scan the message into the outbound Soup Replies file
  142.    using your Fidonet address to create a valid reply address in the
  143.    form user.name@fxxx.nxxx.zx.fidonet.org, where fxxx is your node
  144.    number, nxxx is your net number and zxxx is your zone number.  In
  145.    this manner people in the newsgroup can send a private email reply
  146.    to the user should they wish.
  147.  
  148.    You can also set up two configuration files, one for your mail and 
  149.    one for your BBS mail, passing the name of the cfg file as the 2nd
  150.    parameter on the command line when running FTNSoup.
  151.  
  152.  
  153. WHO
  154. ===
  155.  
  156.    If you have any questions or note any bugs, please feel free to contact
  157.    me.  I take no responsibility for what this software does to you, your
  158.    computer, your family, your work, your enjoyment of life, or anything
  159.    else.  Use it at your own risk. After all, so do I!  Here's how to
  160.    contact me:
  161.  
  162.       ...............................................................
  163.           Internet: awalker@portal.ca         Adrian Walker
  164.           Fidonet:  1:153/752.0               Vancouver BC Canada
  165.       ...............................................................
  166.  
  167.    Have fun!
  168.  
  169.                               ---ooo000ooo---
  170.