**************************************************************************** ***** Anleitung fr die PureC-Shell 2.20 ***** **************************************************************************** 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.20 kostet 20.- DM (Bar, Scheck oder šberweisung) an oben genannte Adresse. Registrierte Benutzer k”nnen 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 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 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 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. *************************** 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 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 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... 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 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 ausgew„hlt 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 Abh„ngigkeiten-Listbox gilt das unten beschriebene auch. Icone: ******** Source neu: Ausw„hlen von Source-Dateien (Selectric wird untersttzt). Library neu: Ausw„hlen 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: L”schen =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: 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. Mlleimer (^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 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 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 fr Fehlermeldungen aufgerufen. **************************************************************************** Fr 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 ausfhrlich getestet. Fr 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.