Multiple Config Support
=======================

Please read the README/INSTALL before reading this document.

In 0.0.18 this changed to eval your per header configs *after* the main
config file as opposed to only evaluating one config file making it easier
to see what is different about a particular config but breaking backward
compatibility for those that used Multiple Config File support.  Sorry.
Complain at me.

Multiple Config Support allows that you can reply to different people or
different newsgroups with different plugins.

This is what htag.pl does when it starts up wrt configfiles:
	- checks to see if one is specified on the commandline
	- if not defaults the basecfgfile to ~/.htrc
	- evaluates the basecfgfile
	- checks to see if $cfg{'changeheaders'} is defined and if so checks
	  whether those patterns match the headers it has for the message.
	  If they match it runs this extra config file.

So to get this working you just need to create one config file with your
defaults and your changeheaders patterns and extra config file names.  Then
create the extra config files you've mentioned in changeheaders.

changeheaders syntax is something like:
$cfg{'changeheaders'} = [
	[ 'pattern_to_match', 'more optional patterns', 'config filename' ],
	one or more lines like above
	];

The patterns are ANDed together.  If you want OR just create multiple lines.

$cfg{'changeheaders'} = [
	[ '^From:.*support\@blackcatnetworks.co.uk', '~/.htagrc/support' ], 
	[ '^Newsgroups:.* fr\.', 'From:.*huggie\@foo.com',
	  '~/.htagrc/fr-foo.com' ]
	];

The first example matches all messages which I send out with a From: line of
support@blackcatnetworks.co.uk so that I can append reassuring signatures to
our customers - I don't actually do this ... yet :)
The second is a contrived example which matches a Newsgroup line which has
somewhere a group that starts with "fr." and where the From: line contains
huggie@foo.com

There is a way of having a config per address but still only having one
rule.  Put a rule which has an empty config file and at least one rule which
should (if it matches) produce the config file name in $1 (the first
parenthesized match).
e.g.
	[ '^From:.*?(\w+)@earth.li','~/.htagrc/earth-li-$1' ],

Then for every mail sent from something@earth.li it will use the config
"~/.htagrc/earth-li-something".

This could be used for instance to have a different config per From: address
(i.e. when you send from company From: addresses, and from personal From:
addresses and want to have different configs per address).

This documentation was written when I hadn't had enough sleep.  Sorry.
Corrections/clarifications/rewrites/chocolate welcomed.

Simon Huggins <huggie@earth.li>