home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / IKUOTE.ZIP / SYSOP.DOC < prev   
Text File  |  1994-09-01  |  5KB  |  109 lines
  1.                     I K U O T E   2 . 1
  2.                       
  3.  
  4.     This is a simple "logon event" for WWIV boards.  It will
  5. randomly select one from a file of quotes, and display it on the
  6. remote and local screens.  A large file of quotes, Q1.TXT, is
  7. included, and is freely editable, provided that a few simple
  8. precautions are kept in mind.  But first, some legalisms:
  9.  
  10.     Neither the author, or anyone else, makes any representation
  11. that this software will be suited to any purpose whatsoever.  There
  12. is no assurance or claim that it will not instantly wipe your hard
  13. disk, implode your monitor, and dial the IRS and tell them all your
  14. shameful secrets.  In short, no guarantees of anything.  Use it very
  15. definitely at your own risk.
  16.  
  17.     IKUOTE is freeware.  There is no registration fee.  This does
  18. not mean, of course, that you shouldn't send me money, but it does
  19. mean that all you'll get for it is my gratitude and amazement.
  20. Unless it shows some unexpected bugs, there will be no future
  21. releases of IKUOTE.
  22.  
  23.     INSTALLATION...
  24.  
  25.    ...is very simple.  This program is being distributed in a PKZIP
  26. Authenticity Verification envelope, so if you don't see "Authentic
  27. Files Verified!" when you unZIP it, you know that someone has been
  28. tampering with it. If that's alright, then just unpack everything 
  29. into the directory where WWIV lives, and use IKUOTE.EXE as the logon 
  30. event in INIT.  If you've already got something else there, just 
  31. include it as part of a batch file. If you wish to run it from some
  32. directory other than the one where WWIV resides, be sure that you copy
  33. CHAIN.TXT to that directory before calling IKUOTE. That's all!
  34.  
  35.     I have not, and cannot, test this program under every
  36. conceivable set of hardware and software arrangements.  I know that
  37. the setups of some WWIV sysops are rather baroque, if not perverse,
  38. and they'll have to take their chances.  I can say that this program
  39. makes no extraordinary demands on system resources.  I welcome
  40. feedback from anyone who can expand my knowledge in this area.  My
  41. net addresses are at the end of this document.
  42.  
  43.  
  44.     EDITING
  45.     
  46.     The quotes in the quote file are, as usual in these sorts of
  47. things, mostly mildly interesting.  Several may seem really stupid,
  48. and a few may seem illuminated by a supernal wisdom strange to
  49. Earth; but you won't necessarily be able to tell the difference
  50. between the last two categories.
  51.  
  52.     There is only one entry of my own there, and the terrible cost
  53. to me of that small nugget of dubious wisdom, there distilled into
  54. a few dry words, has given me a special insight on this project.  
  55. Some of these quotes were formulated from the most agonizing life 
  56. situations, and are worthy of respect; and that impelled me to a 
  57. certain decision in writing this program.  Each of the quotes is 
  58. displayed for about 6 seconds, and cannot be aborted by the user on 
  59. the far end. That means that your "power users," (heh) zooming through 
  60. the logon formalites to find the latest version of "Gerbil Wars" or 
  61. some damn thing, will be paused for a period. Of course, nobody can 
  62. force them to read, let alone think.
  63.  
  64.     However . . . if you feel that your users just cannot endure
  65. another six seconds on your board, you can run IKUOTE like this:
  66.  
  67. IKUOTE.EXE ##
  68.  
  69.     That will disable the delay. IKUOTE expects to find Q1.TXT,
  70. QUOTES.NDX, and CHAIN.TXT in the same directory it is running from.
  71. If it doesn't find CHAIN.TXT, it will run in a special mode without
  72. the personalized greeting or the WWIV color codes. This can be useful
  73. for a boot-up event in AUTOEXEC.BAT, for instance. If it doesn't find
  74. Q1.TXT or QUOTES.NDX, it will just give you a "file not found"
  75. message and abort, which is not too interesting.
  76.  
  77.     To edit the file, you must keep three things in mind:
  78.     
  79.     (1) Stick to the format.  You can look at the file and see what
  80. that format is.  Do not delete the tilde standing alone at the end
  81. of the file.
  82.  
  83.     (2) Be sure that everything that you put into the file is pure,
  84. printable ASCII.  Higher-level word processors (Word, WordStar,
  85. WordPerfect, etc.) will, unless they are expressly prevented from
  86. doing so, embed all sorts of control and formatting characters in
  87. the text that they handle.  I suggest that you either use a more
  88. modest, "programmer's" type of editor, such as Boxer, Bingo, or
  89. Qedit, or figure out the proper control incantation to make your
  90. word processor forget the fancy stuff.  The first choice is probably
  91. safer.
  92.  
  93.     (3) After editing the quote file, even the tiniest little bit,
  94. you must regenerate the index file.  To do this, just run IKUOTE
  95. with the I parameter.  Like this:
  96.  
  97. IKUOTE.EXE I
  98.  
  99.     It takes about 5 seconds on my 486, and I suppose that it could 
  100. take a minute or two on the original PC. It'll tell you when it's done.
  101.  
  102.     I guess that's about it.
  103.  
  104.     I can be reached on WWIVNet as 1@11655, or on WWIVLink as 1@17350.
  105. Or, you can call my board directly. Ikonoclast BBS, (713) 721-1538.
  106.  
  107.       
  108.                                     - Palinurus             9/1/94
  109.