home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / QOTD19.ZIP / README.TXT < prev   
Encoding:
Text File  |  1993-02-15  |  13.3 KB  |  284 lines
  1.                             February 15, 1993
  2.  
  3.  
  4.         Midnight Programmers' Quote of the Day 1.8
  5.         ------------------------------------------
  6.               Released for BEST Solutions
  7.  
  8.  Disclaimer
  9.  ----------
  10. I bear no responsibilities for any unintentional mischief caused by this 
  11. humble program on your system.  If on some very remote chance that use of
  12. QOTD.EXE scrambles your computer, you are on your own with my humblest 
  13. apologies.
  14.  
  15. The programs were compiled using Borland C++ version 3.1 and has been 
  16. tested on various 8086, 80286, 80386, 80486 systems running from 4.77 to
  17. 50 mhz. (It hasn't been tested on a Pentium yet, care to donate one? <GRIN>)
  18.  
  19. Now that the nasty part is over with, here is the important stuff...
  20.  
  21.  Program Files
  22.  -------------
  23. QOTD.EXE .... Program that displays the quote.
  24. QUOTE.PTR ... The binary pointer file for QOTD to read the data file from.
  25.           Note: This file is no longer included in the archive but 
  26.             will be created the first time QOTD.EXE is run.
  27. QUOTE.DAT ... ASCII text sequential file containing quotes.
  28. QUOTE.BAT ... A small batch file to reset Hercules screens that don't.
  29. README.TXT .. This file of rantings and other stuff.
  30.  
  31.  Revisions
  32.  ---------
  33. 1.0 - February 17, 1991 
  34.       Compiled using Borland's Turbo BASIC 2.0(?)
  35.       Wrong files sent out in ZIPed file.  (Test files?  WHAT!  Rats!) 
  36.  
  37. 1.1 - February 18, 1991
  38.       ReZIPed with the proper files and a small fix for word wrapping.
  39.  
  40. 1.2 - March 5, 1991
  41.       Compiled using MicroSoft's Quick BASIC 4.5.
  42.       Switch to Quick BASIC from Turbo allows use of Binary access of plain 
  43.       ASCII text file.  Elimination of that bloody humongous random access
  44.       file, and created the pointer file instead.  (Hey, it's smaller, and
  45.       it works.)  Also added batch file to cure the Hercules problem of 
  46.       setting the screen to black on black on exit (just a "CLS" fixes it).
  47.  
  48. 1.3 - May 30, 1991
  49.       Compiled using Borland's Turbo C 1.5.
  50.       QOTD now bears the fruit of previously mentioned "C" classes.
  51.       Added command line parameters to change the way QOTD displays the
  52.       quote(s).  Blame Mike Szwec, he kept suggesting it!  <GRIN>  And 
  53.       besides, I didn't have anything important to do during lunch that
  54.       day anyhow.  (Just goes to show how easily a well designed, 
  55.       structured program can be modified/maintained).
  56.  
  57. 1.4 - July 27, 1991
  58.       Compiled using Borland's Turbo C++ 2.0.
  59.       Both the conversion (renamed) and quote display programs were
  60.       completely rewritten from scratch (as a programming exercise).
  61.       The code is smaller and surprisingly (well, it was to me) about three
  62.       times faster than previously released versions.  Also the pointer
  63.       file size has been halved.
  64.  
  65. 1.5 - August 4, 1991
  66.       Compiled using Borland's Turbo C++ 2.0.
  67.       Due to a justifiable complaint I've increased the maximum size of
  68.       an individual quote to 1300 characters.  A small bug with capturing
  69.       extended keyboard codes was fixed and I've made some more entries in
  70.       the QUOTE.DAT file to bring the number to over 3000 quotes!
  71.  
  72. 1.6 - April 27, 1992
  73.       Compiled using Borland's C++ 3.0.
  74.       A few more quotes, some bug fixes, and inclusion of the pointer  
  75.       program in QOTD.EXE to rebuild the QUOTE.PTR file automaticly if 
  76.       it is missing or changed.  Command line parameter "P" added to 
  77.       force a rebuild of the pointer file.  I also changed the command 
  78.       line parameter "L"oop to "N"umber.  I felt it was more intuitive.
  79.  
  80. 1.7 - October 17, 1992 
  81.       Compiled using Borland C++ 3.1
  82.       A few more quotes, and some playing with Turbo Profiler resulted
  83.       in a 10% average boost in efficiency.  Larger code due to the new
  84.       compiler.  The delay parameter ("/D") now allows a setting of "0" 
  85.       that I was using for testing the file integrity.  The number of
  86.       quotes to display parameter ("/N") allows a setting of "0" as well 
  87.       for continuous display.
  88.       
  89. 1.8 - February 10, 1993
  90.       Compiled using Borland C++ 3.1
  91.       Added some more quotes, now over 5300!  This is getting silly.
  92.       Fixed a small bug when using file sharing on a network.
  93.  
  94. 1.9 - February 15, 1993
  95.       Compiled using Borland C++ 3.1
  96.       Fixed some weird quote display bugs.  Changed the pointer fix
  97.       routine to go a fetch a quote after the fix rather than dump you
  98.       back to the prompt.  Darn that Mike Szwec, he keeps suggesting
  99.       stuff for me to add.
  100.  
  101.  History
  102.  -------
  103. I wrote QOTD.EXE for a lady at work who wanted a program just like the 
  104. fortune cookie program on the VAX for her PC (take a bow Angeline Voo).  A 
  105. couple others also overheard and displayed some interest in the large quote 
  106. collection that I have been accumulating for a couple of years.
  107.  
  108. It originally was written for a BBS program that ran on an old Apple //e, 
  109. and expanded from there.  Once people knew that I was collecting these gems, 
  110. everyone wanted to contribute their own little tidbit.  Thanks to all the 
  111. guys and gals that expanded it to it's current size.
  112.  
  113. The quotes in the QUOTE.DAT file have been compiled from various books, 
  114. movies, other quote files (Waterloo U., QFTD, etc), archania, jokes, 
  115. pithy sayings, humourous observations, Murphyisms and song lyrics.  
  116. Generally, it's been something that struck a cord with me.  The best kind
  117. are the ones that sneak up on ya and get you to start thinking about them.
  118.  
  119. I've also made every effort to elminate duplicate quotes as well as trying
  120. to attribute quotes correctly where ever possible, but I'm sure that there 
  121. are a lots that missed the drag nets.
  122.  
  123. Feel free to add or delete entries as you wish for your own use, but if you 
  124. are distributing this program, please leave the quote file as is.
  125.  
  126.  Points of interest - How this thing is supposed to work
  127.  -------------------------------------------------------
  128. I know that it's rather plain with no neat graphics and stuff, but this
  129. version was intended to be put up on a Novell LAN for everything from SVGA 
  130. colour to crufty old amber Hercules monitors.  The idea was to put this in
  131. the AUTOEXEC.BAT or login script and have a gem of wisdom displayed for 20
  132. seconds, or until a key was hit.  Yeah, it's not fancy, but it does the job.
  133.  
  134. In version 1.2 I added a cross reference file (QUOTE.PTR) so that the program 
  135. knows where to look for each quote (A.K.A. a look up table for you future 
  136. computer scientists).  If you add a quote to the QUOTE.DAT file, the pointers 
  137. to the individual quote start will be messed up and a new pointer file will
  138. get generated automaticly.  Note: There is no QUOTE.PTR in the ZIP file.
  139. I figgure there is no point in distributing a file that gets generated 
  140. automaticly the first time the program is run.
  141.  
  142. As of version 1.3 I added command line parameters to allow you to change the
  143. way QOTD displays quotes.  Here is the list of commands:
  144.  
  145.     /A    - Displays all files from beginning to end.
  146.         (e.g. QOTD /A)
  147.     /B(#) - Sets the background colour in the display (0-7).
  148.         (e.g. QOTD /B0 will set the background to black)
  149.     /D(#) - Changes the display pause delay.  A keystroke still aborts.
  150.         (e.g. QOTD /D60 sets the delay to 60 seconds)
  151.     /F(#) - Sets the foreground colour in the display (0-15).
  152.         (e.g. QOTD /F15 sets the letters to white)
  153.     /N(#) - Displays the specified number of quotes.
  154.         (e.g. QOTD /N10 will cycle through 10 random quotes) 
  155.     /P    - Force rebuild of QUOTE.PTR pointer file.
  156.         (e.g. QOTD /P deletes and creates a new pointer file)
  157.     /Q(#) - Displays the specific quote.
  158.         (e.g. QOTD /Q100 will display quote #100)
  159.     /?    - Displays the command line parameter list.  Also gets 
  160.         displayed if one of the parameter commands can't be decoded.
  161.         (e.g. QOTD /?) 
  162.  
  163. As for the colours used in the foreground and background parameters, here is
  164. the list of their respective numbers:
  165.  
  166.    0 = Black     4 = Red            8 = Dark Gray      12 = Light Red
  167.    1 = Blue      5 = Magenta        9 = Light Blue     13 = Light Magenta
  168.    2 = Green     6 = Brown         10 = Light Green    14 = Light Yellow
  169.    3 = Cyan      7 = Light Gray    11 = Light Cyan     15 = White
  170.  
  171.    (NOTE: 0-15 foregrounds, 0-7 backgrounds ONLY!)
  172.                
  173. You can mix and match the command line parameters as you wish, but some
  174. options may cancel others out.  Don't be too surprised when things don't 
  175. happen as anticipated when you get creative with more than one at a time.
  176. The command line parameters are interpreted from left to right in the order
  177. that they have been entered, hence some commands will over ride others.
  178.  
  179. As mentioned in the note for v 1.4, I completed a "C" class, and I
  180. figgured that the old QOTD was a pretty good project to practice on.  I
  181. discovered some new ways of doing things and thinking about programing
  182. (a Tip'O the hat to Roman Bialach and Allen Taylor.)  This exercise has
  183. convinced me to devote most of my programming time exclusively to "C" and
  184. "C++"in the future.
  185.  
  186. I've also included with this package my original quote file all formatted
  187. so that you too can add files to QOTD.  The supplied file is in alphabetical
  188. order and you just type in the quote on a new line and then run QOTD.EXE
  189. to generate the pointer file that tells the program were to look.
  190.  
  191.  Formatting Quotes
  192.  ----------------
  193. Please notice that each line begins with a "`" (left hand single quote),
  194. new paragraphs are delimited by a "|" (pipe character) and that all credits
  195. are prefixed by "'|  - " (single quote,pipe,2 spaces,dash,space).  This way
  196. everything gets formatted properly when it gets printed out to the screen.
  197.  
  198. Make sure that the total quote (with credit) is under 1300 characters long.
  199.  
  200.  Other Stuff
  201.  -----------
  202. Well, I got over my laziness and rewrote the programs the way they should
  203. have been done.  There are also in this addition over 5300 quotes.  I don't
  204. think that you'll be adding too many more quotes to the list (unless you
  205. collect these things like me.)  Also the current format allows you neat
  206. freaks to keep everything in alphabetical order (not that it really matters).
  207. Just be sure that you have an editor that can handle a file the size of the
  208. QUOTE.DAT file (it's one huge puppy!  Lately I've been using BC++'s editor.)
  209.  
  210.  Possible Future Additions
  211.  -------------------------
  212. I have access to toys to compile this in OS/2 (I'm doing some work in OS/2
  213. at work), if you wish.  I'm in the process of learning Windows so the next
  214. version will probably include a Windows executable.
  215.  
  216.  Lastly - The Begging!
  217.  ---------------------
  218. This baby is LetterWare to noncommercial users (your home machine).  
  219.  
  220. Please drop me line in the mail if you use this program.  I'm curious as to
  221. how far this program gets distributed.  No remuneration is required, but if 
  222. you use it at home and feel the desire compensate me for my time, I'll not 
  223. refuse any monetary donations.  A token $5.00 - $10.00 contribution to my 
  224. entertainment fund ought to cover it (it'll help pay for my "C++" 
  225. programming courses, B-grade ScFi video rentals) and will also get you a 
  226. peek at the source code if you so desire.
  227.  
  228. If this program is in use in a commercial setting or on a network please send
  229. in $10.00.  If you are making money off it, spread some around to the people 
  230. that spent the time and effort to write it, eh?  That's what ShareWare is all
  231. about.
  232.  
  233. If you have a quote that is missing that I might like to add to my 
  234. collection, or (horrors of horrors) an improvement, feel free to drop me a
  235. line.  I enjoy hearing from other people in this hobby/line of work.
  236.  
  237.   Address:  Midnight Programmers
  238.         1589 Waterdown Road,
  239.         Burlington, Ontario,
  240.         Canada, L7R 3X5
  241.  
  242.   BBS:      The GameBoard BBS
  243.         (416) 689-3982
  244.  
  245.   GEnie     MCollis
  246.  
  247.  
  248.  
  249.  Who are Midnight Programmers?
  250.  -----------------------------
  251.  
  252.  Cast members
  253.  ------------
  254.  Mark Collis                      Alan Brooks
  255.  Dan (Derna) Abbott              "Evil" Steve McGrahan (A.K.A. Valuna) 
  256.  Doug (The Optimizer) Carter
  257.  
  258. Right off the top, we are not a "_Midnight_Autoparts_" dealing in hot CPU's,
  259. nor do we dabble in illegal software tampering, and piracy.  We do this for
  260. fun, for the challenge and to learn more about these machines that seem to
  261. take up so much of our free time (yeah, sick puppies ain't we.)
  262.  
  263. The name has been stuck to a group of friends that have contributed to a
  264. number of programming projects over the last couple of years, with code,
  265. ideas, suggestions, testing, food, books, and moral support.  I've usually
  266. been the instigator, but not always.  Some of us are professionals in
  267. the field and some of us are hobbyists that have gotten out of control 
  268. (just ask Alan, he'll tell you I've been out of control for years).
  269.  
  270. Why "Midnight Programmers" and not "Tea Time Programmers"?  Well, if you've
  271. ever done any programming or system maintenance you'll know what I mean.
  272. It's usually late at night that things go wrong and require fixing, or you
  273. lose track of time while putting in just one more feature and look up to
  274. find that it's 2:30 am (and you have to be in for work at 8:00 am!)
  275.  
  276. Over the last little while with all the over the phone rescue missions, 
  277. I've strongly concidered changing names to "Remote Control Consultants" 
  278. <GRIN>, but Midnight Programmers seems to have stuck, and describes this 
  279. loose group computer jockeys quite nicely, thank you very much.
  280.  
  281. Thanks for reading this far....
  282.  
  283.   Mark Collis
  284.