Ein blitzkurzer Infotext zu THE_CIRCLE:
=======================================

Mit Hilfe von THE_CIRCLE ist es mglich, im MausTausch-Frontend THE_DOT 
von Jochen Herz (Hi NUNZ!) Serienmails (z.B. fr Einladungen oder sowat) zu 
verschicken. Solche Schreiben nennt man auch Rundschreiben und weil das 
rundeste, was man sich vorstellen kann (von mir abgesehen), ein Kreis ist, 
heit das Ganze 

	THE_CIRCLE. 	Schubidu.

In THE_DOT wird seit der Version 2.11 eine Schnittstelle zu THE_CIRCLE zur 
Verfgung gestellt: Im Men "Programme" gibt es den Menpunkt "zu CIRCLE...". 
Bei dessen Anwahl wird im MODULE-Ordner nach CIRCLE.PRG gesucht und bei 
Erfolg gestartet. Als Parameter wird der komplette Pfad des momentan in 
THE_DOT eingestellten INF-Files bergeben. Aus diesem entnimmt THE_CIRCLE 
Informationen ber die Message- und Workordner-Struktur.

Die vorliegende Version ist inzwischen 1.0 und sie hat weniger Fehler als die
0.99. Unter Umstnden kommt es natrlich nach wie vor zu nicht ganz narren- 
sicheren Komfortproblemen und Runtime-Fehlern wegen eventuell nicht gefundener 
Dateien oder Pfade. Da ich's aber trotzdem verffentlicht habe, ist jeder, der 
THE_CIRCLE benutzt, hiermit hochoffziell zum THE_CIRCLE-Tester ernannt.



THE_CIRCLE IST TAFEL_SCHOKOLADE_WARE!

Jeder, der's mal benutzt, und dem's gefllt, nehme eine 200er Briefmarke 
und klebe sie auf eine Tafel Schokolade seiner Wahl. Wenns eine ist, fr 
die man eine 300er Marke braucht, umso besser! Dann noch meine Adresse 
drauf (steht auch in jedem CoNnect-Handbuch):

	Philipp Oelwein
	Ringelsgasse 22 a
	69226 Nuloch

	Maus: Philipp Oelwein @ HD
	      Philipp Oelwein @ LU

und in den Briefkasten mit der ganzen Geschichte. Ich versichere hiermit 
meinen ewigen Dank.

WARNUNG: Keine Haftung fr Software oder Hardwareschden jedweder Art, die
			durch THE_CIRCLE eventuell hervorgerufen wurden! Das Programm 
			arbeitet direkt in der SENDEN-Messagebase, und wenn man groben 
			Unfug baut (man mu sich dafr aber schon sehr anstrengen, mehr 
			dazu siehe unten), ist das SENDEN-Brett nicht mehr lesbar und 
			auch nicht mehr crunchbar. In dem Fall SENDEN.IDX und SENDEN.DBS 
			in den Mlleimer und ausgehende Mail neu schreiben.


Kurz zur Bedienung:

Normalerweise wird man THE_CIRCLE von THE_DOT aus aufrufen (Men "Programme", 
Punkt "Zu CIRCLE...").

THE_CIRCLE erwartet, im MODULE-Ordner von THE_DOT zu liegen und versucht, im 
INTERN-Ordner von THE_DOT das THE_DOT-Konfigurationsfile THE_DOT.INF zu laden. 
THE_CIRCLE versucht, seine eigene Resourcedatei im aktuellen Pfad, im 
MODULE-Ordner ind im INTERN-Ordner zu finden und zu laden.

Wenn irgendetwas von dieser Ordnerstruktur nicht vorliegen sollte und 
THE_CIRCLE auch mit seinen gewieften und ausgeklgelten Suchroutinen die 
Strukturen auch nirgendwo anders findet - rumms - Runtime Error 2 ;*)

THE_CIRCLE kann natrlich auch "stand-alone" gestartet werden. Als Parameter 
kann, wie gesagt ein Pfad eines DOT-INF-Files bergeben werden. Ohne Parameter 
wird als INF-File THE_DOT.INF angenommen. Sollte ein ungltiger Pfad bergeben 
werden, oder sonstwie eine Datei nicht gefunden werden, erscheint eine 
Fileselectorbox, in der man ein INF-File auswhlen kann.

