home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BLUEQ155.ZIP / BLUEQWK.DOC < prev    next >
Text File  |  1994-12-11  |  18KB  |  376 lines
  1.  
  2.           BlueQWK 1.55 - BLUEQ155.ZIP - 11-December-1994
  3.           Copyright (C) 1992-94 Simple Solutions Software,
  4.           All Rights Reserved.
  5.  
  6.           Residence:   Geoffrey Sy
  7.                        1322-14 Blevins Place
  8.                        Toronto ON  M5A 3M5
  9.                        Canada
  10.  
  11.           FidoNet:     1:250/814, 1:250/710
  12.  
  13.           InterNet:    sy@sshq.tor250.org
  14.                        rn.4261@rose.com
  15.                        ae873@torfree.net
  16.  
  17.           Support BBS: CAP/CANADA (416) 287-0935 v.32bis/v.FC
  18.                                   (416) 287-0234 v.Everything
  19.                        CAP/USA    (708) 854-0255 v.32bis/v.FC
  20.                          Conference: CL_SimpleSoln #4
  21.  
  22.           Latest versions of most QWK utilities, including BlueQWK, can
  23.           be found on The Lunatic Fringe BBS 214-235-5288 (1:124/2113).
  24.  
  25.           ═════════════════════════════════════════════════════════════
  26.           BlueQWK converts  BlueWave mail packets  to a format readable
  27.           by QWK mail readers.  It is designed to interface seamlessly
  28.           with most DOS-based QWK off-line mail readers.
  29.  
  30.           INSTALLATION for 1stReader (as well as other OLMRs):
  31.  
  32.               1.  Copy BLUEQWK.EXE into your 1stReader directory.  If
  33.                   using 1stReader v1.10, unZIP 1ST11.RDR into your
  34.                   1stReader directory.  If using 1stReader v2.0 unZIP
  35.                   1ST20.RDR into your 1stReader directory.
  36.  
  37.           OPERATION:
  38.  
  39.               1.  This version of BlueQWK needs more memory than older
  40.                   versions, so you might need to enable 1stReader's
  41.                   SuperShell to free up some memory before executing
  42.                   BlueQWK.
  43.  
  44.               2.  When you start 1stReader, append the switch /QWK:* to
  45.                   the 1stReader command line.  This switch can also go
  46.                   into your SWITCHES.1ST file.
  47.  
  48.           BlueQWK automatically copies BlueWave *.INF files into same
  49.           directory as itself.  This allows for conversion of replies
  50.           without the need for a BlueWave packet to be present.
  51.  
  52.           The reply packet for uploading to the BlueWave door still
  53.           have the .REP extension.  1st Reader doesn't have any hooks
  54.           to take care of this.  The 1st Reader /REP: NEW switch won't
  55.           work in this case unless you want all your reply packets to
  56.           have the .NEW extension.  This isn't a problem because the
  57.           replies packet is automatically renamed to <BBS_ID>.NEW when
  58.           the Bluewave door received it.
  59.  
  60.           There is an internal hook that 1stReader provide for BW-QWK
  61.           conversion.  It does not work when writing replies without
  62.           the presence of a mail packet.  This hook causes DOS to issue
  63.           'Bad command or file name' when reading Bluewave packets.  If
  64.           this DOS error annoys you, download DLXTEXT.EXE or QMTEXT.EXE
  65.           from Sparky to edit your 1STTEXT file.  Place the word REM in
  66.           front of records #297, 298, and 299 in 1STTEXT to fix this.
  67.  
  68.           ═════════════════════════════════════════════════════════════
  69.           INSTALLATION for other readers:
  70.  
  71.               1.  Put BLUEQWK.EXE into your reader directory or
  72.                   anywhere on your DOS PATH.
  73.  
  74.               2.  Replace the compression/decompression utilities with
  75.                   batch files.  Then do some simple batch programming.
  76.  
  77.                   Included in this package are several files with the
  78.                   .RDR extension.  These are .ZIP files containing
  79.                   sample .CFG and .BAT files for use with other mail
  80.                   readers.  They also contain configuration files for
  81.                   the mail reader, so becareful not to overwrite your
  82.                   mail reader's configuration files.  These files are:
  83.  
  84.                   DLX12.RDR - For use with Sparkware's Deluxe² v1.2x
  85.                               and probably older versions as well.
  86.                   OLX22.RDR - For use with OLX v2.2.  Will probably
  87.                               work with SLMR and earlier OLX versions
  88.                   OLX30.RDR - For use with OLX v3.1.52.  May work with
  89.                               prior release of OLX v3.xx
  90.                   SR140.RDR - For use with Speed Read v1.40.  May work
  91.                               with earlier and later versions.
  92.                   RM130.RDR - For use with RoboMail v1.30.  May work
  93.                               with earlier and later versions.
  94.  
  95.                   Unzip the appropriate .RDR into the same directory as
  96.                   BLUEQWK.EXE.  Then configure your reader to call the
  97.                   appropriate PACKER/UNPACKER .BATch file. Please refer
  98.                   to the README.TXT file inside the .RDR files for more
  99.                   information.
  100.  
  101.               3.  You may need to change the extension of the BW mail
  102.                   packets to *.QWK inorder for your mail reader to find
  103.                   the mail packets.
  104.  
  105.               If the above steps don't work for your OLMR, these
  106.               information may help:
  107.  
  108.                   The basic command line to run BlueQWK follows:
  109.  
  110.                   BLUEQWK BBS_ID conversion_method
  111.  
  112.                   - BBS_ID can be anything that contains the name of
  113.                     the QWK/REP packet.  This may include the mail
  114.                     packet name as passed by your mail reader to the
  115.                     compression/decompression utilities.  If the BBS_ID
  116.                     is not known, use an asterisk '*' to let BlueQWK
  117.                     find/guess the BBS_ID.
  118.  
  119.                   - conversion_method has 3 options:
  120.  
  121.                    1. BW-QWK converts BlueWave mail packet to QWK for
  122.                       reading with your QWK reader.
  123.                    2. BW-REP converts BlueWave replies to .REP for
  124.                       re-editing them with your QWK reader.
  125.                    3. REP-BW converts .REP to BlueWave for uploading
  126.                       to the BlueWave door
  127.  
  128.                   The BLUEQWK.CFG needs the following info:
  129.  
  130.                     Line 1: Directory of QWK work directory.  This is
  131.                             where your mail reader decompress the mail
  132.                             packet to. Most readers will change to this
  133.                             directory before opening the mail packet,
  134.                             so a ".\" (without the quotes) will work in
  135.                             most cases.
  136.  
  137.                     Line 2: Directory of REP work directory.  This is
  138.                             where BlueQWK expects to find the reply
  139.                             file created by your mail reader.  BlueQWK
  140.                             uses this directory to store the converted
  141.                             Bluewave replies.  Most readers don't use a
  142.                             separate directory for this purpose.  In
  143.                             such case, create a work directory and copy
  144.                             the reply file into it.  Please refer to
  145.                             OLX22.RDR for the solution to this problem.
  146.  
  147.                     Line 3: Optional switches for BlueQWK.  Currently
  148.                             these switches are supported:
  149.  
  150.                             /Quiet
  151.                                Tells BlueQWK not to list the header of
  152.                                messages it processed.
  153.  
  154.                             /NoNDX
  155.                                Tells BlueQWK not to create the QWK
  156.                                index (*.NDX) files.
  157.  
  158.                             /1stBM
  159.                                 Fix a problem with 1stReader v2's "new"
  160.                                 book-mark scheme.  If BlueQWK finds
  161.                                 BOOKMARK.DAT in the QWK work directory,
  162.                                 it will not attempt to convert the BW
  163.                                 mail packet.  This new book-mark scheme
  164.                                 is unquestionably the worst function
  165.                                 found in 1stReader.
  166.  
  167.                             /NoERR
  168.                                 Suppress error messages such as "No
  169.                                 Replies found" or "No BW mail packet
  170.                                 found".
  171.  
  172.           ═════════════════════════════════════════════════════════════
  173.           That's  all there's  to it.   You can now  read BlueWave mail
  174.           packets with your favorite QWK reader.
  175.  
  176.           I like to think this document short, complete and helpful.
  177.           If you have problems with the program, please do not hesitate
  178.           to contact me.
  179.  
  180.           ═════════════════════════════════════════════════════════════
  181.           MAILER READER INTERFACE FOR BLUEQWK: For QWK reader authors:
  182.  
  183.           These simple additions to any mail reader would be helpful
  184.           for third party programs to interface with the mail reader.
  185.  
  186.           To interface with BlueQWK, the mail reader should provide the
  187.           ability to run 3 .BAT files and pass 3 parameters to BlueQWK.
  188.  
  189.           The .BAT files:
  190.  
  191.              1. POSTQWK.BAT - Run after the reader decompress the .QWK
  192.                               packet.
  193.  
  194.              2. POSTREP.BAT - Run after the reader decompress the .REP
  195.                               packet.
  196.  
  197.              3. PREREP.BAT  - Run before the reader compress the .MSG
  198.                               into a .REP file.
  199.  
  200.           These .BAT files can be any name, as long as they are known
  201.           to the users of the mail reader (ie: documented).
  202.  
  203.           The Parameters:
  204.  
  205.              1. QWK work path - Path to the directory where the QWK
  206.                                 packet was decompressed to.
  207.  
  208.              2. REP work path - The directory where the <BBS_ID>.MSG is
  209.                                 stored.
  210.  
  211.              3. The <BBS_ID>  - The name of the QWK file.  This is not
  212.                                 necessary, but can reduce error if
  213.                                 BlueQWK doesn't have to guess.
  214.  
  215.           Optional:
  216.  
  217.           Make the reader recognize the Bluewave naming format.  The
  218.           current naming convention for Bluewave format folows:
  219.  
  220.            <BBS_ID>.DA#  - DA is the first 2 letter of the day followed
  221.                            by a number 0 to 9.  Thus the first mail
  222.                            packet downloaded on Monday would have .MO0
  223.                            as the file extension.
  224.  
  225.            <BBS_ID>.###  - This newer naming convention gives the file
  226.                            extension any number between 000 to 999.
  227.  
  228.            <BBS_ID>.NEW  - The Bluewave reply packet should have .NEW
  229.                            as the file extension.
  230.  
  231.           ═════════════════════════════════════════════════════════════
  232.           REVISION HISTORY:
  233.  
  234.           11-Dec-1994 - v1.55 - The previous update caused BlueQWK to
  235.                                 load the .INF file to the wrong memory
  236.                                 address under certain conditions.  This
  237.                                 can cause the computer to lock-up.
  238.  
  239.                               - Run time errors are now logged to
  240.                                 ERRORLOG.GS.
  241.  
  242.           09-Dec-1994 - v1.54 - Increased memory requirement to process
  243.                                 large .INF files.
  244.  
  245.                               - Instead of exiting quietly, error
  246.                                 messages are now displayed.
  247.  
  248.                               - Added /NoERR to suppress display of
  249.                                 error messages.
  250.  
  251.           15-Sep-1994 - v1.53 - Added the ability to convert the .INF
  252.                                 to a CONTROL.DAT with-out the need for
  253.                                 the rest of the mail packet.  Needed
  254.                                 for SPEED Read.
  255.  
  256.                               - Brought back the asterisk '*'.  If the
  257.                                 mail packet is not known, use the the
  258.                                 asterisk in place of the BBS_ID and
  259.                                 BlueQWK will automatically locate the
  260.                                 BBS_ID.
  261.  
  262.                               - Added configurations for SPEED READ and
  263.                                 RoboMail.
  264.  
  265.           12-Aug-1994 - v1.52 - Updated to comply with the official
  266.                                 Bluewave specification.
  267.  
  268.                               - Included sample configuration files for
  269.                                 other mail readers.
  270.  
  271.                               - Added options /Quiet, /NoNDX, /1stBM
  272.  
  273.           28-Feb-1994 - v1.51 - Updated contact information.
  274.  
  275.           10-Nov-1993 - v1.50 - Updated for compatibility with other
  276.                                 versions of the Bluewave door. Previous
  277.                                 versions of BlueQWK only worked with
  278.                                 Remote Access and QuickBBS versions of
  279.                                 the Bluewave door.
  280.  
  281.                               - Beginning with this version, BlueQWK is
  282.                                 now Shareware.  Please register if you
  283.                                 it regularly.
  284.  
  285.           19-Jul-1993 - v1.31 - Minor cosmetic to the R2B module.  If
  286.                                 you can read fast enough, you'll see
  287.                                 the messages being converted.
  288.  
  289.           25-Jun-1993 - v1.30 - I've moved recently.  Please note the
  290.                                 new address.
  291.                               - More compatible with the BlueWave door.
  292.                               - Added the 3rd conversion module BW-REP.
  293.                               - Combined all 3 conversion modules into
  294.                                 a single .EXE.
  295.                               - Command line options changed.
  296.  
  297.           25-Feb-1993 - v1.20 - Added some speed
  298.                               - Added some junk into the .UPI file to
  299.                                 cure some BlueWave door rejecting good
  300.                                 replies as duplicates.
  301.                               ? I still don't have a clue what some of
  302.                                 the junk in the .UPI file is.  So don't
  303.                                 expect this to be 100% compatible with
  304.                                 all BlueWave doors.  Anyone been able
  305.                                 to get the BlueWave structure from the
  306.                                 author?
  307.  
  308.           10-Feb-1993 - v1.10 - Speeded up by at least 2 times
  309.                               - R2B converts from .REP to BlueWave
  310.  
  311.           15-Nov-1992 - v1.00 - Initial Release
  312.  
  313.           ═════════════════════════════════════════════════════════════
  314.           REGISTRATION:
  315.  
  316.           If you have questions,  bugs, comments or suggestions, please
  317.           contact me. I may be reached on the 1stReader, Qmail, OffLine
  318.           conferences on Intelec (tm),  and ILink (tm), the Offline and
  319.           other conferences on FidoNet(tm).  I can also be reach  on my
  320.           support BBSes or by  mail to the above  address.  Registered
  321.           users of my other Shareware packages may contact me using the
  322.           voice number in the registration document.
  323.  
  324.           Since BlueQWK  is user supported software, I don't expect you
  325.           to register if you don't like it or if it doesn't meet your
  326.           needs.  Just stop  using it after a reasonable  trial period.
  327.           BlueQWK is not crippled in any way, but some minor annoyance
  328.           features may be active in unregistered mode.
  329.  
  330.           BlueQWK  is an  on-going  project, it  will  be enhanced  and
  331.           updated as long as I can financially afford to do so.  If you
  332.           like the program  and use it  regularly, please register  it.
  333.           The registration cost is a one-time  fee of $5.00.  With the
  334.           registration  you'll  receive  unlimited  voice  support  and
  335.           upgrades.   Your registration encourages further development,
  336.           enhancements and my continued support of the product.  Please
  337.           send your registration in the form of a Money Order, Personal
  338.           cheque, or Cashier's cheque to the above address.
  339.  
  340.           ═════════════════════════════════════════════════════════════
  341.           STANDARD DISCLAIMER:
  342.  
  343.           This program is provided on an "AS IS" basis.  No warranty of
  344.           any kind is expressed  or implied.  I take  no responsibility
  345.           for  any damage caused directly or indirectly from the use or
  346.           the  inability to  use this  program.   Only features  in the
  347.           current .EXE, including bugs, critters and anything else that
  348.           might be pressent, are available to the users.  Users are not
  349.           to expect future upgrades or additional features. The program
  350.           will not  change to suit the needs of the users if such needs
  351.           change  in  the  future.   By  using  this  program the  user
  352.           automatically accepts these terms and conditions.
  353.  
  354.           ═════════════════════════════════════════════════════════════
  355.           COPYRIGHTS:
  356.  
  357.           Products mentioned  in this documentation are  Copyrighted or
  358.           Trademarks of their respective holders:
  359.  
  360.           1stReader, Deluxe:       Mark "Sparky" Herring of Sparkware.
  361.                                    The original creator of the popular
  362.                                    QWK mail standard.
  363.  
  364.           BlueWave:                George   Hatchew  of   Cutting  Edge
  365.                                    Computing.  The original creator of
  366.                                    the BlueWave format.
  367.  
  368.           OLX:                     Mustang Software Inc.
  369.  
  370.           SPEED READ:              Jim Smith.
  371.  
  372.           RoboMail:                Parson Consulting.
  373.  
  374.           ═════════════════════════════════════════════════════════════
  375.  
  376.