L L L L LL LL LL LL L L L L L L L L L L L L L L LLLLL L L LLL LLLLL LLLLL LLL L LLLLL LLLLL LLLL L L L L L L L L L L L L L L L L L L LLLL L L L LLLL LLLL L LL LL L L L L L L L L L L L L LLL L L LLL LLLL L LLLLL L L L L LL L LL L L L L LL L L L L L L L L L L L L L L L L LL L L LLLL (C) 1996 Robert Hofmann 1. Introduction =============== 1.1 Legal stuff --------------- MM_TwitFilter is, as the name already says, a twit-filter for Mail Manager by Pino Aliberti. The programs and files in this distribution are freely distributable, but are also Copyright (c) Robert Hofmann. They may be freely distributed as long as no more than a nominal fee is charged to cover time and copying costs. No commercial usage is permitted without written permission from the author Everything in this distribution must be kept together, in original unmodified form. MM_TwitFilter is mailware :-). This means if you use it, please write me a short mail. You know, it is frustrating to write programs and there are no responses from the users if they like it or not... Accepting these few points is the only condition for using MM_TwitFilter... ============================================================================= The author is not responsible for any problems caused by using this program! ============================================================================= 1.2 General stuff ----------------- I am not the best in writing doc, but quiet good in coding I think :-) This docs are a bit short I have to appolognize, but I hope you'll understand it anyway... Especially my English and the typo's ;-) If there is anybody out there who is able to & wants translate the docs to his own language, please do so and send them to me! I'll add them to the next release. Also translators always will get the newest betas! ;-) Unfortunatly I don't have the will & time to translate my docs even to German - my time is better used for coding :-) 1.3 Author ---------- If you have suggestions or remarks about this program, or if you find any bugs, please let me know. Contacting the author: Internet .. : robert@next.amistep.osn.de (soon!) FidoNet ... : 2:2490/1015.0 (may change soon!) AmigaNet .. : 39:171/101.0 Snail-mail : Robert Hofmann Volkmannstr. 35 D-90443 Nürnberg Tel. +49-(0)-911-9941680 (18-20h German time only!!!) Germany Bank-Account: Account-holder: Robert Hofmann Account-number: 67920 Bank-ID ..... : 76090000 S.W.I.F.T.code: GENO DE MV 760 Bank-name ... : Volksbank Nuernberg e.G. 2. Features =========== MM_TwitFilter... ... is configurable per area & global ... is able to check single, multiple or all areas ... has a full AmigaDos-wildcard-support ... is able to search over all msg-fields (single or combined!) ... can use the DEL-flag or physically deletes the msg ... has an advanced cfg-read-meachanism ... does only process #ECHOAREAs, excluding own msgs 3. Installation =============== 1. Copy the files to the related MM:-directories. 2. Adjust the cfg to your own needs. 3. Add it as last entry to your import-batch or whatever else you use. 4. Add the following line to your MM.cfg: #BROWSEMENU "Filter this area" "rx MM:Rexx/MM_TwitFilter %a" "" IMPORTANT: MM_TwitFilter.rexx *MUST* be placed in "MM:Rexx/"!!! This is necessary because MM_TwitFilter appends its cfg to the script itself for a *VERY* fast cfg-reading. *** NEVER TOUCH ITS FILENOTE!!! *** As you may have seen, there's a second script called "MM_TwitFilter.rexx.cmp" included. This is a exacltly the same script as "MM_TwitFilter.rexx" itself, except that it was compressed with "CompressRexx v2.1". On slow machines, it might be useful to replace the uncompressed script with the compressed one because it is slightly faster... But please test it first with the uncompressed version, because if an error occurs, finding the error due to error-reports of the compressed script is nearly impossible! If you really want to use the compressed script, you have to REPLACE the un- compressed script with the compressed one! The used script MUST exactly named "MM:Rexx/MM_TwitFilter.rexx", otherwise it will not work! 4. Usage ======== [RX] MM_TwitFilter[.rexx] AREA,SETDEL/S AREA Areatag. If not present, all configured areas will be filtered. SETDEL Instead of directly deleting the msg, it will be flagged as 'DEL'. This is much slower than simply deleting the msg! 5. Configuration ================ 5.1 #AREA ------------------- The areatag of the area. Kill KillFrom KillTo KillSubj The pattern must be a valid AmigaDos-wildcard (see e.g. the example-cfg). Multiple statments are possible, but slower that if you use advanced wild- cards, e.g. KillFrom "Joe User" KillFrom "Henry Twit" is the same like KillFrom "*(Joe User|Henry Twit)*" but the second example is much faster! 5.2 #ALL -------- This is the global entry. You must not set an areatag here, of course :-) The usage of Kill*-keywords is the same as in 5.1. 6. Theory of operation ====================== MM_TwitFilter normally should be started directly after your import, so that all twits can be filtered out immediately. It will only be searched for SENT msgs not written by you yourself. For every Kill-statement it will be started one search. So the more statements you use the slower it will be. If you want to try it out, just use SETDEL/S, so the msgs will not be deleted immediately, but only flagged as DEL, so you can clear this flag if you made a mistake. IMPORTANT NOTE: It would be an excessivly annoying behaviour if you modify the script and use it on TwoPassImport-areas to filter people you don't like!!! PS: I've not fully tested it, so there might be some bugs left. Please report them to me! 7. Acknowledgements =================== Pino Aliberti For his EXCELLENT Mail Manager! For implementing nearly all I wanted (this was much work I think and delayed the release of MM for some month ;-)) For our hard but fair fights in MMBETA and at least for the nice note about me in the docs 8^)))) _ o Robert Hofmann 2:2490/1015@FidoNet 37:108/220@TrekNet |<)_/# 39:171/101@AmigaNet 107:1805/230@TrekNet TT