Wenn aber doch alles da ist, entnimmt THE_CIRCLE daraus, wo sich der Pfad fr
die Dateien SENDEN.DBS und SENDEN.IDX befindet. Dort werden spter die 
Serienmails hingeschrieben. Weiter wird aus dem THE_DOT.INF der jeweilige WORK-
Pfad entnommen. 

THE_CIRCLE wird erstmal annehmen, da sich dort die zwei Dateien mit 

	a) dem Serienbrieftext  MAILTEXT.TXT und  
	b) der Empfngerliste ADRESSEN.TXT 

befinden. Wenn das nicht der Fall sein sollte - auch nicht schlimm, das ist 
einer der Flle, wo ich den File_Not_Found rechtzeitig abgefangen habe (glaub' 
ich jedenfalls...) und die Dateien, in denen sich diese Infomationen befinden, 
sind ohnehin frei konfigurierbar. Anyway.

Nun kommt der Bedienungsdialog auf dem Bildschirm - er besteht aus drei Zeilen 
mit Pfadinformationen und einer Editzeile fr den Betreff der Serienmail.

1. Der Messageordner
		ist der, den THE_CIRCLE aus dem INF-File von THE_DOT erhalten hat und 
		in dem sich die SENDEN-Files befinden sollten. Diese Zeile kann zwar 
		gendert werden, das ist aber ziemlich obsolet - was in THE_DOT.INF 
		steht, mu ja irgendwie schon stimmen, ein Artefakt aus CIRCLE-
		Versionen < 0.35. Vielleicht mach' ich das mal raus.
		
		0.96: ndern kann man ihn nun nicht mehr, aber er ist noch da...
		
		0.98: Jetzt ist er weg und von den folgenden Numerierungen ist jeweils
		      ein Offset von 1 (eins) zu subtrahieren:

2. Der Mailtext
		ist die Datei, deren Inhalt als gleichlautende Mail an alle Empfnger
		geht. Ein simpler ASCII-Text. Voreingestellt ist WORK\MAILTEXT.TXT, aber 
		die Zeile kann gendert werden, entweder "von Hand" oder durch Mausklick,
		whrend man sich mit dem Mauscursor dort befindet. Dann geht ein 
		Fileselector auf, der auf die Extension TXT voreingestellt ist, und mit 
		dem man eben die Textdatei auswhlen kann, die als Mail gesendet werden 
		soll. Irgendwelche Platzhalter oder Makros innerhalb des Textes wie 
			
			"Liebe[%Sex] [%Anrede] [%Receiver]! Heute am [%Date] um 
			[%Time] blablabla.."

		sind *nicht* vorgesehen! Serienbriefe sollen gleich lauten! Howgh!

3. Die Adreliste
		ist ebenfalls eine ASCII-Datei, in der pro Zeile ein Empfnger steht und 
		zwar in einem Format, wie es die MAUS als Empfngeradresse verarbeiten
		kann - einfach das gleiche, was man sonst "von Hand" in die Empfnger-
		zeile eintragen wrde, also zB
		
			Philipp Oelwein @ HD
			Jochen Herz @ LU
			Reiner Juhser @ Fido 2:267/6652.1
			Hans Dampf @ dingsdabox.zer.sub.org
			internet_user@cray1.rechenzentrum.uni-irgendwo.de
		
		Voreingestellt ist ADRESSEN.TXT. Kann genauso gendert werden wie 
		die Datei fr den Mailtext.
		
4. Die INF-Datei
	ist die THE_DOT-INF-Datei, aus der die Informationen ber die Pfade usw. 
	gelesen werden. Wenn also mit THE_DOT mehrere Netze oder Accounts bedient 
	werden, kann hier eine andere INF-Datei (auf die gleiche Weise wie oben) 
	ausgewhlt werden, so da in dem Fall auch auf ein anderes SENDEN-Brett
	zugegriffen wird. Falls das der Fall ist, und in dieser Zeile eine andere 
	INF-Datei ausgewhlt wurde, sollte in den Zeilen fr die TXT-Dateien 
	auch der entsprechende WORK-Pfad automatisch eingetragen werden. Falls nicht: 
	bitte sofort in ziellose Panik verfallen und mir eine entsprechende Meldung
	zukommen lassen, damit ich ganze Nchte mit dem Debuggen zubringen kann.
	

