Das Revision Control System
===========================

   Dies ist wirklich eine sehr nette Funktion. Sie ist sicherlich f�r
die Programmierer unter Ihnen interessant, die an gr��eren, oder auch
an kleineren Projekten arbeiten.  W�hrend der Entwicklung eines
Programms ist es bestimmt f�r einige Programmierer wissenswert, was
von einer zur anderen Version an einem Programm ge�ndert wurde. Diese
Daten in m�hevoller Kleinarbeit einzutippen, ist sicherlich keine
dankbare Angelegheit.  Hier setzt nun MagicCX`s Revision Control System
ein. Diese Programmfunktion hilft Ihnen ansprechende Revisionsheader
direkt in den Quelltext einzubinden. Alles, was Sie noch dabei tun
m�ssen ist dem Programm zu sagen, f�r welche Art Quelltext Sie den
Header erstellt haben wollen und was denn nun hineingeschrieben werden
soll. Bei der Art des Quelltextes stehen Ihnen vier zur Verf�gung.
MagicCX kann Header f�r Assembler, Basic, `C' und Pascal/Modula
erstellen. Die Grundform der Header wird dabei zwar nicht variiert,
aber diese Auswahl ist wichtig, so da� sich die Header ohne Probleme
in den Quelltext einf�gen.

   Eine Besonderheit ist der Aufruf dieser Funktion. Das Revision
Control System kann nur �ber ARexx angesprochen werden. Deswegen sei
hier einmal die Aufrufsyntax f�r diesen ARexx Befehl vorweggenommen:

REVISE FILE=Filename MODE=ASM|BAS|C|PAS PUBSCREEN=<NAME>

INITIALVER=N INITIALREV=N INSERTBEFORE=<FILE> INSERTAFTER=<FILE>

   Sie sehen, alles, was Sie der Funktion mit auf den Weg geben m�ssen
ist ein Dateiname und ein Bezeichner, der die Art des Quelltextes
angibt. Die weiteren Optionen sind optional und beziehen sich nicht auf
jede Revision. Nachdem das Revision Control System gestartet wurde
sucht das Programm im Quelltext erst einmal nach einem bereits
existierenden Header in der angegebenen Sprache. Dabei ist es nicht
wichtig, da� der existierende Header in der ersten Zeile des
Quelltextes steht. MagicCX sucht innerhalb der folgenden Zeilen nach
dem Beginn des Headers. So ist Ihnen die M�glichkeit gegeben, weitere
Informationen vor den eigentlichen Header zu setzen(1). Egal, ob ein
Header vorhanden ist oder nicht, diese Suche wird immer gestartet, wenn
man das Revision Control System aufruft. Ab dann teilt sich der Weg,
den MagicCX geht, in zwei. Je nachdem, ob ein Header bereits existiert
wird nun entsprechend weitergemacht.

   MagicCX wird mit einigen ARexx Skripts ausgeliefert, die f�r die
unterst�tzten Sprachen benutzt werden k�nnen und auch f�r die
CygnusED, TurboText und GoldED Editoren angepasst wurden.

   Mit der "PUBSCREEN" Option k�nnen Sie MagicCX sagen, auf welchem
Public Screen das RCS Fenster ge�ffnet werden soll. Wenn der Screen
nicht gefunden werden kann, f�llt MagicCX auf den Default Public Screen
zur�ck.

   Vergewissern Sie sich, da� Sie das logische Verzeichnis T:
eingerichtet haben und das es verf�gbar ist, da MagicCX dieses
Verzeichnis benutzt, um die tempor�ren Ergebnisse seiner Aktionen zu
sichern.  Sicherheitshalber rate ich Ihnen eine Sicherheitskopie des zu
bearbeitenden Quelltextes zu erstellen, bevor Sie das Revision Control
System einsetzen. (Man kann nie wissen)

   Nach einer Revision wird das RCS entweder 'TRUE' f�r eine
erfolgreiche Revision oder 'FALSE' f�r einen Fehler zur�ckliefern.
Diese R�ckgabewerte sind Zeichenketten, also pr�fen Sie Ihre RESULT
Codes entsprechend.

   Falls Sie Ihren Namen und eine `Firma' in den Header eingetragen
haben wollen, so m�ssen Sie weiterhin zwei Environment Variablen
setzen.

   -     AUTHOR

     Setzen Sie diese Variable auf Ihren Namen.

   -     COMPANY

     Hier tragen Sie den Namen Ihrer `Firma' ein.

   Hier ein kleines Beispiel, um die beiden Variablen zu belegen:

                  SETENV AUTHOR "Kai Iske"

                 SETENV COMPANY Gunthersoft

   Sie sehen, um Parameter mit Leerzeichen zu �bergeben m�ssen Sie
diese in Anf�hrungszeichen setzen. Bauen Sie diese Zuweisungen am
Besten in Ihr s:User-StartUp File ein, um die Variablen bei jedem
Booten des Systems zur Verf�gung zu haben.


  Erste Revision                                 Das erste Mal das RCS aufrufen
  Weitere Revisionen                             An einem bereits revidierten Source arbeiten
  Spezielle Eigenschaften                        Spezielle Einrichtungen und ein Beispiel
  Benutzung des RCS2HST Programms                Das RCS2HST Programm

   ---------- Fu�noten ----------

   (1)  Einige Assembler z.B. ben�tigen bestimmte Informationen in der
ersten Zeile des Quelltextes.