Import Debian changes 0.0.23-1

[htag.git] / docs / README.Multiple_Configs

diff --git a/docs/README.Multiple_Configs b/docs/README.Multiple_Configs
deleted file mode 100644 (file)
index c8903a7..0000000
--- a/docs/README.Multiple_Configs
+++ /dev/null
@@ -1,65 +0,0 @@
-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>