home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / bbs / util / quip.lha / Quip / Quip.doc < prev    next >
Text File  |  1993-08-31  |  62KB  |  1,721 lines
  1. Document Quip, The Fortune Cookie Program From Hell
  2.  
  3.  
  4.             +-------------------------------+
  5.             |                |
  6.             |           Quip        |
  7.             |                |
  8.             |   The Fortune Cookie Program    |
  9.             |         From Hell        |
  10.             |                |
  11.             +===============================+
  12.             |  Joseph Edwards Van Riper III    |
  13.             +===============================+
  14.             |                |
  15.             |  A Cheese Olfactory Workshop    |
  16.             |        Production        |
  17.             |                |
  18.             +-------------------------------+                   
  19.  
  20.             
  21. 0. Legal Stuff
  22. ==============
  23.             
  24.             +-------------------------------+
  25.             |                |
  26.             |       LEGAL STUFF        |
  27.             |                |
  28.             +-------------------------------+                   
  29.  
  30. As is the way of man, sometimes, you just have to spell stuff out to
  31. people.
  32.  
  33. 0.1. Terms of Use
  34. -----------------
  35.  
  36. You are free to execute this program in any way you want.  You may put it
  37. on a disk and fire live rounds from your favorite rifle into it, lick the
  38. diskette you may have picked this up from.. heck, you can even use your
  39. favorite sector editor and write little <00>'s into it.
  40.  
  41. Of course, you may also use this for your BBS or your home system.
  42.  
  43. You owe me nothing except perhaps gratitude.. maybe not even that after
  44. you read some of the supplied quips.
  45.  
  46. Most people call this "Freeware", except I add on other special bonus to
  47. the whole thing... I have included the Source Code!  With THIS in mind,
  48. the program should probably be more properly called "Public Domain".  I
  49. only ask that you do not claim this work as your own, unless you modify it
  50. significantly, and even then, I ask that you include my name SOMEWHERE in
  51. the credits, by way of respect for the work that went into this frivolous
  52. project.
  53.  
  54. Otherwise, feel free to enjoy this program in any way that you feel you
  55. can find enjoyment.
  56.  
  57. 0.2. Distribution
  58. -----------------
  59.  
  60. If you dare to charge people anything more than what Fred Fish charges for
  61. a disk from his definitive PD/Shareware collection, you will be in
  62. violation of my right to have this product distributed freely to all
  63. peoples who wanted a product like this.  That is to say, You Should Be
  64. Ashamed Of Yourself, Where Is Your Mother To Discipline You?
  65.  
  66. If you are a user, and you happen to come across this work, and you've
  67. paid for it, you've been ripped off.  Please try to get in contact
  68. with some kind of authority in your respective country, to get your
  69. money back, and maybe eat the evil bastard for lunch.  At the very least,
  70. you should feel insulted that he thought so little of you as to allow this
  71. remark to remain in the documentation.
  72.  
  73. If you have written a very nice program.. perhaps a BBS or a database or
  74. something, and you wish to include my program with the distribution,
  75. regardless of ShareWare or Commercial fees, you are welcome to include
  76. this program in your distribution, as long as it is made clear that I
  77. (Joseph Van Riper) am the author of Quip.  I do not even require a copy of
  78. the registered version of the program be sent to me (although that would
  79. be exceptionally nice <grin>).  It should also be made clear that Quip is
  80. a Public Domain program, freely available, and that the user is paying
  81. only for your own product.
  82.  
  83. 0.3. Disclaimer
  84. ---------------
  85.  
  86. I, Joseph Edwards Van Riper III, and all peoples working for the Cheese
  87. Olfactory Workshop (in whatever guise), do hereby accept no responsibility
  88. for the results of this program.  Since you haven't paid for it, you
  89. accept full risks for what this program might do.  We will not be held
  90. responsible for anything lacking in the documentation, either... you, the
  91. user, are to accept the full risks of running this program.
  92.  
  93. While we've taken great pains to insure that nothing terribly serious
  94. could happen as a result of running this program, we cannot accept
  95. responsibility for this program's actions, or the documentation's wording
  96. which may lead you to whatever actions.  Enjoy this program, but don't try
  97. to pin anything on us <grin>.
  98.  
  99. So, if by some weird fluke, you read something in the documentation that
  100. suggests you try some parameter, and you find yourself in Alpha-Centari,
  101. sipping Methane in a plastic container, wearing naught but a joystick and
  102. several rubber skid-stops, we cannot be held responsible for it.  Find
  103. your own way home.
  104.  
  105. I strongly recommend, however, that the user read the instructions for the
  106. use of this program before running it, in order to minimalize any
  107. potential damage.  Please keep in mind, Quip modifies certain files under
  108. certain conditions that are easily predictable.  Quip also creates/deletes
  109. certain files according to another file/string's text... eg:
  110.  
  111. ".profile"
  112.  
  113. Might become:
  114.  
  115. ".profile.tab" (or) ".profile.0"
  116.  
  117. while
  118.  
  119. "RAM:garn.dat"
  120.  
  121. Could become:
  122.  
  123. "RAM:garn.0" (or) "RAM:garn.tab"
  124.  
  125. And
  126.  
  127. "RAM:blooie"
  128.  
  129. might become
  130.  
  131. "RAM:blooie.tab" (or) "RAM:blooie.0"
  132.  
  133. Also, all reported rumours about Quip stealing girlfriends away from men are
  134. completely without base.  Even more untrue is the unusual rumour that Quip
  135. will make you impotent, or will reduce your IQ by 5 points with each
  136. invocation.  The one about Quip making calls to the serial device is a total
  137. fabrication, and anything about Quip having Artificial Intelligence is
  138. truly overblown.
  139.  
  140. Read the docs.
  141.  
  142. 1. History Lessons
  143. ==================
  144.  
  145.             +-------------------------------+
  146.             |                |
  147.             |      History Lessons    |
  148.             |                |
  149.             +-------------------------------+
  150.             
  151. A Gilgamesh was the King of Uruk.. no, wait.. you can't be interested in THAT
  152. subject right now!
  153.  
  154. But you might be interested in `Quips History' or perhaps `COWs History'.
  155.  
  156. 1.1. Quips History
  157. ------------------
  158.             +-------------------------------+
  159.             |                |
  160.             |      Quip's History    |
  161.             |                |
  162.             +-------------------------------+
  163.  
  164. Quip has gone through a lot of changes over its time, and I didn't really
  165. keep a very good handle on all the various changes from version to
  166. version, but I can try to give somewhat of an idea, if you REALLY care
  167. about it.
  168.  
  169. 1.1.1. Quip One
  170. ---------------
  171.  
  172. Quip 0.01 (perhaps July 1991, Lattice C++)
  173.  
  174. The very first version of Quip was written because I wanted to see if I
  175. could program a fortune-like program for the Amiga (because I hadn't seen
  176. any up to that time).  I wanted to do it so one wouldn't have to have an
  177. extra table file hanging around the system.  Of course, this meant that
  178. the program would run rather slowly.  However, Quip 0.01 was SO incredibly
  179. slow because I hadn't figured out that Level 1 I/O meant non-buffered, and
  180. thus, I had to wait for disk-movement.  Boy was *I* an idiot!
  181.  
  182. 1.1.2. Quip Two
  183. ---------------
  184.  
  185. Quip 0.02
  186.  
  187. I had discovered that Level 2 I/O would speed things up considerably
  188. <grin>.
  189.  
  190. 1.1.3. Quip Three
  191. -----------------
  192.  
  193. Quip 0.03
  194.  
  195. I implemented the tablefile, as an option, because I was quite tired of
  196. how slow quip retrieval was.  It was pretty cool, suddenly seeing my
  197. little quips pop up almost instantly!
  198.  
  199. 1.1.4. Quip Four
  200. ----------------
  201.  
  202. Quip 0.04 (sometime in 1992)
  203.  
  204. I think I fixed some bugs in this version.  I can't remember what they
  205. were, though.  I DO remember that they were SO bothersome that I
  206. completely re-wrote the code, trying to take better advantage of C++'s
  207. object oriented features.  This also started the MS-DOS series of Quip
  208. programs, distributed almost exclusively in Charlotte, NC, and Minneapolis.
  209. Prefix and suffix files support started to appear in this version.
  210.  
  211. 1.1.5. Quip Five
  212. ----------------
  213.  
  214. Quip 0.05
  215.  
  216. More bug-fixes.  There were a couple of 'sub-versions' (like this wasn't
  217. already a sub-version) that were meant to fix minor problems (such as
  218. reading the filename from the arguments correctly in both Amiga and MS-DOS
  219. versions).
  220.  
  221. 1.1.6. Quip Six and Others
  222. --------------------------
  223.  
  224. Quip 0.06 (and incarnations)
  225.  
  226. Again, more bug-fixes, and some more features (better argument parsing, and
  227. all kinds of nifties).  Included with the archive for the Amiga version was
  228. a program that helped Citadel sysops convert archived messages into Quip
  229. datafiles in a nifty little format (handled anonymous messages, networked
  230. messages [although there was a stupid bug I put in it that will make it
  231. generate messages that look pretty dumb.. maybe I fixed this before I sent
  232. it out.. I dunno], time and date stamps, etc).  Pretty cool, really.  I
  233. also had assembled a ra