home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / qreply22.zip / QREPLY.DOC < prev    next >
Text File  |  1993-05-15  |  23KB  |  752 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                              ╓──────────────────╖
  18.                              ║     Q-Reply      ║█
  19.                              ║   Version v2.2   ║█
  20.                              ╙──────────────────╜█
  21.                                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  22.  
  23.  
  24.                            A Quoting utility for use
  25.                            with Offline Mail Readers
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                        Copyright (c) 1993 Mark C. Stout
  46.                               All Rights Reserved
  47.  
  48.  
  49.  
  50.  
  51. Q-Reply v2.2                                                             i
  52.  
  53.  
  54.                                Table of Contents
  55.         I.  Disclaimer .....................................   1
  56.  
  57.        II.  About Q-Reply ..................................   2
  58.  
  59.       III.  Configuring Q-Reply ............................   3
  60.  
  61.         1.  Silly Little Mail Reader/Off-Line Express ......   4
  62.  
  63.         2.  Blue Wave Mail Redaer ..........................   5
  64.  
  65.         3.  MegaRead Mail Redaer ...........................   6
  66.  
  67.         4.  KingQWK Mail Redaer ............................   7
  68.  
  69.         5.  Jabber Mail Redaer .............................   8
  70.  
  71.        IV.  Using Q-Reply ..................................   9
  72.  
  73.         V.  Registering ....................................  11
  74.  
  75.       VII.  Distribution ...................................  12
  76.  
  77.      VIII.  Support Bulletin Board .........................  12
  78.  
  79.             Order Form .....................................  13
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101. Q-Reply v2.2                                                       Page  1
  102.  
  103.  
  104.  
  105.         I.  Disclaimer
  106.  
  107.             Mark C. Stout makes no warranty of any kind, express or implied
  108.             including without limitation, any warranties of merchantability
  109.             and/or fitness for a particular purpose.  Mark C. Stout  shall
  110.             not be held liable for any damages, whether direct, indirect
  111.             or consequential arising from the failure of this product to
  112.             operate in the manner desired by the user or author.
  113.  
  114.             Mark C. Stout shall not be held liable for any damage to data
  115.             and/or property which may be caused either directly or indirectly
  116.             by use of this product.
  117.  
  118.             IN NO EVENT SHALL MARK C. STOUT BE HELD LIABLE TO THE USER FOR ANY
  119.             DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR ANY OTHER
  120.             INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OF OR
  121.             INABILITY TO USE THE PROGRAM, OR FOR ANY OTHER CLAIM BY ANY OTHER PARTY.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151. Q-Reply v2.2                                                       Page  2
  152.  
  153.  
  154.  
  155.        II.  About Q-Reply
  156.  
  157.             Q-Reply came about when I started to work on a way to make the way
  158.             we quoted replies a bit more stylish.  About 3/4 of the way thru
  159.             "Quoteit v1.0" by Hiep Ma started popping up.  Obviously I wasn't
  160.             the only one working on such a concept.  If you haven't seen
  161.             "QuoteIt", it is very similar to what I have done with Q-Reply.
  162.  
  163.             Never the less, I have continued to develope Q-Reply.  It is still
  164.             in it's developement stage, however, I am releasing this beta
  165.             version so that those who would chose to utilize this quoting
  166.             utility can do so and make any suggestions and report any bugs.
  167.  
  168.             Currently, Q-Replyv2.2 supports the .QWK packet format.  Blue
  169.             Wave's mail packets were included in v1.1.  Since then, Jabber,
  170.             KingQWK and MEGAREAD have been included in the supported Mail
  171.             Readers.  I am constantly upgrading this utility to include
  172.             support for the various mail readers and at the same time trying
  173.             to write the program so that it can be used with the many mail
  174.             readers out there with very little or no modifications to the
  175.             existing code.  More features are also being implemented as they
  176.             go from ideas to reality.  If, you the user find this utility
  177.             useful to you, I wouldn't mind hearing about it.  Alot of my time
  178.             has gone into the development of the program.  If you are like me
  179.             you'll want to supoort a product that has been useful to you or
  180.             that you have come to like.  My wife thinks I married my
  181.             computer instead of her, however she has been very supportive
  182.             of my efforts and your support would help.
  183.  
  184.             That's about all there is to Q-Reply.  Nothing that needs a
  185.             whole page devoted to it.  It is pretty straight forward.
  186.  
  187.             Page breaks have been included so that you can print out this
  188.             document so that it is readable after printing.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. Q-Reply v2.2                                                       Page  3
  202.  
  203.  
  204.  
  205.       III.  Configuring and Using Q-Reply
  206.  
  207.         All mail readers will have a QR.BAT file as the Editor Name to use.
  208.         Inside the batch file you will be able to add your favorite text
  209.         editor.  A sample QR.BAT for each supported mail reader is included
  210.         with the .BAT being replaced for the mail reader.
  211.         DOS 5 is assumed, so EDIT.COM is used as the Editor Name.
  212.         Just rename the QR.??? to QR.BAT, edit your favorite text editor
  213.         and you'll be ready to roll.
  214.  
  215.         In version 2.2, the configuration file's format for Q-Reply has
  216.         changed.  Inside the configuration file are Identifiers, they
  217.         identifying the area where you will place your information. These
  218.         Identifiers are enclosed with brackets, i.e.:
  219.  
  220.             [Mail Reader Name]      <--- Identifier
  221.             Off-Line Express v2.1   <--- Your information
  222.             [Mail reader]
  223.             C:\MODEM\OLX.EXE
  224.  
  225.         These Identifiers MUST not be altered, Q-Reply looks for these
  226.         when it reads the configuration file.
  227.  
  228.         Q-Reply has a new wrap around menuing system designed to make it
  229.         easier to select the the Quoting style you want to use.  You also
  230.         have a sample menu that displays the various different quoting
  231.         styles and how they will look.
  232.  
  233.         Selecting the defaults will default to "Sgl Vert/Dbl Horiz" for
  234.         the border and "Shadow style #4 - █▀" for the shadow that is
  235.         displayed around the border.
  236.  
  237.         IMPORTANT NOTE: Inside the QREPLY.??? sample configuration file,
  238.         .??? standing for your particular .CFG file, are notes or comments
  239.         telling what to do. These notes or comments start with the
  240.         semi-colon (;).  Remove the lines starting with the semi-colon's.
  241.         This has been known to have QREPLY read the wrong lines in your
  242.         QREPLY.CFG file.
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251. Q-Reply v2.2                                                       Page  4
  252.  
  253.  
  254.  
  255.         1. Silly Little Mail Reader/Off-Line Express
  256.             Q-Reply needs just a few simple alterations to your mail
  257.             readers configuration file.  Once these changes are made, you
  258.             will be ready to quote our first reply with Q-Reply.
  259.  
  260.             First, go to the 'Editor' option in the configuration menu and
  261.             replace the editor's name with QR.BAT.  You must include the
  262.             full pathname, for example: C:\MODEM\MAIL\QR.BAT.
  263.             For example, The preferred Editor screen should look like this:
  264.  
  265.                 Reply quoting style                  ALL
  266.                 Quoting prefix string                >
  267.                 Message header in quoted reply       Yes
  268.  
  269.                 Enable taglines                      Random
  270.                 Fido-style taglines                  Yes
  271.  
  272.             Second, go to the 'Replies' option in the configuration menu and
  273.             answer 'YES' to have the header included in the original message.
  274.             For example, The preferred Replies screen should look like this:
  275.  
  276.                 Editor command line        C:\MODEM\MAIL\QR.BAT
  277.  
  278.                 Quoted original message file     ORIGINAL.MSG
  279.                 File to take reply text from     REPLY.MSG
  280.  
  281.                 Clear screen before editor       Yes
  282.  
  283.             A sample batch file is supplied.  Just modify it to fit your
  284.             needs.
  285.             The file for Silly Little Mail Reader is QR.MR
  286.             The file for Off-Line Express is QR.OLX
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301. Q-Reply v2.2                                                       Page  5
  302.  
  303.  
  304.  
  305.         2. Blue Wave Mail Reader
  306.  
  307.             There isn't much to configure for Blue Wave's mail reader.
  308.             First, go to Configuration Menu and select "Registration".
  309.             Change the "Quote Header String" to read:
  310.                Sample #1
  311.                   On @D @F wrote to @T@N
  312.                Displays:
  313.                   On  4/28/93 John Smith wrote to Sally Jones
  314.  
  315.             Other samples are:
  316.                Sample #2
  317.                   -=> On @D @F wrote to @T <=-@N
  318.                Displays:
  319.                   -=> On  4/28/93 John Smith wrote to Sally Jones <=-
  320.  
  321.                Sample #3
  322.                   -=> On @D @F Wrote To @T <=-@N
  323.                Displays:
  324.                   -=> On  4/28/93 John Smith Wrote To Sally Jones <=-
  325.  
  326.             The key here are two things:
  327.                  1) Keep the "On/on" as the first word.
  328.                  2) Keep "Wrote To/wrote to" between the @F and @T.
  329.  
  330.             These must be included for Q-Reply to be able to write out the
  331.             correct quoting line.  It looks for the words "On/on" and
  332.             "Wrote To/wrote to".
  333.  
  334.             Next go to "Directories" and replace the line:
  335.                Editor File Path to read: C:\BWAVE\QR.BAT
  336.  
  337.             Next go to "Miscellaneous", then "Enter/Reply Options" and
  338.             toggle "Insert quote header in replies" to "Yes".
  339.  
  340.             That's it.  All other changes you make to the configuration
  341.             of your Blue Wave mail reader will not affect Q-Reply.
  342.             A sample batch file is included called QR.BW, just change
  343.             the .BW to .BAT and edit the editor path to your favorite
  344.             text editor.
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351. Q-Reply v2.2                                                       Page  6
  352.  
  353.  
  354.  
  355.         3. MegaMail Reader
  356.  
  357.             There is a little more to do with the MegaMail Reader.  Select
  358.             the 'Utilities' option from the Main Menu, unless you are
  359.             installing MegaMail for the first time at which time you will
  360.             be placed in the 'Required' sub-menu, and select 'Directories'.
  361.             From there select 'External Editor Directory' and enter and
  362.             enter the MegaMail directory: ie C:\MEGAREAD <enter>.
  363.  
  364.             If this is your first time installing both the MEGAMAIL reader
  365.             and Q-Reply, then enter directories howvever you want them, then
  366.             go to the 'Directories' sub-menu and edit the 'External Editor
  367.             Directory' like the example above.
  368.  
  369.             NOTE:  Your MESSAGE.TXT and REFER.TXT files MUST be written to
  370.             the MEGAMAIL reader's sub-directory, ie C:\MEGAREAD
  371.  
  372.             Next, from the 'Configuration' sub-menu select the 'Entering
  373.             Messages' and from that sub-menu select 'Hdr in REFER.TXT' and
  374.             set it to 'Yes'.
  375.  
  376.             Next, select 'External Editor' and enter the QR.BAT file as
  377.             follows: C:\MEGAREAD\QR.BAT MESSAGE.TXT REFER.TXT.
  378.  
  379.             Be sure to include both .TXT files after the QR.BAT batch file
  380.             or your reply will not be quoted correctly.  Change the drive
  381.             and directory to whatever you have the mail reader configured to.
  382.  
  383.  
  384.            Editing QR.BAT
  385.  
  386.             There should be a sample QR.BAT file included in the QREPLY??.ZIP
  387.             file that you downloaded.  If it isn't then your mail reader may
  388.             not be supported.
  389.  
  390.             Two lines may need to be edited, unless, of course, you are using
  391.             what I supplied.  QR.BAT should like like the following:
  392.               QR.BAT -> @ECHO OFF
  393.                         C:\MEGAREAD\QREPLY.EXE %2
  394.                         C:\MEGAREAD\<your editor here> %1
  395.  
  396.             Well, that about does it for the MEGAMAIL Mail Reader.
  397.  
  398.  
  399.  
  400.  
  401. Q-Reply v2.2                                                       Page  7
  402.  
  403.  
  404.  
  405.         4. KingQWK Mail Reader
  406.  
  407.             KingQWK can be setup very quickly.  Edit the sample QREPLY.CFG
  408.             that came with Q-Reply.  Next make sure KingQWK puts the
  409.             header information in your quoted reply file.  Q-Reply needs
  410.             this information.  Next, select the External editor and replace
  411.             that with the QR.BAT file you edited earlier.
  412.             Select the 'Paths" from the configuration menu and entering in
  413.             the paths you want.  These same paths must be in the QREPLY.CFG
  414.             also.
  415.  
  416.             Next, select the "Utilities" option and change/add QR.BAT as the
  417.             Text Editor.  This is the External text editor that you can use.
  418.             Q-Reply will be run from the QR.BAT batch file.
  419.  
  420.             Next, select the "Default Flags" and look for:
  421.               1. "Quoted text in Reply/Separate file?"    --> Answer 'R' so
  422.                   the Reply File will be quoted.
  423.               2. "Add messsage header to quoted message?" --> Answer 'Y' to
  424.                   have the message header included in the original.msg that
  425.                   you are replying to.
  426.  
  427.             That's it, just make sure that the QREPLY.CFG contains the same
  428.             information requested that the KingQWK is looking for.
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451. Q-Reply v2.2                                                       Page  8
  452.  
  453.  
  454.  
  455.         5. Jabber Mail Reader
  456.  
  457.             To configure Jabber to work with Q-Reply you'll need to change
  458.             the External editor to equal the QR.BAT file supplied, see
  459.             QR.JAB.  Your line in JABBER.CFG should look like the following:
  460.  
  461.                External editor (blank = internal editor)
  462.                   {EDITOR=C:\JABBER\QR.BAT @QUOTE@ @REPLY@}
  463.  
  464.  
  465.             Change the line to include your header information in the
  466.             Quoted file to YES, like that below:
  467.  
  468.                Insert header into quote (Yes/No)
  469.                   {REPLYHEADER=Y}
  470.  
  471.  
  472.             Select the filename to Quote and the filename to reply to
  473.             whatever you like. I commonly use the following format:
  474.  
  475.                Filename of quote file
  476.                   {QUOTEFILE=ORIGINAL.MSG}
  477.  
  478.                Filename of reply file
  479.                   {REPLYFILE=REPLY.MSG}
  480.  
  481.  
  482.             That's all there is to it.  Run Jabber and have fun.
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501. Q-Reply v2.2                                                       Page  9
  502.  
  503.  
  504.  
  505.        IV.  Using Q-Reply
  506.  
  507.             After configuring Q-Reply, just reply to any message as you
  508.             normally would.  Q-Reply will display it's opening screen, then
  509.             give you the Main Menu.  This consist of three option.
  510.  
  511.             This three options are:
  512.  
  513.             [Q]uoting Menu - Selecting this will take you to the Border
  514.                              Menu.  From here you will have six options
  515.                              to choose from.  There are the original four
  516.                              options that displays the four different box
  517.                              styles.  Two more options added in v2.2 were
  518.                              'Computer Paper' and 'Windows'.  The six
  519.                              options are:
  520.  
  521.                                     Double Vertical/Single Horizontal
  522.                                     Single Vertical/Double Horizontal
  523.                                     Double Vertical/Double Horizontal
  524.                                     Single Vertical/Single Horizontal
  525.                                     Computer Paper
  526.                                     Windows
  527.  
  528.                              After you have finished selecting the Border
  529.                              you want, another menu will appear.  This
  530.                              menu is the Shadow Menu.  From here you can
  531.                              select the shadow you want to put around your
  532.                              quoting message.  You have five options to
  533.                              choose from.  They are:
  534.  
  535.                                     Shadow style #1 - ░░
  536.                                     Shadow style #2 - ▒▒
  537.                                     Shadow style #3 - ▓▓
  538.                                     Shadow style #4 - █▀
  539.                                     No Shadows"
  540.  
  541.                              If you have chosen 'Windows' as your border,
  542.                              then the shadow defaults to Shadow style #4.
  543.  
  544.                              After you have selected both your Border and
  545.                              Shadow, your message will formatted and then
  546.                              be loaded in with your favorite editor.
  547.  
  548.  
  549.  
  550.  
  551. Q-Reply v2.2                                                       Page 10
  552.  
  553.  
  554.  
  555.             Use [D]efault  - This option selects Q-Reply's default Border
  556.                              and Shadow settings. These will be as follows:
  557.  
  558.                              Border setting:
  559.                                 Single Vertical/Double Horizontal
  560.                              Shadow setting:
  561.                                 Shadow style #4
  562.  
  563.  
  564.             [S]ample Style - This will show you the different styles of how
  565.                              your message will be displayed.  The default
  566.                              shadowing is used in the examples.
  567.  
  568.  
  569.             [E]xit         - This will exit Q-Reply and load your editor.
  570.                              This would be the same as editing your reply
  571.                                  with your favorite text editor or to cancel
  572.                                  the quoting of this message.
  573.  
  574.  
  575.             The new menuing system now allows you to use your cursor to make
  576.             your selection of the Border you wish to use and another menu to
  577.             allow you to select the Shadow to use.
  578.  
  579.             One thing to note about your working directory.  Q-Reply will
  580.             look in the current directory for it's configuration file.  If
  581.             it doesn't find it it looks at the preceeding directory.  If it
  582.             still doesn't find it, it'll tell you to place it in one of those
  583.             two directories.  This normally isn't a problem if you have your
  584.             work directory off your mail readers directory.  It will present
  585.             a problem if you don't.  In these cases, like in DOS 6, where
  586.             they have the compressed H: drive or a RAM drive, you'll have to
  587.             place the configuration file one directory proceeding your work
  588.             directory for Q-Reply to find it.
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601. Q-Reply v2.2                                                       Page 11
  602.  
  603.  
  604.  
  605.         V.  Registering Q-Reply
  606.  
  607.             To register Q-Reply you can send a suggested $10.00 donation
  608.             to the continuing development of Q-Reply.  If you like what you
  609.             see and think that it would be worth supporting, then please
  610.             by all means, donate.  Alot of time has gone into the creation,
  611.             design and implementation of Q-Reply.  At the end of this file
  612.             is a registration form.  Fill it out and mail it in at the
  613.             address noted at the top of the form along with your donation,
  614.             if any.  Those who register will recieve the next two updates
  615.             free of any charge along with the production release of Q-Reply
  616.             when it becomes available.  Thanks in advance for any and all
  617.             contributions that may be made.  I truly believe that there is
  618.             wide spread interest in this kind of product.
  619.  
  620.             I can be reached on Compuserve at 70744,617.
  621.  
  622.                      -=*>  Copyrights and Trademarks  <*=-
  623.  
  624.             * Blue Wave is Copyrighted by Cutting Edge Computing,
  625.             * MegaRead is a registered trademark of Kip Compton,
  626.             * Silly Little Mail Reader and Off-Line Express are registered
  627.               trademarks and copyrights of their respective owners.
  628.             * KingQWK is Copyrights of by Mike King
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651. Q-Reply v2.2                                                       Page 12
  652.  
  653.  
  654.  
  655.       VII.  Distribution
  656.  
  657.              Mark C. Stout grants an unlimited license to make and
  658.              distribute unregistered copies of this software.
  659.              Absolutely no modifications to the files contained in the
  660.              software package, including this documentation file, may
  661.              be made before distribution.  No fee may be charged by
  662.              anyone other than Mark C. Stout beyond the actual cost of
  663.              providing these copies without the prior written consent
  664.              of Mark C. Stout.
  665.  
  666.  
  667.  
  668.          VIII.  Support Bulletin Board.
  669.  
  670.              After you have registered your copy of Q-Reply, you will be
  671.              granted access to our support BBS.  This will also be a
  672.              distribution point for the latest version of Q-Reply.
  673.  
  674.              Q-Reply is constantly changing and improving.  Registered
  675.              users of Q-Reply will be allowed to download or at your
  676.              request, be mailed the next 2 updates of Q-Reply at no cost.
  677.              After that, a small donation of $5.00 would be appreciated
  678.              to help offset the cost of development, shipping and the
  679.              cost of running the support BBS.
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701. Q-Reply v2.2                                                       Page 13
  702.  
  703.  
  704.  
  705.                              Mark C. Stout
  706.                            6645 Glen Hollow Ct.
  707.                            Sacramento, CA 95841
  708.  
  709.  
  710.     Date:__________________
  711.  
  712.     Name    :______________________________________________________________
  713.  
  714.     Address :______________________________________________________________
  715.  
  716.     Ct/St/Zp:______________________________________________________________
  717.  
  718.     Phone   :_____________________    Best time to call: __________________
  719.  
  720.     Donation:_____________________   Check[ ]   M.O.[ ]  **Cash[ ]
  721.     Suggested donation is $10.00.  Any donation will be appreciated for the
  722.     continuing development of Q-Reply.
  723.  
  724.         Canada registrations add $5.00 for shipping cost.
  725.     Make check or money order payable to Mark Stout.
  726.     ** Cash is discouraged.
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.