ENJOY Software
http://www.veling.nl/anne/enjoy/
Signature Readme file
September 2001
Application version 3.0
 
  Email Signature Application 3.0 Help file

Signature is a very simple freeware program that adds a random tagline (such as a quote) to your email signature file. It only works with email clients that use a text file based signature, such as Netscape 3 and 4, Outlook Express, Outlook, Eudora etc. It is a 32-bit application built in Delphi, so it only works on Windows 95,98, NT and 2000.

I have built this application because I was frustrated that such a simple application does not exist already. Or, if it does, it is hard to use, it costs money or it is buggy. Most programs also want to stay in the system tray; this one doesn't. When it is ready changing the signature, it just stops.
 

  what is new in version 3.0?

From many emails from (otherwise satisfied) users, I have built the following changes in version 3.0:
- made empty line between header and quote optional
- added possibility for footer, that is added after the quote-part
- made sure that the same quote is never picked twice in a row
- added sequential mode for quote-picking
- added options in .INI file to allow for editing of system properties, such as location of files and separator character
- better error handling, now outputs an error log (in file error.txt) when something goes wrong.
- optimized code to shrink executable to 78Kb

RTF and HTML support is currently not in this version. The application would become unwantedly complex and loose much of it simple charm in my opinion. Maybe in a next version this will be added.
 

  Copyright notice

This program is freeware. You can copy and use it as you like. Whether it works or not, or how it works is your problem. I am not responsible and you may not sue me.

If you like the program, please let me know.
Programmer is Anne Veling from ENJOY Software
http://www.veling.nl/anne/enjoy/
anne@veling.nl
 

  Installation is simple:
1) unzip the file (because you are reading this file, you have already done that)
2) place the executable in a subdirectory, e.g. c:\program files\signature\
3) adapt the header.txt and quotes.txt files (see below for file formats)
4) schedule the program to be run from time to time (you can do this by using the System Agent that is a part of Windows Plus! (or in the Scheduled Tasks part of the Control Panel), or you can put a shortcut to the program in your startup-menu, so that it is run every time you reboot your computer
5) edit the preferences of your email client to let it point to the new signature file (in the same directory as the program, with file name 'signature.txt'

If you encounter any problems, email them to me anne@veling.nl

Files:
signature.exeThe executable that simply changes the signature.txt file with a random new tagline
header.txtThe text that is always added before the tagline, you can put your email address there
quotes.txtThe file that contains the taglines, separated by '#' characters
signature.txtThe generated signature file
The newly added error handling creates an error log in a file called error.txt in which log messages are given when something goes wrong (when it cannot find a necessary file e.g.).

 

  File format of header.txt

The header file should start with an empty line, if you want a clear separation between your email message and the signature. A line with just '---' is a good idea, too. There is no need for an additional empty line at the end, that is added automatically. Due to many requests from users, in the 3.0 version of this application, this behaviour can be changed (see Options).

 

  File format of quotes.txt

This file should contain at least one quote. Quotes are separated by '#' characters. That means you cannot have '#' characters in your taglines! An empty line is inserted between the header and the random tagline All space characters before and after the tagline are deleted.

 

  Application options

In version 3.0, some options and features that were requested by our users have been added. For backward compatibility, if you just copy the new executable over your old one, everything should just work the same. However, the application now writes a settings file in .INI format in the same directory if it does not exist already. In it are the default settings, that can be changed by the user.

A description of the options in the signature.ini file are:
parameterdefault valuedescription
strictfalseindicates whether the application should concatenate the header and quote files strictly, or add an extra empty line between the two. If set to "true", the application will no longer add extra lines.
headerheader.txtthe filename of the header file that contains the constant part of the signature, that is added as a prefix of the signature file. Can be changed to point to another file. If the file is absent, it ignores this parameter.
footerfooter.txtthe filename of the footer file that contains the constant part of the signature, that is added as an affix of the signature file (after the quote). Can be changed to point to another file. If the file is absent, it ignores this parameter.
quotesquotes.txtthe filename of the quotes file that contains the quotes that should be added, separated by a '#' character. Can be changed to point to another (e.g. shared over different profiles) quotes file. This file should be present, otherwise an error will occur.
signaturesignature.txtthe filename of the signature to build. Can be changed to make the program save the signature in a separate folder or under a different name.
separator#the character that separates the quotes in the quotes file. Can be set to a different character if you want to use the #-character in your quotes themselves.
randomtruewhether the program chooses new quotes at random or not. By default it does (making sure the same signature is never chosen twice in a row). If you change this to "false", it will choose a signature sequentially; the next one in the file every time it is run. It will start at the beginning when it reaches the end.
last?the index number of the last quote chosen. Is used by the system to make sure the same quote is never picked twice in a row. Should not be changed by the user.

 

  Frequently Asked Questions

How can I use the program with Pegasus Mail?

  1. Create a batch file called SIG.BAT with the following:
    c:
    cd\pmail
    cd signature
    signature.exe
    type c:\pmail\signature\signature.txt
    copy c:\pmail\signature\signature.txt c:\pmail\mail\inetsig.pms
    copy c:\pmail\signature\signature.txt c:\pmail\mail\localsig.pms
    
    This will launch signature and create the signature file as signature.txt. You could use the file location options from the ini file itself as well.
  2. Next, create a shortcut to this. Call it SIG (the full name will be SIG.PIF). Change the properties of the shortcut to run minimized and close on exit.
  3. Next, edit the COPY SELF filter rules, and create a new rule to run an external application, and enter the full path and filename of the SIG.PIF file you just created.
  4. After this, any time you send an email, your signature program will be run via the PIF file specified in the Copy Self filter rule, and the next email will have a different signature.
  5. I don't know if this is any good to you or not, or even if it works on every OS. I've only tested it on 98 so far - I'll let you know how NT and 2K fare as soon as I can (if you're interested)
This was sent to me by one of the users and was tested on Windows 98, but it will probably work on Windows 2000 and NT as well.

How can I use the program with Microsoft Outlook 2000?
In Outlook 2000, you can specify a signature, even from a file template, however these are not reloaded every time you create a new mail message. It seems therefore that you cannot use Signature Application with Outlook 2000. However, there is a way around this:

  1. Create a new signature (e.g. called "mysig") in Outlook in the Menu Tools - Options; tab Mail Format, Signature Picker. Use no template for the signature and just type in some dummy text
  2. If you create a new email, Outlook will attach this signature automatically. What it has done is make a new text file called mysig.txt (or any other name you gave the signature) and reload from there. This file can be found in C:\Documents and Settings\your name\Application Data\Microsoft\Signatures
  3. You can adapt Signature Application 3.0 to write the signature file to this location. To do this, you will have to adapt the signature.ini file as follows:
    [files]
    signature=C:\Documents and Settings\your name\Application Data\Microsoft\Signatures\mysig.txt
    
  4. This signature will only be used for text-formatted email messages in Outlook 2000. In the same folder, there are .html and .rtf files that are used for the corresponding mail formats. If you want to create these signatures as well, you can do so by adapting the header and footer files to include the html/rtf codes. You will have to understand more about these formats, though.

If you have other questions or have found out how to use this program to work with other clients, let me know.