home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / TUJOKE1.ZIP / TUJOKE.DOC < prev    next >
Text File  |  1995-08-08  |  5KB  |  117 lines
  1.                              WWIV Joke Of The Day
  2.                                 by The Usurper
  3.                                    08/07/95
  4.  
  5. DISCALIMER :
  6.  
  7.   I'm not responsible for what you do with this. (Long enough? |])
  8.  
  9.  
  10. INTRODUCTION:
  11.  
  12.   Joke Of The Day for WWIV will display a random joke.  It can be run in
  13. the logon even or as a door.  It was written in Turbo Pascal 7.0 for those
  14. who love jokes as much as I do (or more, if that's possible).
  15.  
  16.  
  17. INSTALATION:
  18.  
  19. *  To run it in the logon event edit your LOGON.BAT (or whatever you're
  20. executing) and put TUJOKE1.BAT %1 at the end (make sure you have %1 after
  21. logon.bat in init!).
  22.   If you're not running any external programs at logon,  go into init and
  23. enter LOGON.BAT %1 in external programs where it asks for a logon event.
  24. Then create a file LOGON.BAT and put TUJOKE1.BAT %1 inside.
  25.   Next, create a directory for the Joke Of The Day files and place them all
  26. in there except for TUJOKE1.BAT which you should place in your main WWIV
  27. directory.  Next, edit TUJOKE1.BAT and change the paths and stuff, you'll
  28. know what to do.
  29.   Please make sure that TUJOKE1.BAT %1 is the last line in your LOGON.BAT. If
  30. it's not, logon programs after it will not be executed.  If you HAVE TO have
  31. another program executed last, try using CALL TUJOKE1.BAT %1 or just copy
  32. all TUJOKE1 files to your main WWIV directory and execute 
  33. "TUJOKE1.EXE %1 JOKELIST.TXT" from LOGON.BAT.
  34.  
  35. *  To run it as a door,  create a directory for it, place the files in there,
  36. edit/change TUJOKE1.BAT, place it in your main WWIV directory, run Chain Edit
  37. from WWIV, create a new chain, and enter TUJOKE1.BAT %1 in the B line.
  38.  
  39.  
  40. EXTRA FEATURES:
  41.  
  42. *  TUJOKE1 not only will display jokes found in file the joke file.  It will
  43. also convert special codes.  They are:
  44.         %%N  - User's real name
  45.         %%H  - User's handle
  46.         %%A  - User's age
  47. In other words, you can use the user's name, alias, or age in jokes.  Just
  48. place one of the codes above somewhere inside a joke and it will be converted
  49. when the joke is being displayed.
  50.  
  51. *  TUJOKE1 uses the file TUJOKES.DAT by default.  However, you can specify
  52. a text file in the command line which contains a list of joke files and
  53. TUJOKE1 will pick one file at random.  That way, instead of having only 50
  54. jokes to pick from, you can have an infinite amount of them!
  55. The file must look like this:
  56.  
  57. ------
  58. 3
  59. TUJOKES.DAT
  60. MYJOKES.DAT
  61. C:\EXTRA\MOREJKS.DAT
  62. ------
  63.  
  64. (not the dashed lines though)
  65. The first line must be a numeric value which tells TUJOKE1 how many joke
  66. files you have listed below.  The following lines must be valid names of
  67. joke files (if a joke file is in a different directory you can enter
  68. the path + filename).
  69. To use multiple joke files you must execute TUJOKE1 as below:
  70. TUJOKE1.EXE %1 JOKELIST.TXT
  71. where %1 stands for the CHAIN.TXT file and JOKELIST.TXT stands for the text
  72. file containing the list of joke files.  This is the default setting.
  73.  
  74.  
  75. JOKE EDITOR:
  76.  
  77.   TUJOKE1 comes with an editor that lets the sysop edit the jokes.  To edit
  78. TUJOKES.DAT just execute the editor w/out any options.  To edit a different
  79. joke file execute the editor followed by the name of the joke file
  80. (i.e. JOKEDIT.EXE MYJOKES.DAT).
  81.  
  82. *  Editor options
  83.  
  84. $ - saves the file you're editing.  If you quit w/out saving the changes you
  85.     made will not be saved (duh!)
  86. # - sets the number of jokes that this file has.  You don't need to have all
  87.     50 jokes in a joke file; TUJOKE1 will pick only from as many as you set
  88.     the number of jokes to. (i.e. to use only jokes 1-20 set the number to 20).
  89.     If you leave this at 0 no jokes will be displayed.
  90. ] - moves one joke up
  91. [ - moves one joke down
  92. A - jumps to a joke number
  93. 1 - lets you enter the first line of the joke (max. 130 characters)
  94. 2 - lets you enter the second line of the joke (max. 130 characters)
  95. 3 - lets you enter the third line of the joke (max. 130 characters)
  96. W - writes all jokes from this file to a text file.  If you want to correct
  97.     spelling of all jokes using an external spell checker, you can print your
  98.     jokes to a text file and quickly find which ones have misspelled words in
  99.     them.  You still have to edit the jokes using JOKEDIT.EXE.
  100. Q - quit the editor WITHOUT SAVING CHANGES.
  101.  
  102. Problems:
  103.   If there are any problems go back and read this file again.  If you follow
  104. instructions there can't be any problems.  If you need help contact The
  105. Usurper on a local bulletin board in South New Jersey (609 area code).
  106. Sorry, i don't remember my WWIVNet address |]
  107.  
  108. Registration:
  109.   This utility is freeware.  If you feel like paying for it anyway, send
  110. money to your favorite BBS SysOp for their hard work.
  111.  
  112. Comments:
  113.   I appreciate any comments, suggestions, bug reports, etc.  Please feel
  114. free to let me know what you think about TUJOKE1.
  115.  
  116.  
  117.