****************************************************************************
*****              Anleitung fr die PureC-Shell 2.21                  *****
****************************************************************************


Programmiert in PureC von:        Frank Schramm
                                  Kasperstr.5
                                  D-21647 Moisburg
                                  Tel.: 04165/6173
                                  E-Mail: Frank Schramm @ HH2

                                  Bankverbindung: StSpk Buxtehude
                                                  BLZ 241 520 80
                                                  Kto: 876235

  PureC-Shell ist Shareware. Die Benutzung von PureC-Shell 2.21
  kostet 20.- DM (Bar, Scheck oder berweisung) an oben genannte Adresse.
  Registrierte Benutzer knnen jederzeit, durch zusenden einer
  formatierten Diskette und einem frankiertem Rckumschlag, die neueste
  Version bei mir bekommen.

  Ab der Version 2.19 ist die PC-Shell leicht eingeschrnkt, bei der
  unregistrierten Version erscheint vor dem Compilieren eine Dialogbox,
  die auf den Shareware-Status hinweist.
  Die Registrierung erfolgt durch einen persnlichen Schlssel.

  Wichtig ist bei berweisungen, das die komplette Anschrift angegeben
  wird, ggf. auch die Telefonnummer oder E-Mail-Anschrift(Mausnetz).
  Der Registrierungs-Schlssel wird nach erfolgter Bezahlung, nach Wunsch
  telefonisch, per Brief oder per E-Mail(Mausnetz) mitgeteilt.

  PureC-Shell besteht aus folgenden Dateien:

                PC_SHELL.APP        PureC-Shell
                PARALLEL.TTP        Zum Compilieren im Hintergrund mit MagiX
                                    (mu im gleichen Verzeichnis sein, wie PC_SHELL.APP)
                PC_SHELL.TXT        dieser Text
                CHANGES.TXT         nderungen


  PureC-Shell luft auf TOS-Versionen >=1.04 /Multitos/MagiX! und einer Mindestauflsung
              mit 640 Pixeln Breite und 400 Pixeln Hhe.

  Hardware:   ST/STE/TT/Falcon030.

*************************** Menpunkte *************************************

 Datei:
********

     PC Neu...         Neues Projekt ffnen. Mit dem Fileselektor wird der
                       Name der Projektdatei (*.PC) angegeben. Die Projektdatei
                       muss sich im gleichen Verzeichnis befinden wie die
                       Sourcedateien.

     PC ffnen...      ffnet eine schon vorhandene Projektdatei (*.PC).

     PC Sichern...     Sichert die geffnete Projektdatei.

     PC Sichern als... Sichert die geffnete Projektdatei, wobei ein anderer
                       Projektname eingegeben werden kann.

     PRJ ffnen..      ffnet eine original PureC-Projektdatei (*.PRJ).

     PRJ sichern..     Sichert die geffnete Projektdatei als
                       PureC-Projektdatei (*.PRJ).

     beenden...        Programmende


 Editor:
*********

     *.C editieren...   *.C Datei editieren.

     *.S editieren...   *.S Datei editieren.

     *.H editieren...   *.H Datei editieren.

     *.* editieren...   *.* Datei editieren.

     Projekt-Suche...   Durchsucht alle im Projekt angegebenen Source-
                        und Abhngigkeitsdateien nach einer Zeichenkette.
                        Die gefundenen Textstellen werden in einem Fenster
                        ausgegeben, und zwar in der Form:
                          - Datei-Name, Zeile, Inhalt der Zeile.
                        Durch Klick auf diese Zeile wird die Datei
                        in den internen Editor geladen, und der Cursor
                        auf die betreffende Textstelle gesetzt.

 Compiler:
***********

     Compilieren...   Compiliert eine mit dem Fileselektor
                      ausgewhlte Datei.

     Assemblieren...  Assembliert eine mit dem Fileselektor
                      ausgewhlte Datei.

     Make             Erzeugt, aus den im Projektfenster angegebenen Source-
                      und Library-Dateien, die unter 'Programm-Name'
                      angegebene Datei.
                      Es werden nur die genderten Sourcedateien
                      compiliert bzw. assembliert.
                      Ob Dateien verndert wurden, wird am Datum und Zeit
                      der Datei festgestellt. Deshalb ist es wichtig, das die
                      Rechneruhr die aktuelle Uhrzeit und Datum enthlt.

     Make All         Erzeugt, aus den im Projektfenster angegebenen Source-
                      und Library-Dateien, die unter 'Programm-Name'
                      angegebene Datei.
                      Es werden alle Sourcedateien neu compiliert bzw.
                      assembliert.

                      Die Projekterzeugung kann durch lngeres drcken
                      der Alternate-Taste abgebrochen werden.

     Linken           Linkt das Projekt.

     Prg. debuggen    bergibt das vom Projekt erzeugte Programm an
                      den Pure-Debugger.

     Prg. starten     Startet das vom Projekt erzeugte Programm.


 Optionen:
