home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / OSKTag_2_01.lzh / osktag.txt < prev    next >
Text File  |  1993-08-19  |  8KB  |  197 lines
  1.                              OSKTag Documentation
  2.  
  3.                               ** Introduction **
  4.  
  5.     Millions of years ago, while humor was first being developed, a
  6. caveman came upon the lowest form of humor, the pun:
  7.  
  8.     "Gtwrp thwark! Fjkm wrg sug xcvr! Thwrg? Fjkm!"
  9.  
  10.     The pun caught on and eventually developed into the one-liner. 
  11. One-liners became very popular.  So popular in fact, that the cavemen
  12. began adding them to every document they chiseled:
  13.  
  14.     "Xortwap + Gtwrp thwark! Fjkm wrg sug xcvr!"
  15.  
  16.     Luckily this form of humor died out for several thousand years until
  17. a very bored message writer re-discovered it in the early 80's, and
  18. added it to the end of a message.  The one liner had been reborn:
  19.  
  20.     "SLMR + Silly rabbit! Tricks are for hookers!"
  21.  
  22.     The tagline, as it became known as, caught on very quickly, as
  23. people needed humor after the Carter administration. 
  24.  
  25.     Soon taglines began popping up at the ends of messages everywhere,
  26. and programmers began to write tagline management programs to make them
  27. more prevalent.  It was inevitable that someone would write one such
  28. program for the world's greatest operating system, OS-9. 
  29.  
  30.     Enter OSKTag, the OS-9/68k Tagline Manager, written by Nick Johnson
  31. with contributions by Allen Huffman and Joel Mathew Hegberg XVIII.  Now
  32. you see why we call it OSKTag for short.  OSKTag was originally written
  33. under OS-9 on the Color Computer 3 by the illustrious Nick Johnson and
  34. has now been ported to OSK by crack-programmer Joel Mathew Hegberg. 
  35.  
  36.                            ** Setting up OSKTag **
  37.  
  38.     First, you need to move taglines.txt and osktag.cfg to their final
  39. resting place, whereever that might be...  it is entirely up to you as
  40. to where you want to put it.  Just be sure that when you execute OSKTag,
  41. your data directory contains these files, and of course, you'll want
  42. your execution directory to contain OSKTag. 
  43.  
  44.     I've found that the best place to put taglines.txt and osktag.cfg is
  45. in a ramdrive.  I don't have a hard drive yet, but I would guess that a
  46. hard drive would be another ideal place.  Floppies are acceptable, but
  47. kinda slow. 
  48.  
  49. You may need to change the xmode of your device descriptor so that no
  50. linefeeds are added.  For example:
  51.  
  52. xmode /t0 -lf
  53.  
  54.     If you get ERROR 214 when you try to execute OSKTag, it is because
  55. you don't have the attributes set correctly.  Type "attr osktag e pe". 
  56.  
  57.                          ** Changing Configuration **
  58.  
  59.     Chances are you will want to change the configuration of OSKTag. 
  60. Well, it is EASY to do this! Use the edit command to edit osktag.cfg. 
  61. Change whatever you need to after each "=".  Don't use leading or
  62. trailing characters. 
  63.  
  64.     Most of the options are self explanatory, with the possible
  65. exceptions of line delay, prefix, and suffix.  Line delay is the amount
  66. of time OSKTag sleeps between the lines it sends out.  It is counted in
  67. ticks, which vary in length from system to system.  The prefix is sent
  68. out before the tagline, and the suffix is sent out after the tagline. 
  69. Prefix and suffix are always separate lines from the tagline.  The
  70. prefix comes set as " --- " which looks pretty nice, and the suffix is
  71. set to "*S" which is the save message command on GEnie. 
  72.  
  73.                              ** Using OSKTag **
  74.  
  75.     OSKTag is very, very easy to use.  Why is it easy to use? Because
  76. Allen Huffman wouldn't get off my back until it was! The Main Menu
  77. allows you to select a tagline, transmit the selected tagline, display
  78. information about the program, select a random tagline with immediate
  79. send, and quit. 
  80.  
  81.     There are 3 methods of selecting a tagline.  Random select will
  82. randomly pick a tagline from the file.  Manual will display the taglines
  83. 20 at a time.  Selective will search the tagline file for matches to a
  84. key combination. 
  85.  
  86.     Both Random and Selective display available taglines 20 at a time. 
  87. If you wish to select one of them, type the number and hit enter.  To
  88. select and immediately transmit, include a period before the number
  89. (i.e.  .12 to send tagline #12).  To get more taglines, hit <ENTER> and
  90. to exit to the main menu, type an x and hit <ENTER>. 
  91.  
  92.     Pressing <T> from the main menu will send the currently selected
  93. tagline (which is displayed below the menu upon selection). 
  94.  
  95.     Pressing <I> will tell you how to send me money for this program,
  96. and how to send me questions and/or comments. 
  97.  
  98.     Pressing <@> will randomly select and immediately send a random
  99. tagline, at the suggestion of Allen Huffman.  Why is it an @ instead of
  100. a *, you ask? Well, look at your keyboard! Which is closer to the
  101. <CLEAR> key??
  102.  
  103.     Pressing <Q> activates the exciting quit option.
  104.  
  105.     Pressing any other key does nothing.
  106.  
  107.                 ** Adding, deleting, and changing taglines **
  108.  
  109.     Taglines can be added, deleted or changed easily with any word
  110. processor, as they are just lines of text.  I would, however, suggest
  111. that you not add a tagline that says, "EVERYBODY'S GOING POO-POO!!!",
  112. since this got me in considerable trouble with a sysop on GEnie. 
  113.  
  114.                                 ** Thanks! **
  115.  
  116.     Thanks to:
  117.  
  118.     Allen Huffman for convincing me that the first version of this
  119. program really sucked and needed to be improved.  Also, many thanks for
  120. your testing and comments.  Special thanks for the locase routine
  121. (everybody thank Allen for this one, or your tagline searches would take
  122. days instead of minutes!).  Also thanks for forcing me to fix the minor
  123. details that make this program what it is. 
  124.  
  125.     Joel Mathew Hegberg for contributing the sleep code, and for being a
  126. democrat (what's life without something to laugh at!). 
  127.  
  128.     My local phone company for making sure there was enough line noise
  129. to fill my SACIA buffer at least once a day. 
  130.  
  131.     Zoom Telephonics Tech support for assuring me that my phone company
  132. sucks, and it is very possible for line noise to keep producing the same
  133. 2 characters.  ( _{ )
  134.  
  135.     Whoever compiled that tagline list that I downloaded.
  136.  
  137.     Coca-Cola and Pizza Hut for providing refreshments.
  138.  
  139.     The Family Roundtable staff for not kicking me out after the
  140. "EVERYBODY'S GOING POO-POO" bit. 
  141.  
  142.     The Tandy Roundtable staff for putting up with my sense of humor in
  143. Real Time conferences (hi Brian!). 
  144.  
  145.     Everybody, for going poo-poo.
  146.  
  147.     MTV, for producing "You wrote it, you watch it" which included
  148. "EVERYBODY'S GOING POO-POO" (spoken by Fred from the B-52's <ick>)
  149.  
  150.     Jimm Hillyerd for the output format.
  151.  
  152.     My principal for letting me graduate (ha! Like there was any doubt!)
  153.  
  154.     My former academic team coach for making me realize that if you
  155. don't have a sense of humor, you just turn into a crappy old grouch. 
  156.  
  157.     Maxwell, my cat, for not sleeping on my disks.
  158.  
  159.     Steve Bjork for inspiring me in 1990 to program harder.
  160.  
  161.     All my relatives who came down for graduation, who were nice enough
  162. to leave me alone while I spent day after day programming this stuff. 
  163.  
  164.     My Calculus teacher, for making me glad to get back home at 9:00.
  165.  
  166.     My primary computer network (until my membership on Delphi goes
  167. through), for being just slow enough that I can fix a bug or two between
  168. menus. 
  169.  
  170.     Information Society and Kurt Harland for providing great music and
  171. keeping me sane, and for the phrase, "hunnamunnagunda". 
  172.  
  173.     Jeri Beck for all her help in contacting Kurt Harland.
  174.  
  175.     Dale Puckett for writing "The Official Basic09 Tour Guide"
  176.  
  177.     Dale Puckett and Peter Dibble for writing "The Complete Rainbow
  178. Guide to OS9 Level II"
  179.  
  180.     Kevin Darling for "Inside OS9 Level II"
  181.  
  182.     YOU for taking the time to download this software! Enjoy!
  183.  
  184.                                      ---
  185.  
  186.     Nick Johnson
  187.     N.JOHNSON1 on GEnie
  188.     NICKJOHNSON on Delphi
  189.     NICKJOHNSON@DELPHI.COM on internet.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  197.