home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / tladd10a.zip / TagAdd.TXT < prev    next >
Text File  |  1996-11-01  |  7KB  |  198 lines
  1. Tagline Add-In 1.0a for PMMail 1.5x
  2. ===================================
  3.  
  4. Contents
  5. ========
  6.  
  7. 1)  Overview
  8. 2)  License
  9. 3)  Disclaimer
  10. 4)  Requirements
  11. 5)  Installation
  12. 6)  Usage
  13. 7)  Known Bugs
  14. 8)  Planned Features
  15. 9)  Revision History
  16. 10) Contact Information
  17. 11) Copyrights
  18.  
  19. 1. Overview
  20. ===========
  21.  
  22. Back in the days of Fidonet and BBSes, one neat thing about sending and
  23. receiving electronic messages was the tagline.  A tagline is an often
  24. funny one-liner at the bottom of a message intended to reflect the
  25. writer's personality.
  26.  
  27. Taglines became a big thing.  People would collect thousands of
  28. taglines and have their mail reader select one at random every time
  29. they wrote a message.
  30.  
  31. Well, the other day I was browsing through the Hobbes OS/2 FTP site for
  32. new files and I tripped over Stephen Berg's PMTagLine 1.1a for PMMail. 
  33. This program promised to offer the same functionality, only now in my
  34. favourite e-mail client for OS/2 -- PMMail 1.5x (which I strongly urge
  35. you to check out and *register* if you intend to use it!).
  36.  
  37. Well, I liked PMTagLine, but the clumsy VREXX dialogs didn't look
  38. particularly nice, and I decided I could do a better job.  Also, I
  39. didn't especially like the copyright notice that was tacked on all
  40. my messages.  The result of 3 hours work in VX-REXX -- TagLine Add-In
  41. 1.0.
  42.  
  43. TagLine Add-In 1.0a basically offers the same features that PMTagLine
  44. 1.1a, except for the text search feature.  I didn't really plan to
  45. use this feature myself, so I didn't include it in TagLine Add-In.  If
  46. someone out there wants it implemented I'd be glad to do so.
  47.  
  48. 2. License
  49. ==========
  50.  
  51. Tagline Add-In is "freeware", that is to say I grant permission for
  52. anyone to make use of it without charge.  This only extends to personal
  53. use.  If this program is to be used commercially a nominal fee must be
  54. payed to the author, Kevin Yank.  Please contact him for more
  55. information (see below).
  56.  
  57. I would, of course, appreciate a short e-mail if you decide you like
  58. this program.  I could have spent those three hours studying, you know,
  59. so I'd like to hear that I didn't waste my time. :)
  60.  
  61. 3. Disclaimer
  62. =============
  63.  
  64. Before you continue, please understand that Kevin Yank (the author) 
  65. will not be held responsible for any damages, problems, etc. that occur
  66. as a direct or indirect result of using this software.  I have tried to
  67. make this program as bug-free and system-friendly as possible and have
  68. tested it to excess, but if you have any concerns feel free to contact
  69. me (see below).
  70.  
  71. 4. Requirements
  72. ===============
  73.  
  74. - Any system capable of running OS/2 Warp and PMMail 1.5x.
  75.  
  76. - OS/2 Warp 3.0 or above (4.0 is recommended, as I have made extensive
  77.   use of the new WarpSans system font).
  78.  
  79. - PMMail 1.5x.
  80.  
  81. - VROBJ.DLL 2.1d.  This is a VX-REXX program, and as such requires the
  82.   VX-REXX runtime library.  This should be available from wherever you
  83.   obtained TagLine Add-In.
  84.  
  85. - A few minutes to set it up. :)
  86.  
  87. 5. Installation
  88. ===============
  89.  
  90. Installation is quite simple.  Just unzip the contents of the archive
  91. into your PMMail program directory (wherever PMMAIL.EXE resides... e.g.
  92. C:\SOUTHSDE\PMMAIL).  Then, open PMMail and (while in the account to
  93. which you want to add tagline functionality) select "Utilities
  94. Settings..." from the "Account" menu.  In the Utilities notebook, click
  95. on the "REXX Exits" tab.  Make sure that the "Message Send Exit"
  96. checkbox is selected, and enter "TagAdd.EXE" in the "Script To Run"
  97. entryfield.
  98.  
  99. Also, make sure VROBJ.DLL is in a directory on the LIBPATH.
  100.  
  101. From now on, PMMail should query you on how to handle the tagline for
  102. every outgoing message in that account.
  103.  
  104. To setup your library of tagline files, simply edit the "Taglines.TGL"
  105. file included (plain text, one tagline per line), or create a new
  106. tagline file (see below). The provided "Taglines.TGL" file is the same
  107. one provided with PMTagLine 1.1a.  Once again, hats off to Stephen
  108. Berg!
  109.  
  110. 6. Usage
  111. ========
  112.  
  113. The Tagline Add-In interface is really quite easy to use.  Firstly, you
  114. select one of the four radio buttons to define how the program should
  115. handle the tagline for this message:
  116.  
  117. Automatically select a random tagline...
  118. ----------------------------------------
  119.  
  120. This allows you to tell Tagline Add-In to choose the tagline randomly
  121. from the currently selected tagline file.  The tagline that will be
  122. used is shown in the field just beneath the radio button.  If you do
  123. not approve of this random selection, just click on the "Another
  124. Tagline" button to make another random selection.  If you want to
  125. choose a tagline from a different file, click the "Another File..."
  126. button and specify the file to be used.
  127.  
  128. Choose a specific tagline...
  129. ----------------------------
  130.  
  131. This option lets you browse through the list of taglines available in
  132. the currently selected tagline file and make your selection from there.
  133. Again, the "Another File..." button allows you to jump to a different
  134. tagline file if you so choose.
  135.  
  136. Enter a tagline manually...
  137. ---------------------------
  138.  
  139. If you're feeling creative, you can use this option to type in a
  140. tagline manually.  If you select the "Add to file" checkbox, the new
  141. tagline will be added to the bottom of the currently selected tagline
  142. file.  Again, an "Another File..." button is provided to select which
  143. file the new tagline will be added to.
  144.  
  145. Do not add a tagline
  146. --------------------
  147.  
  148. If you decide a tagline would not be appropriate on a particular
  149. message, simply select this option to forego the addition of a tagline.
  150.  
  151. Once you have specified how the tagline should be handled, click the
  152. round, green "Checkmark" button in the bottom-right of the window.  The
  153. selected action will be taken, and PMMail will go ahead and attempt to
  154. send the message.
  155.  
  156. 7. Known Bugs
  157. =============
  158.  
  159. None as yet... I was hoping someone could spot one or two? :)
  160.  
  161. 8. Planned Features
  162. ===================
  163.  
  164. I can't say that anything pops into my head when I ask myself what I
  165. might want more out of this program.  I am, however, *very* receptive
  166. to any suggestions you might have.
  167.  
  168. 9. Revision History
  169. ===================
  170.  
  171. 1.0, 28th of October, 1996
  172.  
  173.    Initial Release
  174.  
  175. 1.0a, 1st of November, 1996
  176.  
  177.    Bugfix: Messages with files attached (MIME or BinHex only) did not
  178.            have taglines added to them.
  179.  
  180. 10. Contact Information
  181. =======================
  182.  
  183. Kevin Yank can be contacted by e-mail at:
  184.  
  185.     kyank@sentience.com.au
  186.  
  187. 11. Copyrights
  188. ==============
  189.  
  190. Tagline Add-In is Copyright ╕ 1996, Kevin Yank
  191.  
  192. PMTagLine is Copyright ╕ 1996, Stephen Berg and Iceberg Software Productions
  193.  
  194. PMMail is Copyright ╕ 1994, 1995, 1996 Southside Software
  195.  
  196. OS/2 and OS/2 Warp are Trademarks of IBM coporation
  197.  
  198. VX-REXX is Copyright ╕ 1993, 1995 Watcom International Corporation