**************************************************************************** ***** Anleitung fr die PureC-Shell 3.00 ***** **************************************************************************** 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.25 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 PC_SHELL.AM Modul zum bearbeiten von Unterprojekten, wird erst bei Bedarf nachgeladen. Bei Žnderung des Modulnamens auf PC_SHELL.AMA wird das Modul beim Start der PC-SHELL gleich mitgeladen. PARALLEL.TTP Zum Compilieren im Hintergrund mit MagiX und MTOS. (muž im gleichen Verzeichnis sein, wie PC_SHELL.APP) Das VT52.PRG (nur MagiX) muž installiert sein. PC_SHELL.TXT dieser Text CHANGES.TXT Žnderungen PC_HYP ST-Guide Hypertext von Manfred Rosenboom. Die PureC-Shell legt w„hrend der Laufzeit folgende Dateien an: ERROR.DAT Datei fr die Fehlermeldungen. Befindet sich im Source-Pfad. PARALLEL.INF INF-Datei fr das PARALLEL.TTP. Befindet sich im Source-Pfad. PCLINK.CFG Zur šbergabe von Parametern an den Linker bzw. PCC.CFG bzw. Compiler. 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. (Abbruch durch LinksSHIFT + RechtsSHIFT) 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 beiden SHIFT-Taste abgebrochen werden. Linken Linkt das Projekt. Prg. debuggen šbergibt das vom Projekt erzeugte Programm an den Pure-Debugger. Prg. profilen šbergibt das vom Projekt erzeugte Programm an den Pure-Profiler (falls vorhanden). Das PROFILER.PRG muž sich im PureC-Pfad befinden. Die Profiler HLP-Dateien sollten dann in einem Unterverzeichnis liegen. Der Pfad kann in den Profiler-Optionen eingestellt werden. (Nicht unter Multitos) Prg. starten Startet das vom Projekt erzeugte Programm. Hat der Prg.-Name die Endung '.AM' wird das Programm als Modul gestartet. 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. Source-Liste... Zus„tzliche Source-Editoren mit konfigurierbaren Datei-Extendern. Ist z.B. das ACS.PRG fr den Datei- Extender *.ACS eingetragen, wird fr das editieren einer *.ACS Datei das ACS.PRG geladen. 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. INF laden... Laden einer INF-Datei. Extras: ********* Resource... Auswahl einer Resource-Datei und starten des Resource-Editors. Debugger... Auswahl eines Programms und starten des PureC-Debuggers. Profiler... Auswahl eines Programms und starten des Pure-Profilers (falls vorhanden). Das PROFILER.PRG muž sich im PureC-Pfad befinden. Die Profiler HLP-Dateien sollten dann in einem Unterverzeichnis liegen. Der Pfad kann in den Profiler-Optionen eingestellt werden. (Nicht unter Multitos) Modul laden... Laden von ACS-Modulen. Die Module mžen ACS >=2.20 compiliert sein. 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) Desktop-Farbe... Auswahl der Desktopfarbe, ab einer Aufl”sung >= 16 Farben. (nur Single-TOS) Fehlermeldungen ™ffnet das Fehlermeldungen-Fenster. Source-Inhalt ”ffnet ein Fenster, in dem die Hilfstexte der Source-Dateien ausgegeben werden. Durch Mausklick auf den Dateinamen, wird die Datei in den Editor geladen. Fenster Aktuelles Fenster wechseln. Fenster-Popup Popup zum toppen eines PC_SHELL Fensters. PRG starten... Starten eines beliebigen Programms, das ber den Fileselektor ausgew„hlt wird. Hilfe: ******** PC-Shell... ST-Guide Hilfe aufrufen. Men... ST-Guide Hilfe aufrufen. Editor... ST-Guide Hilfe aufrufen. Index... ST-Guide Hilfe aufrufen. **************************************************************************** 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. Prg.-Name Dialog: -Name des zu compilierenden Programms bzw. Objektdatei. -ggf. Programm-Pfad -ggf. Kommandozeile (wird bei 'Prg. starten' bergeben). 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, lokale Compiler- bzw. Assembleroptionen und Hilfstexte (Source-Inhalt) einstellen. Hilfstexte: Maximale Gr”že je Hilfstext ist 32KBytes. Die Hilfstexte werden nur im *.PC Projekt gespeichert, und nicht im *.PRJ Projekt. Clipboard-Untersttzung (^C, ^X, ^V, ^Y) Source-Compiler: Fr alle Dateien in der Source-Liste (ausgenommen sind *.C und *.S) kann ein Source-Compiler (nur *.TOS oder *.TTP) angegeben werden. Dieses Programm wird gestartet (Make, Make All und Icon 'Arbeit') wenn die Sourcedatei ein neueres Datum hat, als die unter 'Zeitverbleich mit:' angegebene Datei. Damit diese Programm verwendet wird, muž der Schalter 'Source-Compiler benutzen' eingeschaltet sein. Der Button 'Source' bewirkt, das der Name der Sourcedatei an die Kommandozeile angeh„ngt wird. Vor Aufruf des Source-Compilers wird der aktuelle Projekt-Pfad gesetzt, sodas nur der Name der Sourcedatei bergeben werden muž. =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. - *.PC Das Projekt wird erstellt. - *.PRJ Das Projekt wird erstellt. 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. * Wenn die Reihenfolge der Dateien wichtig ist, k”nnen einfach alle * Dateien (inkl. LIB's) in die Source-Liste (in der gewnschten Reihenfolge) * eingetragen werden. * Die Library-Liste bleibt dann leer. 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. **************************************************************************** ***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.