****************************************************************************
*****              Anleitung fr die PureC-Shell 2.17                  *****
****************************************************************************


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 von PureC-Shell 2.17
  kostet 20.- DM (Bar oder berweisung) an oben genannte Adresse.
  Registrierte Benutzer knnen jederzeit, durch zusenden einer
  formatierten Diskette und einem frankiertem Freiumschlag, die neueste
  Version bei mir bekommen.

  PureC-Shell besteht aus folgenden Dateien:

                PC_SHELL.APP        PureC-Shell
                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.

  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).
                       *** ist in dieser PC-SHELL Version noch nicht ***
                       *** implementiert.                            ***

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

     beenden...        Programmende


 Editor:
*********

     Dateien editieren  Die im Projektfenster selektierten Dateien
                        werden an den Editor bergeben.

     *.C editieren...   Datei editieren. Existiert die im Fileselektor
                        angegebene Datei noch nicht, wird eine 0-Byte Datei mit
                        diesem Namen erzeugt.

     *.S editieren...   siehe *.C editieren...

     *.H editieren...   siehe *.C editieren...

     *.* editieren...   siehe *.C editieren...


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

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

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

     Compilieren      Compiliert die im Projektfenster selektierten Dateien.
                      (nur die *.C Dateien)

     Assemblieren     Assembliert die im Projektfenster selektierten Dateien.
                      (nur die *.S Dateien)

     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.

     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.

     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.

     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)

     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.

 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 usw.)
                      - festlegen des Editors der verwendet werden soll.
                      - angeben welcher Editor das ARGV-Protokoll beherrscht,
                           wie z.B. EVEREST oder QED.
                           (wichtig fr 'Datei editieren', 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. 100) und einer fr Library-Dateien (max. 100).

      Durch Doppelklick auf den ersten freien Eintrag wird ein Popup-Men
      aufgerufen.
      Durch Einfachklick auf einen Source-Dateieintrag kann dieser
      selektiert werden. (siehe 'Datei editieren', 'Compilieren' und
      'Assemblieren').
      Durch Doppelklick auf den Source-Dateien Titelbalken werden alle
      selektierten Eintrge wieder deselektiert.

      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 beim editieren nicht suchen zu mssen.

      Das Source-Dateien Popup-Men:

         - Datei auswhlen...              Auswhlen der Source-Datei.
                                           Ist die angegebene Source-Datei
                                           noch nicht vorhanden, wird eine
                                           0-Byte Datei mit diesem Namen
                                           erzeugt.
         - Abhngigkeiten festlegen...     Angeben von Dateien, die bei 'Make'
                                           bercksichtigt werden sollen.
                                           Mssen im gleichen Verzeichnis
                                           wie die Source-Datei sein.
                                           (z.B. Headerdateien die in dieser
                                            Sourcedatei verwendet werden)
         - Optionen einstellen...          Einstellen von lokalen Compiler-
                                           oder Assembler-Optionen die nur fr
                                           diese Datei gelten (nur *.C und *.S).
         - Datei editieren                 diese Source-Datei editieren.
         - Datei-Eintrag entfernen         Lschen dieses Datei-Eintrages.


      Das Library-Dateien Popup-Men:

         - Datei auswhlen...              Auswhlen der Library-Datei
                                           (+.LIB oder *.O)
         - Datei-Eintrag entfernen         Lschen dieses Datei-Eintrages.

      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.

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

   Fr die nchsten Versionen sind folgende Neuerungen geplant:

        - Aufnahme von Projekten in die Source-Dateien-Liste.
        - Laden von *.PRJ Projekten.

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

  ***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.