***********

     Compiler...      Einstellen der Compiler-Optionen.

     Assembler...     Einstellen der Assembler-Optionen.

     Linker...        Einstellen der Linker-Optionen.

     DEF sichern      Default-Einstellungen sichern von:
                          -Compiler-, Assembler- und Linker-Optionen
                            (Die Include und Lib-Directorys werden nur in
                             der INF-Datei gesichert)
                          -Library-Dateien
                          -Pfad fr den Prg-Namen
                      Die Defaulteinstellungen werden nur beim erstellen einer
                      neuen *.PC-Datei (PC neu...) verwendet.

     Pfade...         Einstellen der Pfade:
                      - Editor1 + Editor2
                      - Parameter fr Editor1 + Editor2
                      - RCS (Resource-Editor)
                      - PureC (In diesem Verzeichnis mssen sich die
                               PureC-Programme befinden: PD.PRG, PASM.TTP,
                               PCC.TTP und PLINK.TTP)
                      - Pfad des PC_HELP.PRG

     Programme...     Auswhlen von Programmen die ber die Funktionstasten
                      F1-F10 gestartet werden knnen.

     INF sichern      Sichern der PC_SHELL.INF Datei, sie enthlt:
                       - Die in 'Pfade...', 'Programme...' und 'Diverse...'
                             vorgenommenen Einstellungen.
                       - Die in (Optionen) 'Compiler...', 'Assembler...'
                             und 'Linker...' angegebenen Include- und Library-Directory.
                       - Die Position und Gre der einzelnen Fenster.
                       - Alle geffneten Fenster.
                       - Die geladene Projektdatei.
                       - Den Registrierschlssel.

 Extras:
*********

     Resource...      Auswahl einer Resource-Datei und starten des
                      Resource-Editors.

     Debugger...      Auswahl eines Programms und starten des
                      PureC-Debuggers.

     Diverse...       Einstellungen:
                      - verschiedene Schalter
                           (Grow- und Shrink, Pulldown-Mens,
                            PC_HELP.PRG verwenden usw.)
                      - festlegen des Editors der verwendet werden soll.
                      - angeben welcher Editor das ARGV-Protokoll beherrscht,
                           wie z.B. EVEREST oder QED.
                           (wichtig fr 'Edit', da mit dem ARGV-
                            Protokoll eine beliebig lange Kommandozeile
                            bergeben werden kann.)
                      - Endung der Resource-Dateien.
                             (wird fr 'Resource...' verwendet)

     Fehlermeldungen  ffnet das Fehlermeldungen-Fenster.

     Fenster          Aktuelles Fenster wechseln.

     PRG starten...   Starten eines beliebigen Programms, das ber den
                      Fileselektor ausgewhlt wird.

****************************************************************************

 Projekt-Fenster:
