home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / comm / sigtune.lzh / Readme.doc next >
Text File  |  1990-07-23  |  5KB  |  89 lines
  1.  
  2. Presenting SigTune v1.0, by Ben Scott  ⌐1990
  3.  
  4.   This program is hereby entered into the PUBLIC DOMAIN.  This means I can
  5. reserve no rights whatsoever to it, however, it's such a simple piece of
  6. code I feel that it matters little.  Do with it as you will, but I ask that
  7. it be left as-is.  Distribute by any and all means, etc., use as birdcage
  8. liner, or sell it to someone gullible for lots of money.
  9.  
  10.   This is my first nontrivial Amiga C program that was not done as a class
  11. assignment.  Basically, I did it to refamiliarize myself with writing code
  12. after more than six months of sitting on my duff.  So far as I know, it is
  13. 100% clean and tidy in all circumstances, and contains no bugs.  It cannot
  14. be made resident but eventually I hope to finish reading the Lattice
  15. manuals so I can learn how to produce pure code.
  16.  
  17.   Also included is a short "man" page, for my own amusement if no one
  18. else's.
  19.  
  20.  
  21.   I am very fond of humorous quotes, and since I began reading Usenet I
  22. always found it necessary to change my .signature file quite often in order
  23. to include all my favorite quotes, since a 60-line .sig is frowned upon
  24. (and rightly so...).  Anyway, I had heard of the Unix program "fortune"
  25. which can print out quotations randomly selected from a file, and I began
  26. looking for a way to incorporate this into the .signature mechanism so that
  27. I could have a different quote every message, and not have to mess with it
  28. myself.  I was also looking for a simple C program to write since I am
  29. trying to learn how to program this beast.  The result is the enclosed
  30. file, named for SIGnature forTUNE.
  31.  
  32.   It will take a quote file TUNE which contains the number of lines of
  33. quotations on line 1 and select one at random, then read a file SIG and
  34. insert the quote line where you have placed the proper escape character
  35. (the default is "$", the dollar sign).  Example SIG and TUNE files are
  36. included.  Below are some possible SIG configurations:
  37.  
  38.  ,--------------------------------------------------------------------.
  39.  | Arthur Dent, galactic traveler and kneebiter for Sirus Cybernetics |
  40.  | $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ |
  41.  `--------------------------------------------------------------------'
  42.  
  43.   -----------------------------------------------------------
  44.  |  $$$$$$$$$  | Buckaroo Banzai and his Hong Kong Cavaliers |
  45.  |  $$$$$$$$$  | The Banzai Institue for Biomedial Research  |
  46.  |  $$$$$$$$$  | Internet: bbanzai@hb88.grovers-mills.nj.us  |
  47.   -----------------------------------------------------------
  48.  
  49.  
  50.   Note that the second example will work fine, but the quotes will still
  51. have to be in one line - they will be mapped into anywhere the escape
  52. character occurs.  If the quote line has fewer characters than there are
  53. escape characters in the SIG file, it will be padded with spaces at the end
  54. (SigTune v2.0 may have auto-centering).  If it is longer, it will simply
  55. not put the whole quote in.  (personally I like to make sure the quotes are
  56. the same length as the number of escape characters in SIG, just to be tidy.
  57. The sample quotes are all sized in this way)
  58.  
  59.   SigTune will search for SIG and TUNE first in the current directory, then
  60. in UULIB:.  They don't have to be in the same place.  It will output to
  61. stdout, which, if not redirected, will be the CLI or shell you ran it from.
  62. The usual command line would be "SigTune >UULIB:.signature" so that it will
  63. feed into your .sig file.  When using the Dillon/Loftus Amiga UUCP port,
  64. one idea is to configure the "MailEditor" and "NewsEditor" to actually call
  65. a DOS script which has the SigTune command line, and then a call to the
  66. editor - this way, you get a new .sig automatically every time you post.
  67. Something like:
  68.  
  69. SigTune >UULIB:.signature
  70. run dme
  71.  
  72.  
  73.   To compile SigTune for yourself, simply execute the source file (an idea
  74. I picked up from the RKM example disks).  I'd also suggest you replace most
  75. if not all of the quotes in TUNE with your own, since I'm not sure which
  76. are legally usable...
  77.  
  78.   I'd like to extend thanks to Frank P. Weed III, for his many suggestions
  79. (two of which I used) and beta-testing.
  80.  
  81.   If anyone comes up with another use for this thing, I'd like to know.  I
  82. can't think of anything else.  I may try porting it to Unix, where it might
  83. find a wider audience, but I'd need to learn more about Unix first!
  84. Anyway, have fun.  I can be reached at bscott@nyx.cs.du.edu (...@nyx.UUCP),
  85. through FIDOnet at 1:104/421.2, at the Arvada 68K BBS (303)424-9831 in
  86. Colorado, or by telepathy.  Note that the latter method is untested.
  87.  
  88.                                             Ben Scott
  89.