home *** CD-ROM | disk | FTP | other *** search
/ BBS 1 / BBS#1.iso / maximus / blqwk130.arj / BLUEQWK.DOC < prev    next >
Encoding:
Text File  |  1993-07-01  |  7.9 KB  |  165 lines
  1.  
  2.                                 BlueQWK 1.30 (25-June-1993)
  3.                             Copyright (C) 1992,93 Geoffrey Sy
  4.                                    All Rights Reserved
  5.  
  6.  
  7.                                  BlueQWK is supported by:
  8.  
  9.               Residence:                           Support BBS:
  10.  
  11.                Geoffrey Sy                          Toronto Twilight Comm.
  12.                14 Blevins Pl #1322                  1-416-733-9012
  13.                Toronto, Ontario  Canada
  14.                M5A 3M5
  15.  
  16.               ═════════════════════════════════════════════════════════════
  17.               BlueQWK converts  BlueWave mail packets to a  format readable
  18.               by QWK mail readers.  The QWK reader I'm using is SparkWare's
  19.               1stReader v1.11.
  20.  
  21.               INSTALLATION for 1stReader (as well as other readers):
  22.  
  23.                   1.  Copy all files included in this archive into your
  24.                       1stReader directory.  Make sure not to overwrite any
  25.                       file(s) you may already have.
  26.  
  27.               OPERATION:
  28.  
  29.                   1.  This version of BlueQWK needs more memory than older
  30.                       versions, so you might need to enable 1stReader's
  31.                       SuperShell to free up some memory before executing
  32.                       BlueQWK.  To enable SuperShell, add the /SS option to
  33.                       the $$INTRO.DOS file.
  34.  
  35.                   2.  When you start 1stReader, append the switch /QWK:* to
  36.                       the 1stReader command line.
  37.  
  38.               That's  all there's  to it.   You can now  read BlueWave mail
  39.               packets with your QWK reader.
  40.  
  41.               The reply packet for uploading to the BlueWave door still
  42.               have the .REP extension.  1st Reader doesn't have any hooks
  43.               to take care of this.  The 1st Reader /REP: NEW switch won't
  44.               work in this case unless you want all your reply packets to
  45.               have the .NEW extension.  This isn't a problem because the
  46.               replies packet is automatically renamed to <BBS_ID>.NEW when
  47.               the door received it.
  48.  
  49.               If you know about the other hooks that 1stReader provided for
  50.               BW-QWK conversion, don't use them.  They don't work properly
  51.               when writing replies without the presence of a mail packet.
  52.  
  53.               BlueQWK automatically copies BlueWave *.INF files into same
  54.               directory as itself.  This allows for conversion of replies
  55.               without the need for a BlueWave packet to be present.
  56.  
  57.               ═════════════════════════════════════════════════════════════
  58.               INSTALLATION for other readers:
  59.  
  60.                   1.  Put BLUEQWK.EXE into your 1stReader directory or
  61.                       anywhere on your DOS PATH.
  62.  
  63.                   2.  Replace the compression/decompression utilities with
  64.                       batch files.  Then do some fancy batch programming.
  65.                       The basic command line to run BlueQWK follows:
  66.  
  67.                       BLUEQWK BBS_ID conversion_method
  68.  
  69.                       - BBS_ID can be anything that contains the name of
  70.                         the QWK/REP packet.
  71.  
  72.                       - conversion_method has 3 options:
  73.  
  74.                        1. BW-QWK converts BlueWave to QWK.
  75.                        2. BW-REP converts BlueWave replies to .REP.
  76.  
  77.                           The above options should be used in the batch
  78.                           file to decompress the mail packet.  The batch
  79.                           file should check for the existence of BBS_ID.INF
  80.                           file in the QWK work directory before converting
  81.                           BW-QWK.  It should check for the existence of
  82.                           BBS_ID.INF in the BLUEQWK.EXE directory as well
  83.                           as BBS_ID.UPI in the REP work directory before
  84.                           converting BW-REP.
  85.  
  86.                        3. REP-BW converts .REPs to BlueWave for uploading
  87.                           to the BlueWave door.  This option should be used
  88.                           in the batch file that compresses replies.  The
  89.                           batch file should check for the existence of
  90.                           BBS_ID.INF in the BLUEQWK.EXE directory as well
  91.                           as BBS_ID.MSG in the REP work directory before
  92.                           converting REP-BW.
  93.  
  94.                       Refer to the batch files included in this archive for
  95.                       some examples.  The batch file $$INTRO.BAT runs after
  96.                       the mail packet has been extracted to the QWK work
  97.                       directory.  The batch file $$REPLIE.BAT runs after
  98.                       the .REP packet has been decompressed into the REP
  99.                       work directory. The $$EXIT.BAT runs before the
  100.                       replies are compressed.
  101.  
  102.                   3.  Create BLUEQWK.CFG containing the following info:
  103.  
  104.                         Line 1: Directory of QWK work directory.
  105.                         Line 2: Directory of REP work directory.
  106.  
  107.               ═════════════════════════════════════════════════════════════
  108.               REVISION HISTORY:
  109.  
  110.               25-Jun-1993 - v1.30 - I've moved recently.  Please note the
  111.                                     new address.
  112.                                   - More compatible with the BlueWave door.
  113.                                   - Added the 3rd conversion module BW-REP.
  114.                                   - Combined all 3 conversion modules into
  115.                                     a single .EXE.
  116.                                   - Command line options changed.
  117.  
  118.               25-Feb-1993 - v1.20 - Added some speed
  119.                                   - Added some junk into the .UPI file to
  120.                                     cure some BlueWave door rejecting good
  121.                                     replies as duplicates.
  122.                                   ? I still don't have a clue what some of
  123.                                     the junk in the .UPI file is.  So don't
  124.                                     expect this to be 100% compatible with
  125.                                     all BlueWave doors.  Anyone been able
  126.                                     to get the BlueWave structure from the
  127.                                     author?
  128.  
  129.               10-Feb-1993 - v1.10 - Speeded up by at least 2 times
  130.                                   - R2B converts from .REP to BlueWave
  131.  
  132.               15-Nov-1992 - v1.00 - Initial Release
  133.  
  134.               ═════════════════════════════════════════════════════════════
  135.               REGISTRATION:
  136.  
  137.               If you like the program, I'd appreciate some feedback. If you
  138.               don't like it, I'd like to know why.   I can be reach on most
  139.               echomail networks in the mailreaders or related conferences.
  140.  
  141.               ═════════════════════════════════════════════════════════════
  142.               STANDARD DISCLAIMER:
  143.  
  144.               This program is provided on an "AS IS" basis.  No warranty of
  145.               any kind is expressed or implied.
  146.  
  147.                             USE THIS PROGRAM AT YOUR OWN RISK.
  148.  
  149.               I take no responsibility for any damage caused directly or
  150.               indirectly from the use or the inability to use this program.
  151.  
  152.               ═════════════════════════════════════════════════════════════
  153.               COPYRIGHTS:
  154.  
  155.               Products mentioned  in this documentation are  Copyrighted or
  156.               Trademarks of their respective holders:
  157.  
  158.               1stReader, QWK:          Mark "Sparky" Herring of Sparkware.
  159.  
  160.               BlueWave:                George   Hatchew  of   Cutting  Edge
  161.                                        Computing.
  162.  
  163.               ═════════════════════════════════════════════════════════════
  164.  
  165.