******************

      Das Projekt-Fenster besteht aus zwei Listboxen, jeweils
      einer fr Source-Dateien (max. 500) und einer fr Library-Dateien (max. 100).
      Auswahl und Bearbeiten der Source- und Library-Dateien durch Drag&Drop.
      Fr die Bedienung der Abhngigkeiten-Listbox gilt das unten beschriebene auch.

      Icone:
     ********

         Source neu:   Auswhlen von Source-Dateien (Selectric wird untersttzt).

         Library neu:  Auswhlen von Library-Dateien (Selectric wird untersttzt).

         Klemmbrett:   - speichern  =Ziehen von Source- oder/und Library-Dateien auf das Klemmbrett.
                       - laden      =Ziehen des Klemmbrettes in die Source- oder Library-Listbox

         Mlleimer:    Lschen      =Ziehen von Source- oder/und Library-Dateien auf den Mlleimer.

         Edit:         Editieren    =Ziehen von Source-Dateien auf das Edit-Icon, oder
                                     Source-Dateien selektieren und Klick auf das
                                     Editor-Icon.
                                     Durch Doppelklick auf eine Source-Datei, wird diese
                                     in den Editor geladen.

         Arbeit:       Compilieren/Assemblieren  =Ziehen von Source-Dateien auf das Arbeit-Icon, oder
                                     Source-Dateien selektieren und Klick auf das
                                     Arbeit-Icon.

         Option:       Abhngigkeiten und lokale Compiler- bzw. Assembleroptionen einstellen.
                                    =Ziehen von Source-Dateien auf das Option-Icon, oder
                                     Source-Dateien selektieren und Klick auf das
                                     Option-Icon.

      Tastaturbedienung:
     ********************

         Source neu  (ALT-S)
         Library neu (ALT-L)
         Klemmbrett  (speichern = ^C, laden ^V) nur selektierte Eintrge werden bearbeitet.
         Mlleimer   (^D)                       nur selektierte Eintrge werden bearbeitet.
         Edit        (^E)                       nur selektierte Eintrge werden bearbeitet.
         Arbeit      (^B)                       nur selektierte Eintrge werden bearbeitet.
         Option      (^I)                       nur selektierte Eintrge werden bearbeitet.

         Cursor:     Cursor anschalten (Cursor - Up, Down, Left oder Right)
                     Cursor nach oben  (Cursor Up) mit SHIFT seitenweise.
                     Cursor nach unten (Cursor Down)  mit SHIFT seitenweise.
                     Listbox wechseln  (Cursor Right bzw. Left)
                     Alle Eintrge in der Listbox, in der sich der Cursor befindet, selektieren.  (^A)
                     Eintrag unter dem Cursor selektieren.    (INSERT) selektieren mehrerer Eintrge mit
                                                                       Hilfe der SHIFT-Taste.
                     Eintrge deselektieren.                  (DELETE) deselektieren nur eines Eintrages
                                                                       mit Hilfe der Shift-Taste

      Die Source-Dateien werden bei der Projekterstellung ('Make' oder 'Make All')
      folgendermaen bearbeitet:
         - *.C Dateien werden compiliert.
         - *.S Dateien werden assembliert.
         - *.O und *.LIB Dateien werden hinzugelinkt.
      alle anderen Dateien werden ignoriert.
      So kann man z.B. auch Headerdateien (*.H) mit in die Source-Dateien-Liste
      bernehmen, um sie zum editieren nicht suchen zu mssen.


      Die Library-Dateien mssen sich im Library-Directory befinden.
      (siehe `Linker...')

****************************************************************************

 Fehlermeldungen-Fenster:
**************************

            Die bei der Projekterstellung anfallenden Fehlermeldungen
            werden in die Datei ERROR.DAT umgeleitet.
            Ist die Projekterstellung beendet, wird der Inhalt der Datei
            in einem Fenster angezeigt. Durch einen Einfachklick auf eine
            Fehlermeldung (ERROR oder WARNING), wird bei eingeschalteten
            internen Editor, die Source-Datei geladen und der Cursor
            befindet sich in der Zeile auf die sich die Fehlermeldung
            bezieht. Bei eingeschalteten externen Editor, wird die
            Source-Datei und die ERROR.DAT Datei an den Editor bergeben.
            Bei manchen Editoren, wie z.B. EVEREST, ist es jetzt auch
            mglich, das der Editor, durch Doppelklick auf eine Fehlermeldung,
            den Cursor in die dazugehrige Zeile der Sourcedatei setzt.

            Durch bettigen der HELP-Taste, wird die PureC-Hilfe fr
            Fehlermeldungen aufgerufen.

****************************************************************************

   Fr die nchsten Versionen sind folgende Neuerungen geplant:

        - Aufnahme von Projekten in die Source-Dateien-Liste.

****************************************************************************

  ***Pure C ist eingetragenes Warenzeichen der Firma Pure Software GmbH.***

HAFTUNGSAUSSCHLUSS
------------------

  Das Programm  wurden ausfhrlich getestet.  Fr etwaige  Schden, die
  durch die Verwendung von PureC-Shell entstehen, kann
  ich keine Haftung bernehmen.

  Sollten Sie  trotzdem einen Fehler feststellen  oder Verbesserungsvor-
  schlge haben, so knnen sie mich unter der oben angegebenen Anschrift
  oder per E-Mail erreichen.

