Erste Revision eines Quelltextes mit dem Revision Control System
----------------------------------------------------------------

   Ausgehend von dieser Situation will ich nun die Aktionen
beschreiben, die MagicCX bei der Erstanwendung des Revision Control
Systems durchl�uft. Es wird ein Fenster ge�ffnet, das folgenden Titel
tr�gt:

                   Enter a Purpose Message

   Wie der Titel schon vermuten l��t, wird hier nach einer
Beschreibung der Aufgabe des Programms/Programmteils gefragt, die
MagicCX f�r Sie in den Header eintragen soll. Sie haben hier die
M�glichkeit bis zu f�nf Zeilen � 60 Zeichen einzugeben.  Sind Sie mit
der Eingabe zufrieden, stehen Ihnen weitere Eingabem�glichkeiten zur
Verf�gung. Sie k�nnen MagicCX sagen, mit welcher Versionsnummer das
Programm beginnen soll. Diese Eingaben werden in den beiden Integer
Gadgets am unteren Rand des Fensters gemacht. Im linken Gadget k�nnen
Sie die Versionsnummer eintragen.  Im rechten Gadget tragen Sie dann
die Revisionsnummer ein.

   Die "INITIALVER" und "INITIALREV" Optionen des RCS Kommandos k�nnen
benutzt werden, um die ausgehende Version/Revision der ersten Revision
zu setzen. Nutzen Sie diese um die Integer Gadgets zu setzen.

   Wenn Sie einen Header vor den neuen Header einf�gen m�chten, so
geben Sie mit "INSERTBEFORE" eine Datei an, die eingef�gt werden soll.
Ein Header nach dem neuen Header wird eingef�gt durch die
"INSERTAFTER" Option, die ebenfalls eine Datei erwartet.

   Das linke Integer Gadgets dient der Eingabe der Versionsnummer,
w�hrend das rechte f�r die Revisionsnummer steht. Die Gadgets OK und
CANCEL sind selbsterkl�rend. W�hrend OK die Revision startet, bricht
CANCEL ab.

   Ausgehend davon, da� Sie alle Werte Ihren W�nschen entsprechend
eingetragen haben und OK selektiert wurde, will ich nun die Aktionen
beschreiben, die MagicCX ausf�hrt, um den Header anzulegen. Zu
allererst wird ein Teil des Standardheaders erstellt.  Die Erstellung
des Headers erfolgt in T:. In den Header werden, je nachdem ob die
Variablen gesetzt sind, der Name des Autors und der Name der `Firma'
eingetragen. Falls MagicCX eine, oder gar beide Variablen nicht finden
konnte, so werden die entsprechenden Felder mit `--- Unknown ---'
belegt. Es wird weiterhin der �bergebene Filename, sowie das aktuelle
Systemdatum eingetragen. Die aktuelle Revision wird auf die von Ihnen
angegebene, bzw. die von MagicCX vorgegebene Zahl gesetzt. Es wird nun
der `Purpose' Text eingef�gt und zu guter Letzt wird eine `Log
Message' dieser Revision erzeugt. Diese Log Message wird bei der
Erstrevision auf `--- Initial release ---' gesetzt, da anzunehmen ist,
da� keinerlei Ver�nderungen vorgenommen wurden (schlie�lich ist es
ja ein ganz jungfr�uliches Programm). Hinter die Log Message werden
sechs Makros eingepflanzt, die das Datum der Revision, die Zeit der
Revision, den Namen des Autors, der die Revision durchgef�hrt hat, die
aktuelle Revisionsnummer des Quelltextes und zwei weitere Makros, die
die Versions- und Revisionsnummer als Zahlen wiederspiegeln.  N�here
Informationen zu den Makros und dem Aussehen des Headers entnehmen Sie
bitte dem Abschnitt  Spezielle Eigenschaften.  Der Revisionheader wird
bei der Erstellung am Anfang des Quelltextes erzeugt.  Sie m�ssen also
Zeilen, die vor dem Header stehen sollen, nachtr�glich eintragen.