home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / qprn103.zip / READER.DOC < prev    next >
Text File  |  1993-08-29  |  13KB  |  242 lines
  1.   QWKPRUNE can be used as a "preprocessor" for many QWK readers.  If the
  2.   reader lets you replace the name of your unpacker with a batch file, you
  3.   should be able to use QWKPRUNE in this manner.  If it doesn't, you may be
  4.   able to use PARM.EXE to call a batch file.
  5.  
  6.   Create a prune file for each BBS you want to filter messages from.  Each
  7.   prune file must be named BBSID.PRN.  The files must be located in the
  8.   same directory as QWKPRUNE.EXE, unless you set the PRUNE option in the
  9.   configuration file, or specify a directory on the line that calls
  10.   QWKPRUNE.  BBSID should be the name the board's mail door gives to QWK
  11.   packets. So if a BBS creates packets named ABC.QWK, the prune file should
  12.   be named ABC.PRN.  QWKPRUNE reads the BBSID from CONTROL.DAT, so it can
  13.   find the correct prune file even if a packet has been renamed.  If
  14.   there's no prune file for a BBS, (R) and Re: prefixes, user-defined
  15.   prefixes, and leading whitespace will still be stripped from the subject
  16.   lines of the messages.
  17.  
  18.   Extract the correct batch file from the distribution archive, place it in
  19.   the directory where your reader is located, and edit it to fit your
  20.   configuration.  If your reader isn't listed below, try using UNPACK.BAT.
  21.   Once you have the batch file working, delete the REM statements to speed
  22.   up processing.  You should also extract PARMSCAN.EXE, and place it in the
  23.   directory where your reader is located, or a directory on your DOS path.
  24.   
  25.   I've tested this with SLMR/OLX 2.x, EZ-RDR 1.37-1.39, DeLuxe 1.2x,
  26.   1stReader 1.01+, KingQWK 1.00 and 1.05, QWKMerge 1.05, Jabber 1.1+,
  27.   Session Manager 1.06, MegaMail 2.10, Power-QWK 2.14, Speed Read 1.20+,
  28.   Blue Wave 2.1x., and RoboMail 1.0.
  29.  
  30.  
  31.                                 SLMR/OLX 2.x
  32.                                    -----
  33.   Use UNPACK.BAT.  SLMR and OLX change to their work directory, so there's
  34.   no need to specify its location in the batch file. SLMR and OLX can call
  35.   batch files directly.
  36.  
  37.                               EZ-RDR 1.37-1.39
  38.                                    -----
  39.   Use UNPACK.BAT.  EZ-RDR creates a directory called WORK below the EZ-RDR
  40.   directory defined in its configuration.  It changes to this directory, so
  41.   references to the work directory can be removed from the batch file.
  42.   EZ-RDR doesn't remember what directory it changed from, so you'll have
  43.   to give a path to UNPACK.BAT when reconfiguring EZ.  EZ-RDR can call
  44.   batch files directly.
  45.  
  46.   When EZ-RDR saves your place in a QWK, it alters the .NDX files and
  47.   re-archives them, but doesn't re-archive MESSAGES.DAT.  As a matter of
  48.   fact, it appears to delete MESSAGES.DAT before inserting the bookmarks
  49.   into the QWK packet.  If you want to have EZ-RDR save your place, insert
  50.   the line "copy messages.dat messages.bak" (without quotes) into
  51.   UNPACK.BAT just below the line that runs QWKPRUNE.  You'll also need to
  52.   reconfigure EZ-RDR to use EZ-PACK.BAT to call your packer.
  53.  
  54.   Running a batch file while swapped to EMS may interfere with the display
  55.   in EZ-RDR 1.37's DOS window.  It appears that the QWK packet is still
  56.   processed correctly, you just can't follow the process.
  57.  
  58.                                 DeLuxe 1.2x
  59.                                    -----
  60.   Use UNPACK.BAT.  DeLuxe doesn't change to the Q-WORK directory, so you'll
  61.   have to specify its location in the batch file.  DeLuxe can call batch
  62.   files directly.  If you tell DeLuxe to insert a bookmark, it will
  63.   recreate the QWK, saving any changes that were made.  Note: you can
  64.   represent the Q-WORK directory as %W\Q-WORK.  If you do this, enter the
  65.   batch file name as "BAT:UNPACK.BAT" (without quotes) when reconfiguring
  66.   DeLuxe.
  67.  
  68.                                  1stReader
  69.                                    -----
  70.   Copy FIRST.BAT to the directory where 1stReader is located and rename it
  71.   $$INTRO.BAT.  If you already have an $$INTRO.BAT, insert the line
  72.   "qwkprune /m%2" (without quotes) into it.  %2 represents the the work
  73.   directory defined in 1stReader's setup.
  74.  
  75.   If the "Use Bookmark" switch in 1stReader's setup is ON, you can usually
  76.   save any changes by telling 1stReader that you want to insert a bookmark.
  77.   According to Mark Herring, 1stReader won't repack QWK packets that came
  78.   from a Qmail door with option #21 turned on.  You can also use SAVEQWK
  79.   (see ADDON.DOC) to save the changes.
  80.  
  81.   Note that, if $$INTRO.BAT exists, 1stReader automatically runs it after
  82.   the QWK is unpacked.  There's no need to change 1stReader's setup.
  83.  
  84.                                   KingQWK
  85.                                    -----
  86.   Use UNPACK.BAT.  If you're using version 1.05, and KingQWK is not
  87.   configured to swap, you can enter the name as "UNPACK.BAT" (without
  88.   quotes).  Otherwise, use COMMAND /C or PARM.  If KingQWK is configured to
  89.   swap, enter these names as COMMAND.COM /C or PARM.EXE.  KingQWK doesn't
  90.   change to its work directory when unpacking a QWK, so you'll have to
  91.   specify it in UNPACK.BAT.  Users of version 1.05 can save changes by
  92.   killing a message in KingQWK, then unkilling it. It appears that this is
  93.   enough to get KingQWK to ask if you want to delete killed messages from
  94.   the QWK packet.
  95.  
  96.   Versions of KingQWK prior to 1.05 will automatically re-archive
  97.   MESSAGES.DAT if it's been changed, even if it wasn't changed by KingQWK.
  98.   However, the changed .NDX files won't be re-archived.  You should
  99.   reconfigure KingQWK to use KQ-PACK.BAT to call your unpacker.
  100.  
  101.                                   QWKMerge
  102.                                    -----
  103.   Use QWKM.BAT.  If you're using version 1.05, and QWKMerge is not
  104.   configured to swap, you can enter the name as "QWKM.BAT" (without quotes)
  105.   Otherwise, use COMMAND /C or PARM.  If QWKMerge is configured to swap,
  106.   enter these names as COMMAND.COM /C or PARM.EXE.
  107.  
  108.   Thanks to Mike King for mentioning that version 1.05 of KingQWK and
  109.   QWKMerge can call batch files directly under some conditions.
  110.  
  111.   The configuration programs for KingQWK and QWKMerge don't allow the
  112.   command lines for packers and unpackers to be very long.  You may want to
  113.   give the batch files shorter names.  If you use PARM, you should be able
  114.   to fit the command lines for most unpackers into the allotted space, though
  115.   you may need to give PARM.EXE a shorter name.  If you can't fit the name
  116.   of an unpacker into the available space, make a copy of the batch file,
  117.   and place the name of the unpacker, along with any needed switches in
  118.   front of the "%1 %2 %3 %4 %5 %6 %7 %8 %9" line.
  119.  
  120.   Note: On some systems, KingQWK and QWKmerge may lock up when swapping in
  121.   from EMS.  Swapping to disk or XMS works OK.  This doesn't appear to be
  122.   related to QWKPRUNE.  At least, it happens whether or not QWKPRUNE is
  123.   being run while KingQWK or QWKMerge is swapped.
  124.  
  125.   If you have this problem, turn swapping off and try using a third-party
  126.   swapper.  I've gotten SHROOM to work with the "-t *" switch provided that
  127.   packers and unpackers are entered without extensions.  I've also had
  128.   success using SWAPDOS to swap to EMS.
  129.  
  130.                                 Jabber 1.1+
  131.                                    -----
  132.   Use UNPACK.BAT.  When editing the unpacking commands in Jabber's
  133.   configuration file, enter the name as "UNPACK.BAT" (without quotes).
  134.   Note that the .BAT extension must be given, or Jabber won't know that
  135.   it's to call a batch file.   Thanks to John Erickson for pointing this
  136.   out.  (According to Lawrence Johnstone, 4DOS users may use the .BTM
  137.   extension.  Thanks, Lawrence.)
  138.  
  139.   Also, the command lines for unpackers must not contain slashes or
  140.   backslashes.  It appears that confuses Jabber, and causes the parameters
  141.   to be passed incorrectly.
  142.  
  143.   Jabber changes to its work directory when unpacking a QWK, so references
  144.   to the work directory can be removed from UNPACK.BAT.
  145.  
  146.                             Session Manager 1.06
  147.                                    -----
  148.   Use SMAN.BAT.  Session Manager can call batch files directly.  Its basic
  149.   configuration routines don't accept parameters for the programs it runs
  150.   to pack and unpack QWK files.  If you have SMQINST, you can use it to
  151.   edit the Decompression program filespec.  Place the full filespec for
  152.   SMAN.BAT, including path and extension, in front of the contents of that
  153.   field.  Thanks to Dennis McCunney for telling me that SMQINST allows
  154.   Session Manager to pass parameters to an unarchiving program.
  155.  
  156.   If you tell Session Manager to save the current session, it repacks the
  157.   .NDX files and MESSAGES.DAT, so you can save the changes.  If an entire
  158.   conference is pruned out, and you didn't delete the QWK after unpacking
  159.   it, the old .NDX for that conference will be kept.  While that conference
  160.   will be garbled, the rest of the packet should still be readable.  Still,
  161.   I suggest manually deleting the QWK file if you plan to save the session
  162.   and think all messages in a conference were pruned out.
  163.  
  164.                                MegaMail 2.10
  165.                                    -----
  166.   Use MEGA.BAT.  The MegaMail reader can't use a batch file to call an
  167.   unpacker, nor can it pass parameters to an executable file.  However, its
  168.   /nozip and /import switches will let you import messages from a packet
  169.   that's been unpacked.  To import all packets in your download directory,
  170.   create a batch file containing this line:
  171.  
  172.   for %%f in ([down_dir]\.qw*) do call mega %%f
  173.  
  174.   Replace [down_dir] with the full path of the directory your QWK packets
  175.   are stored in, and remove all occurrences of [down_dir] from MEGA.BAT.
  176.   Note: call wasn't present in DOS versions earlier than 3.3.  Users of
  177.   these versions use COMMAND /C instead.
  178.  
  179.                                Power-QWK 2.14
  180.                                    -----
  181.   Use PARM.EXE and UNPACK.BAT.  In Power-QWK's configuration, put
  182.   "PARM.EXE ..\UNPACK" (without quotes) in front of the name of your
  183.   unpacker.  Power-QWK's configuration program will locate PARM.EXE, and
  184.   expand the filename to include the full path.
  185.  
  186.   When unpacking a QWK, Power-QWK creates its work directory under the
  187.   program directory and changes to it.  While you don't need to include the
  188.   work directory in UNPACK.BAT, you do need to say where UNPACK.BAT is when
  189.   reconfiguring Power-QWK.
  190.  
  191.                               Speed Read 1.20+
  192.                                    -----
  193.   Use UNPACK.BAT.  Speed can't call batch files directly, use COMMAND /C or
  194.   PARM.  Speed Read changes to its work directory, so there's no need to
  195.   refer to the work directory in UNPACK.BAT.  You do have to tell Speed
  196.   Read where UNPACK.BAT is.  Be sure to keep the "if exist messages.dat"
  197.   line, as Speed Read calls unpackers at other times than when it unpacks
  198.   QWKs.
  199.  
  200.   Note: On some systems, Speed Read may lock up when swapping in from EMS.
  201.   Swapping to disk or XMS works OK.  This doesn't appear to be related to
  202.   QWKPRUNE.  At least, it happens whether or not QWKPRUNE is being run
  203.   while Speed Read is swapped.
  204.  
  205.   If you have this problem, turn swapping off and try using a third-party
  206.   swapper.  SHROOM appears to work well.  If you're using Speed Read 1.30
  207.   or above, change to the other swap code.  (SWAP to SPAWNO, or vice
  208.   versa.)
  209.  
  210.                                Blue Wave 2.1x
  211.   Use UNPACK.BAT.  When editing the unpacking commands in Blue Wave's
  212.   configuration, enter the name as "UNPACK.BAT" (without quotes).  Note
  213.   that the .BAT extension must be given, or Blue Wave won't know that it's
  214.   to call a batch file.  Blue Wave doesn't change to its work directory, so
  215.   you'll have to specify it in UNPACK.BAT.  Be sure to keep the
  216.   "if exist [work_dir]\messages.dat" line, as it should keep QWKPRUNE from
  217.   being run if a Blue Wave packet is being unpacked.  You may want to check
  218.   for .NDX files instead.
  219.  
  220.                                   RoboMail
  221.                                    -----
  222.   Use UNPACK.BAT.  RoboMail doesn't change to its work directory, so you'll
  223.   have to specify it in UNPACK.BAT.  By default, RoboMail configures itself
  224.   to use a directory called T_E_M_P, and locates it under the directory
  225.   RoboMail is located in.  RoboMail can call batch files directly.
  226.  
  227.  
  228.                                    -----
  229.   Some readers have substitution variables that can be used in function key
  230.   definitions or menu entries.  If your reader is one of these, you can use
  231.   them to add entries to a prune file from within the reader.  The output
  232.   can be generated either by DOS's ECHO command and output redirection, or
  233.   by MKPRN.EXE (see ADDON.DOC).  For example, a function key in SLMR could
  234.   be configured as: NOSWAP:echo @CONFNUM@,F:@FROM@ >> e:\@BBSID@.prn.
  235.  
  236.   Redirection is slightly faster than MKPRN, but doesn't work right if
  237.   the text being echoed contains the DOS redirection or pipe characters
  238.   <, >, and |.
  239.  
  240.   When setting up such commands, you should give a path to the prune file,
  241.   so as to say where you want it to be.
  242.