Atari ST - 1994

Pure C-Shell

1 / 4

Genre: Programming - Aids / Routines / Tools
Year: 1994
Language: Compiled C
Publisher: [no publisher]
Controls: Keyboard / Mouse
Distributor: —
Resolution: Medium / High / VGA
Developer: [n/a]
ST Type: ST, STe, TT, Falcon030 / 0.5MB
Licensed from: —
Programmer(s): Schramm, Frank
Country
MIDI: —
Software: German
Version: 2.21
Box/Instructions: German
Number of Disks: 1 / Double Sided / HD Installable
License: PD / Freeware / Shareware
Dump: Download
Serial: —
Dump format: MSA
Protection: —

INSTRUCTIONS

****************************************************************************
***** Anleitung für 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 können jederzeit, durch zusenden einer
formatierten Diskette und einem frankiertem Rückumschlag, die neueste
Version bei mir bekommen.

Ab der Version 2.19 ist die PC-Shell leicht eingeschränkt, bei der
unregistrierten Version erscheint vor dem Compilieren eine Dialogbox,
die auf den Shareware-Status hinweist.
Die Registrierung erfolgt durch einen persönlichen Schlüssel.

Wichtig ist bei Überweisungen, das die komplette Anschrift angegeben
wird, ggf. auch die Telefonnummer oder E-Mail-Anschrift(Mausnetz).
Der Registrierungs-Schlüssel 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 läuft auf TOS-Versionen >=1.04 /Multitos/MagiX! und einer Mindestauflösung
mit 640 Pixeln Breite und 400 Pixeln Höhe.

Hardware: ST/STE/TT/Falcon030.

*************************** Menüpunkte *************************************

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 geöffnete Projektdatei.

PC Sichern als... Sichert die geöffnete Projektdatei, wobei ein anderer
Projektname eingegeben werden kann.

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

PRJ sichern.. Sichert die geöffnete 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 Abhängigkeitsdateien 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
ausgewählte Datei.

Assemblieren... Assembliert eine mit dem Fileselektor
ausgewählte Datei.

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

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 längeres drücken
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 für den Prg-Namen
Die Defaulteinstellungen werden nur beim erstellen einer
neuen *.PC-Datei (PC neu...) verwendet.

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

Programme... Auswählen von Programmen die über die Funktionstasten
F1-F10 gestartet werden können.

INF sichern Sichern der PC_SHELL.INF Datei, sie enthält:
- Die in 'Pfade...', 'Programme...' und 'Diverse...'
vorgenommenen Einstellungen.
- Die in (Optionen) 'Compiler...', 'Assembler...'
und 'Linker...' angegebenen Include- und Library-Directory.
- Die Position und Größe der einzelnen Fenster.
- Alle geöffneten Fenster.
- Die geladene Projektdatei.
- Den Registrierschlüssel.

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-Menüs,
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 für 'Edit', da mit dem ARGV-
Protokoll eine beliebig lange Kommandozeile
übergeben werden kann.)
- Endung der Resource-Dateien.
(wird für 'Resource...' verwendet)

Fehlermeldungen Öffnet das Fehlermeldungen-Fenster.

Fenster Aktuelles Fenster wechseln.

PRG starten... Starten eines beliebigen Programms, das über den
Fileselektor ausgewählt wird.

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

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

Das Projekt-Fenster besteht aus zwei Listboxen, jeweils
einer für Source-Dateien (max. 500) und einer für Library-Dateien (max. 100).
Auswahl und Bearbeiten der Source- und Library-Dateien durch Drag&Drop.
Für die Bedienung der Abhängigkeiten-Listbox gilt das unten beschriebene auch.

Icone:
********

Source neu: Auswählen von Source-Dateien (Selectric wird unterstützt).

Library neu: Auswählen von Library-Dateien (Selectric wird unterstützt).

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

Mülleimer: Löschen =Ziehen von Source- oder/und Library-Dateien auf den Mülleimer.

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: Abhängigkeiten 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 Einträge werden bearbeitet.
Mülleimer (^D) nur selektierte Einträge werden bearbeitet.
Edit (^E) nur selektierte Einträge werden bearbeitet.
Arbeit (^B) nur selektierte Einträge werden bearbeitet.
Option (^I) nur selektierte Einträge 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 Einträge in der Listbox, in der sich der Cursor befindet, selektieren. (^A)
Eintrag unter dem Cursor selektieren. (INSERT) selektieren mehrerer Einträge mit
Hilfe der SHIFT-Taste.
Einträge deselektieren. (DELETE) deselektieren nur eines Eintrages
mit Hilfe der Shift-Taste

Die Source-Dateien werden bei der Projekterstellung ('Make' oder 'Make All')
folgendermaßen 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 müssen.

Die Library-Dateien müssen 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
möglich, das der Editor, durch Doppelklick auf eine Fehlermeldung,
den Cursor in die dazugehörige Zeile der Sourcedatei setzt.

Durch betätigen der HELP-Taste, wird die PureC-Hilfe für
Fehlermeldungen aufgerufen.

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

Für die nächsten 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 ausführlich getestet. Für etwaige Schäden, die
durch die Verwendung von PureC-Shell entstehen, kann
ich keine Haftung übernehmen.

Sollten Sie trotzdem einen Fehler feststellen oder Verbesserungsvor-
schläge haben, so können sie mich unter der oben angegebenen Anschrift
oder per E-Mail erreichen.