        _Tag-O-Matic Installation Guide._
        =================================
        (Last updated 17 April 1997 (version 13))

(Note INSTALL.EXE, which was supplied with v.12 is dropped in v.13 - 
the functionality wasn't enough to justify the size, IMO ')

This file gives installing tips for various mailers. Specific help is offered
for Termail, BlueWave 2.30 and GoldEd. If you're using another mailer, then 
please read the "Generic Section". If you're using a Windows mailer, or email 
reader, see the "Email" section. 

 This file does NOT cover every function available to Tag-O-Matic users,
please DO read T-MATIC.DOC and TAGUTIL.DOC too. This file is hopefully enough
to get you started, if not, please check the others.

 For most OLR's, it's best to unzip Tag-O-Matic into the OLR's main
directory.

        _Termail Instructions_
        ======================

(Version 4 or less)
-------------------
There are two sections to be completed to use Tag-O-Matic with Termail
for basic use. The first is to edit T-MATIC.CFG to your satisfaction. Full
details on the specifics of this are in T-MATIC.DOC, although you may be
able to figure it out just by reading and editing T-MATIC.CFG itself.

When that's set up, you can now setup Termail so it runs Tag-O-Matic when
you enter a new message, or reply to one.

Load Termail's configuration file [TM.CFG] into your favourite word processor.
Find the line that starts with:

Editor

Change this to read (for example)

Editor      T-MATIC @FILE

As far as Tag-O-Matic's concerned, you can leave the entries:

BeforeEdit
AfterEdit

blank. You can, of course, use other programs here, but Tag-O-Matic no longer
needs them for itself. Note that Tag-O-Matic can also call a program after
editing from within itself. You can set Tag-O-Matic up to run as BeforeEdit
or AfterEdit, but that's left as an exercise for the user; suffice to say,
for most people, using Editor will be the best solution.

(Version 5)
-----------

There is a sample config file for Termail in the EXAMPLES.ZIP archive
saved as T-TM5.CFG  Overwrite the existing T-MATIC.CFG with this version
and read through - there are some things you will need to change.

 Are you using the internal or external editor of Termail 5?

Internal
--------
Termail 5 has an excellent internal editor which you might prefer to use.
This makes things a little trickier for Tag-O-Matic, but not too much.
You don't touch the "Editor" entry in TM.CFG, instead, change AfterEdit
to:

AfterEdit T-MATIC @FILE

This makes sure Tag-O-Matic is run immediately after you save your message.
(If you already have a spell-checker or similar here, you can run that from
within Tag-O-Matic) 

External
--------
Tag-O-Matic is setup pretty much the same as v.4 if you're using an external
editor. Make sure you comment the line (in TM.CFG) line so:

%InternalMsgEditor

Read the above (V.4) section for the rest of the details, or check out 
T-TM5.CFG


        _Advanced features of Tag-O-Matic and Termail_
        ==============================================

There are some extra features of Tag-O-Matic that work well with Termail.
These can be called on the command-line, or from one of the function keys
in Termail.

Eg:
(Change TM.CFG for the following)

ShiftF1    Adpt  T-MATIC /S {tagfile} !MSG !W

        This will steal any taglines from the current message displayed in
        Termail, and append it to {tagfile} when you press SHIFT+F1

(V.5) Since Termail reformats the message by default, it will strip taglines
from the message so this function will not work. If you use this function,
you can tell Termail not to delete taglines. To do this, load TM.RFM into
your favourite text editor.

Insert a comment (%) in front of the two lines: 

R "... "
R ".!. "

(Like so)

%R "... "
%R ".!. "

This has the side effect that taglines aren't deleted when you edit the 
message.