5. Der Betreff
	Der Text, der in dieses Feld eingetragen wird, wird als Betreff fr die 
	Serienmail verwendet. So einfach ist das. Man kann ihn auch leerlassen, 
	dann nimmt THE_CIRCLE den Text  "Heute kein Betreff" als Betreff.
	

Die Execute-Buttons
	Raum und Zeit nochmal, was soll ich da noch erklren???
	
	"Absenden!" sendet und "Abbruch" tut's nicht. Punkt.

Links unten ist noch ein bisher disableter Schalter namens "Verteiler" zu 
sehen. In einer spteren CIRCLE-Version kann man damit auswhlen, ob an jede 
der Serienmails noch eine Liste aller Empfnger der bewuten Serienmail an-
gehngt werden soll.

	Momentan noch Einschrnkungen:

		- Betrieb nur fr MAUSnetz
		- Lnge der Serienmail max. 5000 Bytes
		- Keine Erkennung der Plausibilitt der Adredatei oder der Mailtext-
		  datei. Wenn jemand glaubt, er mte THE_CIRCLE mal mit TEX.TTP als
		  Mailtext und mit CIRCLE.TXT als Adredatei ausprobieren - viel Spa!
		  Ich bernehme keine Garantie bei Abstrzen und MsgBase-Unfllen!!


Viel Spa also!



Danksagungen:
	
	- Jochen fr THE_DOT
	- Wolfgang fr CoNnect
	- der Gatzweilers Brauerei fr Ihr_wit_schon_was
	- Mendelssohn fr die Variations serieuses, op. 54
	- Douglas Adams
	



0.95
----
	Erste verffentliche Version. Nur noch 5% Fehler drin.

0.96
----
	Der aktuelle Pfad wird beim ndern von Mailtext- oder Adredateien gendert,
	daher wurden relativ gesuchte Dateien (.INF) nicht wiedergefunden.
	
	Die Info-Zeile fr den Message-Ordner ist nun eine reine Anzeige-Zeile und
	nicht mehr zu ndern.
	
	Nur noch 4% Fehler.

0.97
----
	An THE_CIRCLE kann als Parameter ein kompletter Pfad eines THE_DOT-INF Files
	bergeben werden. Auf diese Weise kann THE_CIRCLE direkt aus THE_DOT heraus
	aufgerufen und bedient werden. THE_DOT bergibt den Pfad des derzeit einge- 
	stellten INF-Files. Danke, NUNZ!
	
	Diverse "Abbruch"-Auswertungen bei Fileselectorboxen werden jetzt vernnftig
	abgefangen. Wahrscheinlich aber immer noch nicht alle.
	
	Nach Umherschalten des aktuellen Pfades wird dieser bei Programmende wieder 
	auf "den alten Stand gebracht".
	
	Restfehler: 3%
	
0.98
----
	THE_CIRCLE sucht seine Resourcedatei jetzt im aktuellen Pfad, im MODULE- 
	und im INTERN-Ordner von THE_DOT.
	
	Fehlerhafte INF-Dateipfade werden nicht mehr durch einen Runtime Error 2, 
	sondern durch eine Fileselectorbox abgefangen, in der ein INF-File bestimmt 
	werden kann.
	
	Und nur noch 2% Fehler!
	
0.99
----
	Die Fileselectbox bei fehlerhaftem INF-Pfad bekommt man nun solange 
	prsentiert, bis man Abbruch whlt oder eine existierende INF-Datei.
	Da das auch wirklich eine THE_DOT-INF-Datei ist, darauf sollte man aber 
	schon selbst achten!
	
	Yupiie! Nur noch 1% Fehler! Das sind immernoch 121 Bytes... Mal sehen, 
	ob ich die nicht noch finden kann.
	
1.00
----
	Fr die Pfade stehen jetzt 10 Zeichen mehr zur Verfgung. (Fr die Leute,
	die ihre DOT-Ordnerstruktur hnlich tief geschachtelt haben wie ich.)
	
	Und Fehler sind jetzt auch keine mehr drin. Jedenfalls weniger als Epsilon.
	
	Also ab in die Boxen damit.
	
	
	
Geplant:
--------
	- Plausibilittsprfung fr Mailtext- und Adredatei
	- Plausibilittsprfung fr ausgewhlte INF-Datei
	- Verteiler (alle Empfnger) in die Mail bernehmen
	