home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 551.lha / Cookie / ReadMe.txt < prev   
Encoding:
Text File  |  1991-09-08  |  4.0 KB  |  105 lines
  1.                        The ARexx Cookie Monster Programs
  2.  
  3. "What's in the archive, Rick?"
  4.  
  5.     There are four files in there:
  6.  
  7.         ReadMe.txt            You're reading it now
  8.         Cookie.bt             The ARexx program for BackTalk
  9.         Cookie.rexx           A similar program for general ARexx use
  10.         Cookie.dat            The cookie database
  11.  
  12.  
  13. "Ok, what does it do?"
  14.  
  15.     The file "Cookie.dat" is an ASCII file which is the database for
  16.     both of the ARexx programs included in this archive.
  17.  
  18.     The file "Cookie.bt" is an ARexx program for use with terminal program
  19.     BackTalk by Steve Ahlstrom and Don Curtis.  The program uses BackTalk's
  20.     "ONSTRING" ARexx command to watch the incoming serial line.  When
  21.     BackTalk sees the string "saycookie", it notifies Cookie.bt which
  22.     then randomly picks a profound saying from the database file and spits
  23.     it back to BackTalk which sends it out the serial port.
  24.  
  25.     The other program, Cookie.rexx does a similar thing when invoked.  To
  26.     use it, just type "rx cookie" at a CLI or Shell prompt.  It'll respond
  27.     with a randomly selected pithy saying that will hopefully make you
  28.     smile a little.
  29.  
  30.  
  31. "Sounds great!  How do I install it, Rick?"
  32.  
  33.     Once you've successfully de-LHARCed this thing (obviously you have,
  34.     since you're reading this), you have to do a couple of things to make
  35.     it all work.
  36.  
  37.     1.  First, copy the file "Cookie.dat" to your S: directory.  This is
  38.         the Fortune Cookie database.
  39.  
  40.     2.  Copy the "Cookie.bt" file into your REXX: directory.  This is the
  41.         ARexx program that BackTalk uses to grab a random cookie and send
  42.         it out the serial port.  Use your favorite text editor and modify
  43.     the lines which say
  44.  
  45.             send "/nam Rickly"
  46.  
  47.         and replace the "Rickly" with the handle you use in CompuServe's CO
  48.         areas.  The reason for this is that when Cookie.bt pops out it's
  49.         message, it first changes your handle to "Cookie Monster", then it
  50.         sends the cookie and finally changes the handle back to whatever is
  51.         in these lines.
  52.  
  53.     3.  Copy the "Cookie.rexx" file to your REXX: directory.  This is the
  54.         ARexx program that's run when you type "rx cookie".
  55.  
  56.  
  57.     You'll notice that I've commented the programs pretty heavily.  "Gads!
  58.     A programmer who documents?  Will wonders never cease?"  <heheheh!>
  59.     I do that because six months from now, I won't remember why I did
  60.     things.  Besides, it makes it easier for you to change the programs
  61.     if you want to.
  62.  
  63.  
  64. "Can I add more sayings when I come across them?"
  65.  
  66.     Sure you can!  The Cookie.dat file is a standard ASCII text file.  It is
  67.     arranged alphabetically by the first few words of the saying, but you
  68.     don't have to keep it that way.  Just use an editor, add a saying into
  69.     the file.  Add a form feed character (0C hexadecimal, or control-L) after
  70.     the saying to separate it from the others (both of the ARexx programs
  71.     think anything between two form feed characters make up a cookie).
  72.  
  73.  
  74. "How about legalities, Rick?"
  75.  
  76.     Ok, ok.  Here it is:
  77.  
  78.         The files "Cookie.bt", "Cookie.rexx", and "Cookie.dat" are released
  79.         to the public domain by the author, Richard P. Stevens, II.  You may
  80.         use them any way you see fit!
  81.  
  82.     Easy, no?  Just consider these my contribution to the better humor of
  83.     the world at large.  (It'll probably tick off the lawyers out there.
  84.     There's not much they can argue about in it, and you know how they LOVE
  85.     to argue!  <grin!>)
  86.  
  87.  
  88. "If I get confused, how do I get in touch with you?"
  89.  
  90.     Several ways.  The best is probably to send me electronic mail.
  91.     Here are some addresses to use:
  92.  
  93.         CompuServe: 75006,1355 (75006.1355@compuserve.com)
  94.         Internet:   rick@tmi.com -or- sysop@ssssc.com
  95.         UUCP:       ...uunet!zardoz!tmiuv0!rick
  96.                     ...uunet!zardoz!xyclone!sysop
  97.  
  98.     I hang out on CompuServe's AmigaTech forum a lot, starting at about
  99.     10:00 p.m. Pacific time.  If I'm in CO, look for a guy named "Rickly".
  100.  
  101.     Enjoy!
  102.  
  103. Rick Stevens
  104. 29 July 1991
  105.