(v.5) You can use Tag-O-Matic to add a tagline to a message on a one-by-one
basis too. Define another function key (we'll use SHIFT+F2 here)

ShiftF2    AddT  T-MATIC !MSG !R

You can do this for any of the Tag-O-Matic switches, such as stealing taglines
or de-duping your tagfile.

        _Using Macros in Termail_
        =========================

(If you're using a version of Termail greater than 4, it has MSGINFO.SYS
support. What this means to you is that Tag-O-Matic can get all the
information it needs from a dropfile, so you can safely ignore this
section. Just ensure that in T-MATIC.CFG, the following entries are set:

UseMSGINFO=YES
MSGINFOVersion=1
MSGINFOOnlyGroup=NO

See T-MATIC.DOC and T-MATIC.CFG for full details on these switches.)

If you're using Termail 4 or less, or if you just don't want to use
MSGINFO.SYS, then...

You need to do some complicated stuff to get headers to work properly, but
nothing too strenous. Again, editing TM.CFG, locate the templates.

The first should look something like this:

Template    1
MsgStart    To: @FROM@CR
MsgEnd      @CRFrom: Simon Avery
MsgQuote    Howdy @F!@CR

Change this to the following. (Exactly - remember you can change the actual
headers and footers in T-Matic to resemble what you had before)

Template    1
MsgStart    ~NAME @F @L@CR~SUBJECT @SUBJECT@CR~ORIGFROM @FROM
MsgEnd
MsgQuote

This means that when Termail prepares a message for editing, it will start the
message with:

~NAME Name of other person
~SUBJECT Subject of message
~ORIGFROM Name of third person

Note the use of @CR to force a new line. Each macro MUST be on a seperate
line! If you wish to use seperate config files for different groups, there 
is another macro you can use here:

~CONFIG Config_file

Eg:

MsgStart    ~NAME @F @L@CR~SUBJECT @SUBJECT@CR~ORIGFROM @FROM@CR@~CONFIG FIDO.CFG

This tells T-Matic to use another config file. Because Tag-O-Matic is already
running, it will have already used a config file, but the new will overwrite
any previous values... If your OLR supplies a group or other area-specific
string, you can amend the Edit string to something like:

Editor      T-MATIC @FILE @GROUP.CFG

Termail doesn't support this in the Editor string. 

By the time Tag-O-Matic calls the editor, these should all have gone, as
Tag-O-Matic reads them in to know what's going on. It then deletes them to
keep things tidy. You can then enable macros in Tag-O-Matic's config.

Full list of T-Matic macros:                  Termail's Equivalent
--------------------------------------------|--------------------------------
~NAME (Name of other person)                 @FROM
~SUBJECT (Subject of message)                @SUBJECT
~ORIGFROM (Name of third person)             @TO
~CONFIG (Config_file)                        N/A
~ORIGDATE (Original date of quoted message)  @DATE
~ORIGTIME (Original time of quoted message)  @TIME


	_Blue Wave_
	===========

There is an example config file for use with BlueWave 2.30 (and maybe other
versions) in the EXAMPLES.ZIP file. There are also instructions in there 
for setting up Bwave to cope with Tag-O-Matic.

Note that although Bwave says it will only work with John Hancock as
a tag manager, it's easy enough to work around. Tag-O-Matic _does_ have
an option to mimic JH, but it shouldn't be needed.

        _Generic Mailers_
        =================

This method will work with 99% of all Fidonet mailers. Any mailer that will
allow you to use an external editor will work. (Timed and Golded are special
cases, see below)

Where the mail program asks you for the filename of your text editor, replace
this with "T-MATIC" (sans quotes). Note that you may have to supply the
filename for the message, or a macro, or the program may automatically
append the message filename to the end of this.

There is an example config file for Golded in the EXAMPLES.ZIP file, along
with some (untested!) instructions by Dylan Sides. The file is T-GOLD.CFG
and you should overwrite T-MATIC.CFG with it.

With Golded or Timed, if you wish to use the internal editor - then things
get a little more complicated. As I understand it (I don't use either) they
can only call another program after they're finished, thus the tagline
appears after their own tearline. Use of the ~TAG locater (and enabling
TagLocate in the config) can overcome this. Including ~TAG into your
standard sig can speed things up.

Have a read of the Termail section in this file to see if there are any of
the other features (groups, macros etc) that you might be able to use. It's
beyond the scope of this document to cover everything for all mailers, so
it's left a little up to you.

        _Email_
        =======

The status of Windows / OS2 Email programs and DOS tagline tools is somewhat
murky, but it can be done. To do so successfully, you need to know a little
how each program works.

Tag-O-Matic needs a text file to work on in order to add a tagline. Since
it doesn't have access to the message file of most (if not all) Windows
message editors, then you need something else. A lot of email programs
allow for a sig (or signature) file to be added automatically. It is this
that Tag-O-Matic can work on. You need to create a sample sig file,
and find out what it's called. Also, you need to make sure that you make
a copy of the original sig file before Tag-O-Matic is run, otherwise it'll
only work once before it complains that it already has a tagline.

For example, Eudora 1.5.4:
             =============

[In Eudora]
Click "Tools" then "Signature"
This takes you to a dialog box where you design your standard signature.
(If you want to use random sigs, then it's a little more tricky but it can
be done. Basically, you just treat the Eudora sig file as the message file
and setup T-matic as per a dos prog.)
Design this as you like, but it must contain at least something (even if it's
just a blank line, to force Eudora to actually SAVE the sig file)

Go to Eudora's dos directory (it helps if you're in dos to do this).

Copy SIGNATUR.PCE to SIGNATUR.OLD
Copy T-Matic's files to this directory.

Create a batchfile akin to:

COPY SIGNATUR.OLD SIGNATUR.PCE
T-MATIC SIGNATUR.PCE

(or T-MATIC /F SIGNATUR.PCE if you want it done automatically)

You can then create a program icon or shortcut to this batch file.
This means that T-Matic won't be called automatically for every
message you write. However, there will always be a tagline on your
sig, it just won't be updated until the next time you run the batch
file. Once a day should be enough, but it's up to you.

Netscape 2.x also uses this system, and probably most others too.

-End of File-
