TagLine Generator for PMMail
Copyright 1996, Stephen Berg and Iceberg Software Productions

                     
		PMTagLine V 1.1a (Oct 21)
		A REXX script for PMMail
		Written by Stephen Berg
		(C)1996 - Stephen Berg and Iceberg Software Productions

Table of Contents

1.  Introduction

2.  Disclaimer

3.  Installation

4.  Using PMTagLine

	4a.  Let PMTagLine randomly pick a TagLine.
	4b.  Pick one from the file specifically.
	4c.  Input your own TagLine manually.
	4d.  Search for text and then choose.
	4e.  Bypass the TagLine insertion.

5.  What-Not

6.  Future development

7.  Contact Info

8.  History

*******************************************************
*                1.  Introduction:                    *
*******************************************************

	Thank you for getting this product, of course since it's free 
you didn't have to work very hard did you?  =:-)  This REXX script was 
writen in order to regain the TagLine features of the off-mail readers 
I used back in my BBS'ing days.  It's not quite as fully featured as 
they were for the tagline thing, but it's a start anyway.  

	I wrote the script with VREXX2 which is an IBM Employee Written
Software product and available to anyone who has a valid licensed copy
of OS/2 as far as I know anyway.  I'm distributing this script without the
VREXX product.  You'll have to obtain it yourself.  It can be found at the
following FTP site:

	ftp://software.watson.ibm.com/pub/os2/ews/vrexx2.zip 

	The software is freeware but I'd appreciate an email to let me
now if you're using it.

*******************************************************
*                2.  Disclaimer:                      *
*******************************************************

	(That silly legal stuff)

	The entire code is here for you to see, change, use or not use.  
I will *NOT* be held responsible if your machine blows up, if your 
Internet Provider disconnects you, if your significant other/wife/husband 
leaves you, if the IRS audits you or anything else bad happens to you by 
fault or not in this script.  That's why it's free.  And by using these 
scripts you fully and without reservation accept these terms.  If you 
don't accept, then don't run these scripts, it won't effect my paycheck 
either way.  =:-)

	I've tested it out pretty well on my system which is Warp 4.0 
Fullpack running PMMail 1.52 and it seems to be very stable for me.  If 
you're running another OS/2 version or another PMMail version I can't be 
so sure.  Let me know if you have a different setup and whether or not
it's working for you.

*******************************************************
*                3.  Installation:                    *
*******************************************************

	Installing this script is rather easy, just make sure that the
TAGLINE.CMD and TAGLINE.TXT files are in the PMMail working directory.
This will be whereever your PMMAIL.EXE file is most likely, but you know
your system better than I.  On my system that is C:\SOUTHSDE\PMMAIL, but 
it may change if you installed PMMail elsewhere on your particular 
system.  

	Once that's done, click on the "Account" pull down menu in
PMMail, select "Utilities Settings..." from that menu.  When the 
Utilities notebook comes up, select the "REXX Exits" tab.  

	There you'll see two different entries, click the box next to
"Message Send Exit".  Then where it says "Script To Run" put in 
"TAGLINE.CMD".  That should do it.  Whenever you send email out now you 
should see a small dialog come up to choose how you want to handle the
tagline for that message.

*******************************************************
*                4.  Using PMTagLine:                 *
*******************************************************

	When PMTagLine starts up it presents a radio button dialog so you
can choose how it works for that individual message.  There are four 
choices available:

	4a.  Let PMTagLine randomly pick a TagLine.

	This function will randomly pick a tagline from the TAGLINE.TXT
file and insert it at the bottom of your outgoing mail.

	4b.  Pick one from the file specifically.

	This function will display a dialog that you can browse through
the taglines in TAGLINE.TXT and pick one individually to be added to your
outgoing mail.

	4c.  Input your own TagLine manually.

	This function will allow you to add your own tagline manually to 
be added to your outgoing mail.

	4d.  Search for text and then choose.

	This will allow you to search for a particular string of text and
then pick a tagline from any taglines that match.  If the string that you 
are searching for is not found, PMTagLine will return to the initial choice
selection dialog.  (NOTE:  At first I had this return to the string input
dialog to do another search, but decided that if one didn't match people 
might want to just go for a random pick.  I may have it give you the choice
in a future version.  This was easier for me at this point of my under-
standing of VREXX.)

	4e.  Bypass the TagLine insertion.

	This function just exits the script and allows the message to go
out without any tagline being added.

*******************************************************
*                5.  What-Not                         *
*******************************************************

	Please let me know if you have any problems with this script or
find any bugs.  It's working rather smoothly for me, but that's only one
system.  You can email me at "sberg@southwind.com" or find me on IRC,
using "SSgt" for a nick, EFNet and usually in #OS/2.

	I have heard that PMTagLine gets confused it you're using an
extremely large file for your taglines.  I can't say right now whether it's
REXX, VREXX, my code or OS/2 that is causing the problem.  Maybe I'll get
a chance to play with that and try to narrow it down some.  As is it should 
work as long as the tagline.txt file isn't incredibly large.

	As for "TagNapping" incoming taglines, see below.  In the meantime
a couple of users have informed me that they keep a shadow object of their
tagline.txt file handy and if they see one that they want to swipe they do
a quick cut/paste to the tagline.txt file.

*******************************************************
*               6.  Future development:               *
*******************************************************

	I'm running a few thoughts around in my head about how to scan
incoming messages for taglines and make it possible to "TagNap" them into
your own TAGLINE.TXT file.  Right now I don't know of an easy way to do 
this since the incoming message REXX hook would be called for each and 
every message that is received.  Since I get around 100 messages a day I'm
not gonna want that to happen to myself so I won't do it to you either.

	I did get one suggestion to allow choosing different text files
to get the taglines.  I hope to add in that functionality sometime soon.

	I just had a thought about confirming any randomly chosen tagline
before it actually gets added.  If refused I could either go back to 
choose another random tagline or restart the process entirely, not sure
which would be easier or more comfy for you or if this would be a wanted
feature in the first place.  Drop me line via email with a suggestion on 
this one and I'll go from there.

*******************************************************
*               7.  Contact Info:                     *
*******************************************************

Stephen Berg
IceBerg Software Productions

	sberg@southwind.com
				http://www.southwind.com/sberg/

*******************************************************
*               8.  History:                          *
*******************************************************

Version 1.1a

	Fixed the txt file name, it was taglines.txt in the archive but
		the script was looking for tagline.txt.  Thanks to Murray
		Weismer for finding this and bringing it to my attention.
	Fixed one mistake in this file, maybe I'll proofread it again before
		I save it this time.  =:-)
	Added in a couple more ideas about future features.

Version 1.1

	Cleaned up a couple of small bugs.
	Added in the "Search and choose function"
	Reviewed the tagline.txt file, took out a few that were not
		very funny (IMHO) and a few that were really outdated.

Version 1.0

	Initial release of PM TagLine.
