
	  Hilfe.txt
	=============

   Der Zweck des Skriptes 'MailMan' ist es, vom Mailreader aus die im 
   Mailfilter des Hamster 'hngengebliebenen' Mails nachladen oder 
   entsorgen zu lassen. 

   Am sinnvollsten ist immer die Angabe der Message-ID (sofern
   vorhanden). Da die Hochkomma vom Script ntigenfalls ergnzt 
   werden, kann die betreffende Headerzeile unverndert ins Subject
   kopiert werden.
   
   Als Nebeneffekt kann man damit aber auch den Hamster-Mailfilter vom 
   Mailreader aus (zumindest begrenzt) steuern, indem man quick and 
   dirty Eintrge vornimmt (z.B. um weiteren Spam zu blocken). 

   Allerdings empfiehlt es sich bei extensivem Einsatz dieses Skriptes 
   (und auch sonst <g>), die Datei Mailfilt.hst in regelmigen 
   Abstnden manuell 'aufzurumen'.
   

   Das Subject einer Mail an den Account mu folgendem Aufbau
   entsprechen:

	[ "=" ] ( "load" | "kill" ) 1*WSP MDefaultField 1*WSP MPattern

        MPattern  = | <Text>
        MPattern  = | PatSimpleText
        MPattern  = | "'" 1*( 1*WHSP MSelectPattern ) "'" )

   'MDefaultField', 'PatSimpleText' und 'MSelectPattern' sind in der 
   Hamster-Onlinehilfe unter dem Punkt MailFilt.hst definiert. 

   Die verscheidenen Varianten fr 'MPattern' werden vom Skript 
   folgendermaen behandelt:

   <Text> wird in der MailFilt.hst in Hochkomma eingeschlossen.
        Fhrende und nachfolgende Leerzeichen werden dabei entfernt
        (nicht jedoch eingebettete Leerzeichen). Beispiel:
	`load From:   Wolfgang   Jth   
        -> `load From: "Wolfgang   Jth"

   PatSimpleText wird 'as is' eingefgt. Es werden weder Leerzeichen
        noch die Anfhrungszeichen entfernt. Beispiel:
	`load From: "  Wolfgang  Jth  "
        -> `load From: "  Wolfgang   Jth  "

   "'" 1*( 1*WHSP MSelectPattern ) "'" ) wird 'as is' geschrieben.
        Es werden allerdings die Hochkomma entfernt. Diese Variante
        ist fr den Fall gedacht, da mal jemand komplexere Pattern
        bergeben will. Dann kann es natrlich sein, da zumindest
        am Anfang kein Anfhrungszeichen steht. Ohne diese
        'Spezialbehandlung' wrde das Pattern als <Text> behandelt
        und komplett in Anfhrungszeichen eingeschlossen. Beispiel:
	`load From: '+"Wolfgang" +"Jth"' 
        -> `load From: +"Wolfgang" +"Jth" 

   Jede Regel wird an das Ende der Datei MailFilt.hst unter einem
   neuen Abschnitt ('[*]') eingetragen. Eventuell vorher zutreffende 
   '='-Regeln (z.B. '=ignore') knnen jedoch die Ausfhrung 
   blockieren.

   Zu jeder Regel wird als Kommentar dazu notiert, wann das Skript
   den Eintrag erzeugte (d.h. die Datei beschrieb), und von welchem
   User es dazu veranlasst wurde. Damit kann man schnell feststellen,
   welche Regeln (z.B. zum Nachladen von Mails) inzwischen berflssig 
   geworden sind und wieder entfernt werden knnen.

   Beispiel:
       Load Message-ID: <local.part@full.quallified.domain.name>
   ergnzt MailFilt.Hst am Ende um den Eintrag
       [*]
       load Message-ID: "<local.part@full.quallified.domain.name>"

   Weitere Beispiele:
       Kill Any-Sender MoneyMaker
       Kill Subject '+"Earn" +"$" -{^(fw|aw)}'

