>>> MARVIN-Helpdatei <<<
64
368

                            --------
                             MARVIN
                            --------
                      DIE GfA-Shell  (3.x)

         Version: 0.56f               Datum: 03.05.1991

         Autoren: Thilo S. Gaul  &  Matthias K. Stürmer


 I.    Kurzbeschreibung der Menüpunkte
 -------------------------------------

 1.0   MARVIN
 ------------

 1.1   Info:
        Übliche  Kurzinfo über  Programm,  Version und Autoren.
        Anzeige des freien  Speichplatzes.  (Mehr bei Anklicken
        der Köpfe und des Info-Buttons.)


 2.0   Kommandos
 ---------------

 2.1.1 Kompilieren:                               [Alternate-K]
        Kompilieren des in  "Dateinamen einstellen" (3.1.1) be-
        zeichneten Programmes gemä₧ den in  "Parameter einstel-
        len" (3.2.1) gewählten Parametern.

 2.1.2 Linken:                                    [Alternate-L]
        Linken der in "Dateinamen einstellen" (3.1.1) gewählten
        Objektdateien.

 2.1.3 Generieren:                                [Alternate-X]
        Ausführen  von  "Kompilieren"  (2.1.1)   und   "Linken"
        (2.1.2)  nacheinander  mit Prüfen,  ob es notwendig ist
        (Programm-, Namensänderung,  o.ä.).  Diese  Überprüfung
        kann man mit der Shift-Taste unterdrücken.

 2.1.4 Interpreter:                               [Alternate-I]
        Aufrufen des  Interpreters mit dem in  "Dateinamen ein-
        stellen" (3.1.1)  bezeichneten Basic-Programm.  In Ver-
        bindung mit der Shift-Taste: dto. ohne Basic-Programm.

 2.2.1 Kompilat ausführen:                        [Alternate-A]
        Wenn ein Programm gerade kompiliert  und gelinkt wurde,
        kann es mit diesem Befehl direkt ausgeführt werden.

 2.2.2 Programm aufrufen:                         [Alternate-R]
        Ein beliebiges Anwenderprogramm kann ausgeführt werden.
        TOS-Programme werden im Kommandofenster aufgerufen.
        Bei  TTP-  oder  APP-Programmen können in der Kommando-
        zeile Makros verwendet werden. Siehe dazu 4.1.4.

 2.2.3 Kommandointerpreter                          [Control-M]
        Starten des Kommandointerpreters. Der Pfad wird aus der
        Environmentvariablen SHELL ausgewertet.

 2.2.4 GEMDOS-Operationen:                        [Alternate-G]
        - Ordner anlegen
        - Ordner löschen (damit auch Pfade löschen)
        - Dateien löschen: Dateiauswahlbox bleibt im Del.-Modus
        - Dateien umbenennen:
              - 1. Dateiauswahlbox: keine  Auswahl,   d.h.  nur
                   <RETURN> bedeutet Ordner umbenennen;
                2. Dateiauswahlbox: wird  nur  der  Name  über-
                   nommen,  da ein  Verschieben  nicht  erlaubt
                   ist.                             (in Arbeit)
              - 1. Dateiauswahlbox: normale Dateiauswahl;
                2. Dateiauswahlbox: wenn ein  anderer Pfad aus-
                   gewählt ist wird die ausgewählte Datei  ver-
                   schoben.  Es genügt dabei,  den Pfad anzuge-
                   ben.  Der Name wird dann aus der ersten Aus-
                   wahl übernommen.
        - Dateizeit aktualisieren (touch)
        - Datei kopieren:
              - 1. Dateiauswahlbox: normale Dateiauswahl;
              - 2. Dateiauswahlbox: Zielpfad; ohne Namensangabe
                   wird der Name der Quelldatei übernommen.
        - Datei-Information
        - Disketten-Information (freie Speicherkapazität)
        Mit UNDO kann man Wildcard-Operationen abbrechen.

 2.3   Arbeit sichern                             [Alternate-N]
        Speichern der akt. Einstellungen in der  Session-Datei.

 2.4   Beenden:                       [Alternate-B] [Control-Q]
        Au₧er mit Alternate-B auch mit  Control-Q zu erreichen.
        In Verbindung mit der Shifttaste:  kein Abspeichern der
        Sessiondatei.


 3.0   Optionen
 --------------

 3.1   Dateinamen

 3.1.1 einstellen:                                [Alternate-D]
        Einstellen der Namen von Basic-Programm,  Objekt-Datei,
        Programm  und  Bibliothek,  sowie der  hinzuzulinkenden
        Objekt-Dateien. Bei Doppelklick auf den Button GFA->PRG
        wird auch der Objektname geändert.

 3.1.2 laden:
        Laden einer Dateinamen-Einstellung.

 3.1.3 speichern:
        Speichern einer Dateinamen-Einstellung.

 3.2   Parameter

 3.2.1 einstellen:                                [Alternate-P]
        Einstellen der Kompiler- und Linkerparameter. Der Para-
        meter "STOP & Every/After" hat noch keinen Einflu₧,  da
        der Kompiler (bis V. 3.50) hier fehlerhaft arbeitet.

 3.2.2 laden:
        Laden einer Parameter-Einstellung.

 3.2.3 speichern:
        Speichern einer Parameter-Einstellung.

 3.3   Projekt
        Dateinamen, Parameter- und  Umgebungseinstellungen sind
        zu einem Projekt zusammengefa₧t.

 3.3.1 laden:
        Projektdatei laden.

 3.3.2 speichern:
        Projektdatei speichern.


 4.0   Umgebung
 --------------

 4.1   Suchpfade

 4.1.1 Kompiler:
        Kompilerpfad einstellen.

 4.1.2 Linker:
        Linkerpfad einstellen.

 4.1.3 Interpreter:
        Interpreterpfad einstellen.

 4.1.4 Programme:                                 [Alternate-Y]
        Die  Pfade  und  Kommandozeilen  der  Anwendungen  ein-
        stellen,  die unter den Menüpunkten 5.1-5.10 aufgerufen
        werden können.
        In der Kommandozeile können Makros verwendet werden:
        $(Q) - Quelltext
        $(O) - Objektdatei
        $(O01) .. $(O32) - hinzuzulinkende Dateien
        $(P) - Programmname
        $(B) - Bibliothek
        Steht nach dem Bezeichner $(. ein '!',  so wird die be-
        zeichnete Datei ohne Extension genommen. So ergibt z.B.
        '$(O!01).S'   den  zur  ersten  Objektdatei  gehörenden
        Assemblersource.

 4.2   Fenster:
        Wird ein Fenster über  Tastatur oder Pull-Down-Menu an-
        gewählt,  wird es entweder geöffnet oder in den Vorder-
        grund geholt. In Verbindung mit der Shift-Taste wird es
        geschlossen.
        Mit  ESC  wird das aktuelle Fenster  wiederhergestellt.
        Diese  Funktion entfällt  eventuell  demnächst,  da das
        Programm selbständig ein Fenster aktualisiert,  wenn es
        in den Vordergrund geholt wird und etwas darin geändert
        wurde.
        Falls die Bildschirmausgabe  zu langsam erscheint,  mu₧
        man sich bis zu einer  späteren Version  gedulden  oder
        einen Booster,  wie z.B. TURBO-ST oder QUICK-ST verwen-
        den.  In jedem Fall bitten wir zu bedenken,  da₧ wir in
        MARVIN ausschlie₧lich offizielle Schnittstellen verwen-
        den (VDI und AES, kein LINE-A).

 4.2.1 Statusfenster:                             [Alternate-S]
        In diesem Fenster  werden die Dateipfade aus  3.1.1 und
        Kompiler-,   Linker-  und   Interpreterpfad  angezeigt,
        au₧erdem  noch  die in  4.4.1  (Seite 1)  einstellbaren
        Umgebungsflags.

 4.2.2 Helpfenster:                                      [Help]
        In diesem Fenster wird dieser Help-Text angezeigt.

 4.2.3 Kommandofenster: (History)                 [Alternate-H]
        In dieses Fenster werden alle Mitteilungen von Program-
        men, die als 'TOS im Fenster' angemeldet sind, ausgege-
        ben,  so z.B.  Kompiler- und Linkermeldungen,  au₧erdem
        auch Mitteilungen von MARVIN.

 4.3   Environment einstellen:
        Environment  einstellen,   das  den  Anwenderprogrammen
        übergeben wird, z.T. auch programminterne Variablen.
        Variablen können durch Anklicken selektiert werden. Mit
        gleichzeitigem Drücken der  Shift-Taste  können weitere
        Variablen  zusätzlich  selektiert werden.  Deaktivierte
        Variablen werden nicht weitergegeben. Durch Doppelklick
        auf eine Variable kann diese verändert werden.
        Es existieren  reservierte Variablen:   G3MOVE, G3WAIT,
        G3OBJ, G3PRG, G3BIB, SHELL, ROWS, COLUMNS, u.a.m.
        G3xxx ändern Dateinamen (siehe 4.4.1),  SHELL  bestimmt
        den Pfad eines Kommandointerpreters,  ROWS und  COLUMNS
        die Grö₧e des Textbuffers des Kommandofensters.

 4.4   Parameter

 4.4.1 einstellen:                                [Alternate-U]
        Einstellen einiger Umgebungsparameter:
        Seite 1:
          - Diskwechsel (G3WAIT):
                Dieses Flag bestimmt,  ob vor dem  Öffnen einer
                Datei beim  Kompilieren  oder  Linken auf einen
                Tastendruck gewartet werden soll oder nicht.
                Der Sinn dieser Einstellung besteht darin,  da₧
                auf  einen  eventuell  notwendigen   Disketten-
                wechsel gewartet wird.
          - Speichermangel (G3MOVE):
                Dieses Flag bestimmt,  ob der  Kompiler sparsam
                mit dem  Speicherplatz umgeht  oder nicht.  Das
                "Packen" des Speichers kostet natürlich Zeit.
          - Resourcen resident:
                Dieses Flag bestimmt,  ob die  MARVIN-Resourcen
                im Speicher  resident bleiben,  oder ob sie vor
                Programmaufrufen  freigegeben  und  nach  deren
                Beendigung wieder nachgeladen werden.
                (Z.Zt. leider noch nicht möglich)
          - Warten nach Programmende:
                Dieses Flag bestimmt,  ob nach Beendigung eines
                Programmes  gewartet  werden  soll,  bevor  der
                nächste MARVIN-Befehl ausgeführt werden kann.
          - Generieren schnell/sicher:
                Bei Einstellung 'sicher' wird nach Umgebungs-
                wechsel stets neu kompiliert und gelinkt.
          - Zeichensatz:
                0: gro₧er Systemfont (Bei HiRes 16x8)
                1: Font 8x8 (Systemfont bei Mid- und LoRes)
                2: kleiner Systemfont (6x6)
          - Warnung vor Datei löschen
                Sicherheitsabfrage vor Löschen einer Datei
          - Warnung vor Datei überschreiben
                dito. vor Überschreiben einer Datei
          - Warnung vor Programmende:
                Wenn dieses Flag gesetzt ist, wird der Benutzer
                vor dem Verlassen des Programmes gewarnt, falls
                er eine Änderung der Dateinamen,  der Parameter
                oder der Umgebung noch nicht abgespeichert hat.
          Die Parameter  Diskwechsel und  Speichermangel  haben
          nur im Kompiler und Linker eine Wirkung.
        Seite 2:
          Kommandofenster:
          - Zeilenumbruch:
                Bei  Erreichen  des  Zeilenendes  wird  in  der
                nächsten Zeile weitergeschrieben.  (LINE-WRAP)
          - Nachführung:
                Bei Textausgabe  im  Kommandofenster  wird  der
                sichtbare   Bereich   des   Fensters  vertikal,
                vollständig (horizontal + vertikal)  oder nicht
                nachgeführt. (Ausschalten kann zur Folge haben,
                da₧  Ein- oder Ausgaben  au₧erhalb  des  darge-
                stellten Bereichs liegen.)
          Programmaufruf:
          - akt. Pfad -> Prog.:
                Vor dem  Programmaufruf wird der  aktuelle Pfad
                auf den Pfad des Programmes eingestellt.
          diverses:
          - erw. Fileselector:
                Ab TOS 1.4 kann man auch eine erweiterte Datei-
                auswahlbox wählen (mit Überschrift)
          - Environ. überschreiben:
                Das mit der Umgebungsdatei eingelesene Environ-
                ment überschreibt  das bisher vorhandene,  z.B.
                das Systemenvironment.
          - TURBO-Bildschirm:
                schnelles Wiederherstellen des Bildschirminhal-
                tes nach Dialogboxen. (In Planung)
          - Datei-Existenzprüfung:
                Prüfen beim  Einstellen  (sofern sinnvoll)  und
                vor der  Programmausführung,  z.B. auch vor dem
                Linken, ob alle Objektdateien vorhanden sind.

 4.4.2 laden:
        Laden einer Umgebungs-Einstellung (4.1, 4.3, 4.4).

 4.4.3 speichern:
        Speichern einer Umgebungs-Einstellung (4.1, 4.3, 4.4).


 5.0   Programme
 ---------------
 Die Menuzeile ist nur so lang,  wie auch Programme eingestellt
 sind. Falls kein Programm eingestellt ist, wird die Menuspalte
 deaktiviert.

 5.1-5.10 Anwendung 1..10:           [Alternate-1..0] [F1..F10]
        Vom Benutzer  in der  Menüzeile  "Umgebung"  unter  dem
        Punkt  "Programme"  (4.1.4)  eingestellte  Anwendungen,
        z.B. ein Texteditor o.ä.   In Verbindung mit der Shift-
        Taste: dito. ohne Kommandozeile.


 II.   Programmablauf
 --------------------

 Beim Programmstart wird die Datei MARVIN.SES gesucht und gela-
 den,  falls sie vorhanden  und die  Shift-Taste nicht gedrückt
 ist.  Diese  Datei  beinhaltet  den  letzten  Stand  der Dinge
 (Dateinamen, Parameter, Umgebung und Fensteraufbau).  Man  hat
 nun die in I. beschriebenen Möglichkeiten.  Beim Verlassen des
 Programmes  werden alle aktuellen  Einstellungen  in der Datei
 MARVIN.SES gespeichert,  damit man das nächste Mal  up to date
 ist.  Dies lä₧t sich durch  Drücken der  Shift-Taste  beim An-
 wählen von "Beenden" umgehen.


 III. Environment-Variablen
 --------------------------
 G3xxx  - Variablen für den GfA-Kompiler und -Linker
 MARVIN - Ordner für zu MARVIN gehörende Dateien
 SHELL  - vollständiger Pfad einer Kommandoshell
 ROWS   - Anzahl der Zeilen des Kommandofensters
 COLUMNS- Anzahl der Spalten den Kommandofensters
 ROWS und COLUMNS  sollten nicht zu häufig geändert werden,  da
 verschiedene  TOS-Versionen  mit  MALLOC()  und  MFREE()  ihre
 Probleme haben und der Speicher zerstückelt wird.


 IV.  Kompilerparameter
 -----------------------                              [Default]

 Interruptroutinen:      erlauben / nie                     [2]

 Integer-Division:       normal / immer Integer             [1]
                         Flie₧komma / Integer

 Integer-Multiplikation: normal / immer Integer             [1]
                         Flie₧komma / Integer

 Select-Parameter:       normal / Wort                      [1]
                         Langwort / Wort

 Select-Optimierung:     Speicherplatz / Geschwindigkeit    [2]

 Funktionsende:          keine Überprüfung / Überprüfung    [1]

 Unterroutinen:          normal / Maschinensprache          [1]

 STOP & Every/After:     erlauben / nie                     [2]
                         Kompilerfehler GfA-Version <= 3.50

 RC-Intersect-Par.:      normal / Wort                      [1]
                         Langwort / Wort

 Fehlermeldungen:        Text / Nummer                      [2]

 Systemfehler:           Bomben / Nummer                    [1]

 Symboltabelle:          ja / nein                          [1]
                         Linkeroption: Symboltabelle anlegen

 Speicherplatz:          maximal / n Bytes                  [1]
                         Speicherplatzreservierung

