home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / qrep11.zip / QREP.DOC < prev    next >
Text File  |  1993-08-01  |  13KB  |  268 lines
  1.  
  2. ----------------------------------------------------------------------
  3.  
  4.  
  5.  
  6.  
  7.                                QRep 1.1
  8.  
  9.  
  10.  
  11.        The Ultimate QWK Compatible Automated Message Generator
  12.  
  13.  
  14.  
  15.  
  16.                  Copyright 1993 by Brian R. Showalter
  17.  
  18.      All Rights Reserved Nationwide, Worldwide, Solar Systemwide,
  19.              Galaxywide, Universewide, and any other Wide
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26. ----------------------------------------------------------------------
  27.  
  28.  
  29. ----------------------------------------------------------------------      
  30.                            DRIVER'S LICENSE
  31. ----------------------------------------------------------------------
  32.  
  33.  
  34. This software, heretoforevermore christened QRep Version One Point
  35. One, was planted, germinated, watered, designed, written and
  36. copyrighted by Brian R. Showalter, a single white male 28 years of age
  37. living in poverty in the city of Harrisonburg in the state of Virginia
  38. of the United States of America.  It is heavily armored and protected
  39. in accordance with U.S. copyright law, with which you are strongly
  40. encouraged not to trifle.  If you decide to disregard this warning, be
  41. aware that doing so may provoke a visit from the Waco division of the
  42. Federal Barbeque Inspectors (FBI).
  43.  
  44. You are granted a license to examine, smell, use, feel, taste, and
  45. otherwise evaluate QRep for a period not to exceed thirty (30)
  46. twenty-four (24) hour periods (days) in order to determine whether it
  47. meets your needs.  Suspending this testing in order to measure the
  48. methane released by bovine flatulence so your local congressweenie can
  49. justify spending $16,237,593.74 of MY money (that little guy with the
  50. big ears and colorful charts says it's mine) does not constitute
  51. grounds for extending this evaluation period.  At the end of the
  52. aforementioned thirty twenty-four hour periods, you will decide which
  53. one of two paths to take.  You will proceed directly to that path. You
  54. may not pass gas.  You may not collect $200.  You may, however, pay me
  55. $7.00.  Thank you very much.
  56.  
  57. The first path, which is the one least traveled due to its narrowness
  58. and difficult passage, yet the one which leads to great blessings, is
  59. to register QRep by sending me seven (7) United States dollars.  If,
  60. on the other hand, you would prefer not to part with such an immense
  61. fortune because the neighbors' hydrophobic Doberman salivated all over
  62. your checkbook and ruined every single one of your checks, or because
  63. your mother-in-law is demanding that you replace her beloved fake Ming
  64. vase which Junior "accidentally" tapped with a baseball bat, or
  65. because of whatever other creative and equally ludicrous excuse you
  66. can think up, then you agree to cease using QRep and forever banish it
  67. from your working disks.
  68.  
  69. The second path, which just happens to be wide and easily traveled,
  70. and as alluring as a beautiful female clad in a skimpy neon bikini, is
  71. to continue using QRep without making any effort to reward me for my
  72. considerable efforts to create a decent and marketable product.
  73. Proceeding down this path leads to having your posterior nestled
  74. snugly in the middle of a pile of fresh, warm, and aromatically
  75. odoriferous bovine organic fertilizer.  Such is the road which leads
  76. to acute olfactory inundation and feelings of extreme guilt.
  77.  
  78. After registering this product and receiving your QREP.KEY file, you
  79. must guard the aforementioned QREP.KEY file with the life of your
  80. computer, and you may not distribute copies of it to anyone else,
  81. including but not limited to family, friends, co-workers, business
  82. associates, and aliens from the Gamma Tau Omega quadrant.  You may
  83. (in fact, you are encouraged to) distribute copies of the other files
  84. provided that they are distributed unmodified, and that the QREP.KEY
  85. file is not included.  You may not disassemble, decompile, reverse
  86. engineer, copy, transfer, use, modify, or sneak peeks at the private
  87. parts of this product except as permitted by this license.
  88.  
  89. The author makes no warranty, express or implied, regarding this
  90. software product.  This includes warranties as to its fitness,
  91. usability, merchantability, quality, or suitability for any purpose.
  92. Although QRep is in excellent physical shape, you should be aware that
  93. it is specifically not designed for weightlifting, triathlons,
  94. marathon running, or any similar form of strenuous physical exertion.
  95. Be assured, however, the author did put considerable mental exertion
  96. as well as prodigious amounts of Mountain Dew into ensuring that QRep
  97. is reasonably free of defects.  You, the user, assume all
  98. responsibility for the use, misuse, or abuse of this software, and for
  99. determining whether it meets your needs.  In no event will the author
  100. be held liable for any special, consequential, incidental or other
  101. damages resulting from the use, misuse, or abuse of this product.  By
  102. using QRep, you agree to these terms.
  103.  
  104. The author also reserves the right to modify this software, its
  105. accompanying documentation, and/or registration procedures and
  106. benefits at any time and without prior notice.
  107.  
  108.  
  109. ----------------------------------------------------------------------      
  110.                               SHAREWARE
  111. ----------------------------------------------------------------------
  112.  
  113.  
  114. QRep is distributed under the shareware concept.  What does this mean?
  115. Well, contrary to the opinion of certain individuals whose aromatic
  116. essence is reminiscent of a barnyard, shareware is *not* free software
  117. which may be copied and used without any restrictions.
  118.  
  119. Actually, shareware is a term which describes the distribution method
  120. used to place the software into the hands of users.  To accomplish
  121. this herculean feat, an author typically archives all the necessary
  122. files into a single compressed file, and then distributes that file to
  123. bulletin boards, disk vendors, and others who can further spread the
  124. software to other people.  Persons who may be interested in the
  125. software are encouraged to try it out, see how it works with their
  126. system, and determine if it meets their needs.
  127.  
  128. If it does, and they wish to keep using it, then they are expected to
  129. send the author a small fee to register the program.  In return, they
  130. may receive a key file which turns on certain features which may have
  131. been disabled, or printed and bound documentation, or other software
  132. which enhances the operation of the software that was registered.  And
  133. at the very least, they receive the satisfaction of knowing that they
  134. have rewarded the author for all the time and effort he invested in
  135. the program, so that he will feel an incentive to make further
  136. improvements and perhaps even create other programs.
  137.  
  138. Even if they decide not to register, people are still encouraged to
  139. copy the software and distribute it to their families, friends, or
  140. co-workers, upload it to bulletin boards, or give it away at the local
  141. shopping mall.  The more people that are exposed to the program, the
  142. more chances that the author will either be rewarded for his work or
  143. receive feedback which will enable him to fix any defects and make
  144. improvements to the software.
  145.  
  146. Because it costs very little to get software distributed in this way,
  147. registration fees are considerably lower than the price of commercial
  148. software, yet the quality is often comparable.  However, the success
  149. of shareware depends on you, the user.  If you find a shareware
  150. package useful and find yourself using it beyond a short trial period,
  151. then you are morally and ethically bound to register it.  If you
  152. don't, the author may decide that shareware isn't worth the effort,
  153. and may either start writing expensive commercial software or quit
  154. writing software altogether.
  155.  
  156.  
  157. ----------------------------------------------------------------------      
  158.                            How To Use QRep
  159. ----------------------------------------------------------------------
  160.  
  161.  
  162. Now that we've got the dry, boring, and sleep-inducing semi-legal
  163. mumbo jumbo out of the way, let's get down to business.  First, you'll
  164. need an appropriate computer, and it must be based on one of the Intel
  165. x86 processors or a compatible clone.  QRep will work just fine on
  166. vintage Stone Age relics such as the 1982 Itty Bitty Machine Piece of
  167. Crap, commonly known as the IBM PC.  State of the art machines
  168. equipped with a 512 MHz processor, 65536 x 32768 UGA (Ultimate
  169. Graphics Array) video, voice input, and a sound board with 256 sexy
  170. female (or male for the ladies) voices will work even better, although
  171. QRep only gets excited when it encounters a hot processor.
  172.  
  173. To install QRep, simply create a subdirectory which will contain all
  174. of the QRep files, and unpack the QRep archive into that subdirectory.
  175.  
  176.      MD \QREP
  177.      CD \QREP
  178.      PKUNZIP A:\QREP.ZIP
  179.  
  180. Despite not possessing a WIMPY (windows, icons, mouse, pull-down
  181. yingyangs) interface, QRep is designed to be quite simple and easy to
  182. use.  The steps involved in using QRep are as follows:
  183.  
  184.      1.   Use a text editor or word processor to create an ASCII text
  185.           file containing the message which QRep is to insert into a
  186.           QWK reply packet.  Even DOS's brain dead EDLIN editor will
  187.           work for this purpose, although you may end up visiting the
  188.           nearest wig shop in search of a custom-made rug to replace
  189.           hair pulled out by the handful in a fit of frustration.  Be
  190.           sure that the right margin of the text is set to 72
  191.           characters or less so that the BBS software will not
  192.           truncate lines when the message is sent.
  193.  
  194.      2.   Use the same text editor or word processor to create an
  195.           ASCII configuration file for each conference into which QRep
  196.           is to place a message.  Helpful tip:  name the configuration
  197.           files according to the conference number (e.g. 113.QRP for
  198.           conference number 113).  A sample configuration file is
  199.           contained within the 1.QRP file in the QRep archive.
  200.  
  201. NOTE:     Whenever you create or make changes to a configuration
  202.           file, the DOS file date on that file will be set to the
  203.           current system date.  If you've set the DAYS= parameter in
  204.           the configuration file to a number greater than zero, then
  205.           QRep will not generate a message until the system date is
  206.           incremented by the specified number of days.  If you want to
  207.           send a message immediately after making changes to the
  208.           configuration file, you will have to use the TOUCH utility
  209.           included in the QRep archive to change the file date so that
  210.           it is dated earlier than the current system date.  To do
  211.           this, key a command similar to the following:
  212.  
  213.                TOUCH 1.QRP 070193
  214.  
  215.           This command changes the date on the 1.QRP configuration
  216.           file to 7/01/93.
  217.  
  218.      3.   Set up a batch file which will run QRep for each conference
  219.           in which you want to place a message, compress the resulting
  220.           .MSG file into a .REP file, and then run your communications
  221.           software to transfer the .REP file to your home BBS.  A
  222.           sample batch file is contained within the QREP.BAT file in
  223.           the QRep archive.  Of course, you can perform these steps
  224.           manually, but unless you're a glutton for punishment, a
  225.           batch file makes the whole thing much easier.
  226.  
  227. If a reply packet exists before QRep is run, and you want to append
  228. the message generated by QRep to the end of that packet, then you must
  229. first unpack the .REP file before running QRep.
  230.  
  231. That's all there is to it!  For more details, refer to the sample
  232. configuration and batch files provided within the QRep archive.
  233.  
  234.  
  235. ----------------------------------------------------------------------      
  236.                         Contacting The Author
  237. ----------------------------------------------------------------------
  238.  
  239.  
  240. QRep has been extensively tested to ensure that all known flaws and
  241. glitches have been eliminated.  However, since I'm just another
  242. imperfect human living in an imperfect world, QRep may (and probably
  243. does) contain imperfections as well.  If you find any imperfections,
  244. you're perfectly encouraged to inform me of these imperfections and
  245. ask me to perfect them.
  246.  
  247. I can be reached via one of the following methods:
  248.  
  249. FAX:        (703) 564-3700
  250. Internet:   brian.showalter@pcohio.com
  251. FidoNet:    1.157/555@fidonet
  252. Intelec:    Shareware Conference
  253. ILink:      Shareware Conference
  254.  
  255.  
  256. ----------------------------------------------------------------------      
  257.                            Revision History
  258. ----------------------------------------------------------------------
  259.  
  260. v1.0      Initial version of QRep.  Written in C language.  This
  261.           version contained many flaws, required excessive life
  262.           support systems, and was never publicly released.
  263.  
  264. v1.1      Rewrote QRep in C++ using object oriented techniques, which
  265.           resulted in a very clean and easy to maintain program.
  266.           Completed work on very extensive and very ridiculous
  267.           documentation.  First version to be released to the public.
  268.