X-Git-Url: https://the.earth.li/gitweb/?a=blobdiff_plain;f=docs%2FREADME.Multiple_Configs;fp=docs%2FREADME.Multiple_Configs;h=0000000000000000000000000000000000000000;hb=49c39d47502a7485e7e63f7cbea8325852d25967;hp=c8903a7f531c0159c874ce1bd461605c6fbe2d8e;hpb=05869f1bf3fb39b81155235901cae1ba99b9b359;p=htag.git diff --git a/docs/README.Multiple_Configs b/docs/README.Multiple_Configs deleted file mode 100644 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