
	  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 (""" <Text> """) 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 man einmal komplexere Pattern
        bergeben will. Dann kann es natrlich sein, da zumindest
        am Anfang kein Anfhrungszeichen steht. Ohne diese
        'Spezialbehandlung' wrde das komplette Pattern dann als 
        <Text> behandelt und auch komplett in Anfhrungszeichen 
        eingeschlossen. Beispiele:
	`load From: '+"Wolfgang" +"Jth"' `
        -> `load From: +"Wolfgang" +"Jth" `
	`load Reply-To: '"hamsternet" -@From:"Jth"'`
        -> `load Reply-To: "hamsternet" -@From:"Jth"`

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

   Zu jeder Regel wird als Kommentar dazu notiert, wann das Skript
   den Eintrag erzeugte (d.h. die Datei beschrieb), und von welchem
   User (From:-Header) 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)}'

