Dokumentation zur PC-Shell V3.00 (17.06.1995) ============================================= Stand: 23.07.1995 o Allgemeines o PC-Shell - Men o PC-Shell - Editor o PC-Shell - Projekte o Shareware o Lieferumfang o Installation o PC-Shell History Allgemeines =========== PC-Shell ist eine Alternative zur Pure C - Shell (PC.PRG) fr die Anwender des Pure C - Compilers. Die Highlights der PC-Shell sind: o Ersetzt PC.PRG o Compilierung im Hintergrund unter MagiC und MTOS o Untersttzt wahlweise PC_HELP oder ST-Guide o Kontext-Hilfe fr ST-Guide Alle Dialoge enthalten einen Hilfe-Button, ber den in die entsprechende Seite der Online-Hilfe verzweigt werden kann. o Komfortable Projekterstellung Projekte werden ber ein Projektfenster verwaltet, das sich intuitiv bedienen l„žt. (Listboxen, Drag & Drop, Icons, Untersttzung von Selectric) o Untersttzung von Subprojekten Projekte k”nnen weitere (Sub-) Projekte als Abh„ngigkeiten enthalten. o Dateibeschreibungen Jede Source-Datei in einem Projekt kann mit einer Beschreibung (< 32kB) versehen werden. o Source-Compiler Es k”nnen auch Source-Dateien im Projekt verwaltet werden, die weder C- noch Assembler-Sourcen sind. Fr solche Dateien kann jeweils ein Source-Compiler eingestellt werden, der diese Dateien bearbeitet. So k”nnen z.B. in einem Projekt aller Sourcen eines Programms und auch die ST-Guide - Beschreibung verwaltet werden. o Eingebauter Editor (PC-Editor) o Externe Editoren Alternativ zum PC-Editor werden von der PC-Shell bis zu 2 externe Editoren untersttzt. o Aufruf des RCS Es kann ein RCS ausgew„hlt werden, daž zur Bearbeitung von Resourcen automatisch gestartet wird. o ACS-Untersttzung Laden und erstellen von ACS-Modulen (ab ACS V2.20). o Programmstart ber F-Tasten Die Funktionstasten F1 - F10 k”nnen frei mit Programmen belegt werden. o Import/Export von .PRJ - Dateien PC-Shell verwendet fr Projekte ein eigenes Format in den .PC- Dateien. Es k”nnen jedoch .PRJ-Dateien sowohl gelesen als auch erzeugt werden. PC-Shell - Men =============== Das Men der PC-Shell enth„lt die folgenden Eintr„ge: o PC_SHELL o Datei o Editor o Compiler o Optionen o Extras o Hilfe PC-Shell - Men: PC_SHELL ========================= o Info... Programm-Info und Registrierung: Durch anklicken des Buttons "Registrieren" erscheint der Registrier-Dialog. Hier gibt man den Namen an, den man dem Autor bei der Registrierung mitgeteilt hat und den vom Autor zugesandten Schlssel. Nach der Eingabebest„tigung ("OK") teilt die PC-Shell mit, ob die Registrierung erfolgreich wahr. Im Falle einer erfolgreichen Registrierung muž man noch die .INF - Datei ("PC_SHELL.INF") sichern, damit die Registrierung auch ber das Programmende hinaus bekannt bleibt. PC-Shell - Men: Datei ====================== o PC neu... ^N Neues Projekt ”ffnen. Mit dem Fileselektor wird der Name der Projektdatei (*.PC) angegeben. o PC ”ffnen... ^P ™ffnet eine (schon vorhandene) Projektdatei (*.PC). o PC sichern ^J Sichert die ge”ffnete Projektdatei. o PC sichern als... Sichert die ge”ffnete Projektdatei, wobei ein anderer Projektname eingegeben werden kann. o PRJ ”ffnen... P ™ffnet eine original Pure C - Projektdatei (*.PRJ). o PRJ sichern... J Sichert die ge”ffnete Projektdatei als Pure C - Projektdatei (*.PRJ). o beenden ^Q Beenden der PC-Shell. PC-Shell - Men: Editor ======================= o *.C editieren... ^O *.C - Datei (C-Source) editieren. Dateiauswahl ber Fileselektor. o *.S editieren... *.S - Datei (Assembler-Source) editieren. Dateiauswahl ber Fileselektor. o *.H editieren... *.H - Datei (C-GIncludedatei) editieren. Dateiauswahl ber Fileselektor. o *.* editieren... *.* - Datei (beliebige Textdatei) editieren. Dateiauswahl ber Fileselektor. o Projekt-Suche... B 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 Mausklick auf diese Zeile wird die Datei in den zugeordneten Editor (bestimmt durch die Auswahl in 'Optionen/Source-Liste...' bzw 'Extras/Diverse...') geladen. Bei Verwendung des internen Editors (PC-Editor) wird der Cursor automatisch auf die betreffende Textstelle gesetzt. Bei manchen Editoren, wie z.B. EVEREST, ist es auch m”glich, das der Editor, durch Doppelklick auf eine Fehlermeldung, den Cursor in die dazugeh”rige Zeile der Sourcedatei setzt. PC-Shell - Men: Compiler ========================= o Compilieren... C Compiliert eine mit dem Fileselektor ausgew„hlte Datei. o Assemblieren... A Assembliert eine mit dem Fileselektor ausgew„hlte Datei. o Make M 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. Sind im Projekt Subprojekte enthalten, so wird auch fr alle Subprojekte 'Make' ausgel”st. o Make All X Erzeugt, aus den im Projektfenster angegebenen Source- und Library-Dateien, die unter 'Programm-Name' angegebene Datei. Es werden alle Sourcedateien neu compiliert bzw. assembliert. Sind im Projekt Subprojekte enthalten, so wird auch fr alle Subprojekte 'Make All' ausgel”st. Die Projekterzeugung kann durch l„ngeres drcken der beiden SHIFT-Tasten abgebrochen werden. o Linken Linkt das Projekt. Sind im Projekt Subprojekte enthalten, so wird auch fr alle Subprojekte 'Linken' ausgel”st. o Prg. debuggen D šbergibt das vom Projekt erzeugte Programm an den Pure C - Debugger. o Prg. profilen šbergibt das vom Projekt erzeugte Programm an den Pure - Profiler. (Nicht unter MTOS) o Prg. starten R Startet das vom Projekt erzeugte Programm. PC-Shell - Men: Optionen ========================= o Compiler... U Einstellen der Compiler-Optionen. o Assembler... I Einstellen der Assembler-Optionen. o Linker... O Einstellen der Linker-Optionen. o 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. o Pfade... Z Einstellen der Programmpfade. o Programme... G Ausw„hlen von Programmen die ber die Funktionstasten F1 - F10 gestartet werden k”nnen. o 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. o INF sichern... Sichern der PC_SHELL.INF Datei, sie enth„lt: - Die in 'Optionen/Pfade...', 'Optionen/Programme...', 'Optionen/Source-Liste...' und 'Extras/Diverse...' vorgenommenen Einstellungen. - Die in 'Optionen/Compiler...', 'Optionen/Assembler...' und 'Optionen/Linker...' angegebenen Include- und Library- Directories. - Zuletzt benutzter Pfad bei 'Extras/Module laden...'. - Die Position und Gr”že der einzelnen Fenster. - Alle ge”ffneten Fenster. - Die geladene Projektdatei. - Den Registrierschlssel. o INF laden... H Laden einer INF-Datei. Hier werden die fr das aktuelle Projekt globalen Compileroptionen eingestellt. Siehe auch Pure C - Compilerhandbuch Anhang B : PCC o A - Nur ANSI-Standard zugelassen Alle nicht ANSI/ISO konformen Erweiterungen sind nicht erlaubt. Z.B. die Pure C spezifischen Spracherweiterungen cdecl und pascal sind nach dem Setzen dieser Option nicht mehr erlaubt. o B - DRI-Object Format erzeugen Objekte werden im DRI (Digital Research) - Objektformat erzeugt. Wichtig: im DRI-Format werden globale Symbole nur in den ersten 8 Zeichen unterschieden, wobei nicht zwischen Grož- und Klein- schreibung unterschieden wird. o C - Verschachtelte Kommentare Verschachtelte C-Kommentare sind zul„ssig. o G - Programmgr”žen-Optimierung Programm-Optimierung in Hinblick auf die Programmgr”že. Defaultm„žig werden Programme laufzeitoptimeirt. o H - cdecl-Parameterbergabe šbergabe aller Funktionsparameter ber den Stack nach der cdecl Calling Convention: Funktionsparameter werden von rechts nach links auf dem Stack abgelegt. Die aufrufende Funktion hat fr die Stackkorrektur nach Abschluž der Funktion zu sorgen. o J - Prg-prnge nicht optimieren Sprungbefehle werden nicht optimiert. o K - char Datentyp ist unsigned Alle Variablen/Funktionen vom Typ char werden behandelt wie unsigned char. Default: char <--> signed char o M - Strings nicht zusammenlegen Identische Strings werden nicht zusammengelegt. o N - Objekt-Datei in Verzeichnis Die Objekt-Dateien werden nicht im aktuellen Directory (Projekt- Directory) erzeugt, sondern im angegebenen Directory. Durch anklicken des Editfeldes kann mit dem Fileselektor das Directory ausgew„hlt werden. o P - Absolute Unterprogramm-Aufrufe Unterprogramm-Aufrufe, die nicht im selben Modul liegen, werden absolut adressiert. Default: PC-relative Adressierung. o Q - pascal-Parameterbergabe Funktionsparameter werden von links nach rechts auf dem Stack abgelegt. Die aufrufende Funktion hat fr die Stackkorrektur nach Abschluž der Funktion zu sorgen. o R - Keine Register-Variablen Es werden keine Register-Variablen verwendet. o S - LINK und UNLINK verwenden Es wird der Standardstackaufbau, unter Verwendung der Assembler- anweisungen LINK und UNLINK, erzwungen. o T - Stack Laufzeit-šberprfung Bei jedem Funktionsaufruf wird der Stack berprft. o V - Protokoll ausgeben Protokoll der Compilierung ausgeben. o X - Vor jedem Symbol '_' setzen Vor jedem Symbol (Variable/Funktion) wird ein Underbar ('_') generiert. o Y - Debugger-Info's einfgen Es werden Informationen fr den Pure Debugger erzeugt. o Z - Keine Registeroptimierung Es wird keine Optimierung der Nutzung der Registervariablen durchgefhrt. Damit wird sichergestellt, daž eine Register- variable jedesmal neu geladen wird, wenn ein Zugriff erfolgt. o 2 - Code fr 68020 erzeugen Es wird Code fr den MC68020 erzeugt. o 8 - Code fr 68881 erzeugen Es wird Code fr die FPU 68881/2 erzeugt. Zu so compilierten Objects muž statt der PCFLTLIB.LIB die PC881LIB.LIB dazugebunden werden. o Zusatz-Optionen Hier k”nnen die Optionen -Dmacro[=value] und -Umacro verwendet werden, sowie die Warning-Optionen von Pure C. o Include directory Durch anklicken des Editfeldes erscheint eine Pop-UP - Box, in der, mit Hilfe des Fileselektors, bis zu 2 x 4 Directories vor- gegeben werden k”nnen, in denen der Compiler nach Include-Dateien sucht. Die ersten 4 Directories geh”ren zur Grundeinstellung und werden in der .INF - Datei gesichert. Die anderen 4 Directories sind projektspezifische Include-Directories und werden in der ent- sprechenden .PC- bzw .PRJ-Datei gesichert. o Compiler-Halt nach ... Fehlern Hier kann eingestellt werden, nach wievielen Fehlern der Compiler die Bearbeitung abbricht. o Compiler-Halt nach ... Warnungen Hier kann eingestellt werden, nach wievielen Warnungen der Compiler die Bearbeitung abbricht. o Warnstufe (0 - 2) 0 : keine Warnungen 1 : alle Default-Warnungen aktiv 2 : alle Warnungen aktiv Liste der Warnungen ==> o Maximale L„nge der Bezeichner Hier kann eingestellt werden, bis zu welcher L„nge globale Symbole (Variablen, Prozeduren) unterschieden werden. Der Pure C - Compiler untersttzt die folgenden hier angegebenen Warnungsoptionen. Alle mit (DEF) markierten Warnungen sind bei der Warnstufe 1 aktiviert. Im allgemeinen sollte immer die Warnstufe 2 gew„hlt werden, um ein maximale Portabilit„t der Sourcen zu gew„hrleisten. Verletzungen des ANSI - Standards -Wdup (DEF) Redefinition von '...' ist nicht identisch. -Wret (DEF) Die return-Anweisungen der Funktion '...' liefern sowohl einen Wert als auch keinen (nur return;). -Wstr (DEF) '...' ist nicht Bestandteil einer Struktur. -Wstu (DEF) Struktur '...' nicht definiert. -Wsus (DEF) Verd„chtige Pointer-Umwandlung. -Wvoi (DEF) void-Funktionen drfen kein Ergebnis zurckgeben. -Wzst (DEF) Struktur hat L„nge 0. H„ufig auftretende Fehler -Waus (DEF) '...' erh„lt einen Wert zugewiesen, der nicht weiter verwendet wird. -Wdef (DEF) '...' wird vor der Zuweisung eines Wertes verwendet. -Weff (DEF) Wirkungsloser Code. -Wpar (DEF) Parameter '...' wird nicht verwendet. -Wpia (DEF) Zuweisung m”glicherweise falsch. -Wrch (DEF) Programm-Code nicht erreichbar. -Wrvl (DEF) Funktion sollte einen Wert zurckliefern. Weniger h„ufige Fehler -Wamb Mehrdeutige Operatoren sollten mit Klammern gegliedert werden. -Wamp šberflssiger Adrež-Operator vor Funktion oder Array. -Wnod Funktion '...' nicht deklariert. -Wpro (DEF) Funktionsaufruf ohne Prototyp. -Wstv Strukur als Wert bergeben. -Wuse '...' deklariert aber nicht verwendet. Warnungen vor Portabilit„tsproblemen -Wapt (DEF) Pointer-Zuweisung ist nicht portabel. -Wcln long - Konstante -Wcpt (DEF) Pointer-Vergleich ist nicht portabel. -Wrng (DEF) Konstante zu grož in einem Vergleichsausdruck. -Wsig Verlust signifikanter Stellen bei einer Umwandlung. -Wucp Es werden gemischte Pointer auf signed char und unsigned char verwendet. -Wrpt (DEF) Nicht portabele Umwandlung bei einer Ergebnis-Rckgabe. Einzelne Warnungsoptionen lassen sich auch gezielt abschalten. Will man z.B. die Option -Wpro abschalten, so gibt man bei den Zusatz- optionen -W-pro an. Die Warnungsoptionen k”nnen auch in der Source ein- bzw ausge- schaltet werden: #pragma warn +cln (entspricht: -Wcln) #pragma warn -cln (entspricht: -W-cln) Hier werden die fr das aktuelle Projekt globalen Assembleroptionen eingestellt. Siehe auch Pure C - Assemblerhandbuch Anhang A : Kommandozeilenparameter o A - Alle Makros expandiert ausgeben o B - DRI-Objekt Format erzeugen Objekte werden im DRI (Digital Research) - Objektformat erzeugt. Wichtig: im DRI-Format werden globale Symbole nur in den ersten 8 Zeichen unterschieden, wobei nicht zwischen Grož- und Klein- schreibung unterschieden wird. o C - Include-Dateien nicht ausgeben o F - Nicht zutreffende Teile der bedingten Assemblierung nicht ausgeben o M - Keine Makro-Zeilen ausgeben o N - Objekt-Datei in Verzeichnis Die Objekt-Dateien werden nicht im aktuellen Directory (Projekt- Directory) erzeugt, sondern im angegebenen Directory. Durch anklicken des Editfeldes kann mit dem Fileselektor das Directory ausgew„hlt werden. o P - Listing ausgeben Es wird ein Listing erzeugt (.LST - Datei). o S - Supervisor-Befehle zulassen Supervisor Calls drfen verwendet werden. o U - Undefinierte Symbole werden extern deklariert o V - Ausfhrlichen Bericht ausgeben Protokoll der Assemblierung ausgeben. o Y - Informationen fr Pure Debugger erzeugen Es werden Informationen fr den Pure Debugger erzeugt. o 1 - 68010-Befehle zulassen o 2 - 68020-Befehle zulassen o 3 - 68030-Befehle zulassen o 4 - 68040-Befehle zulassen o 5 - 68851-Befehle zulassen o 8 - 68881-Befehle zulassen o Zusatz-Optionen Hier k”nnen Optionen der Form -D=macro[=value] verwendet werden. o Include-Directory Durch anklicken des Editfeldes erscheint eine Pop-UP - Box, in der, mit Hilfe des Fileselektors, bis zu 4 + 2 Directories vor- gegeben werden k”nnen, in denen der Assembler nach Include-Dateien sucht. Die ersten 4 Directories geh”ren zur Grundeinstellung und werden in der .INF - Datei gesichert. Die anderen 2 Directories sind projektspezifische Include-Directories und werden in der ent- sprechenden .PC- bzw .PRJ-Datei gesichert. Hier werden fr das aktuelle Projekt die Linkeroptionen eingestellt. Siehe auch Pure C - Assemblerhandbuch Anhang C : Der Pure Linker o F - Fastload-Bit nicht setzen o G - Globale Symbole in Symboltabelle einfgen o J - Neue Objektdatei (*.O) erzeugen o L - Lokale Symbole in Symboltabelle einfgen o M - Malloc-Aufrufe reservieren ST-RAM (nur TT) o R - Das Program wird in ST-RAM geladen (nur TT) o V - Link-Informationen ausgeben o Y - Informationen fr Pure Debugger einfgen o Startup Name der Objektdatei mit dem C-Startupcode. (Auswahl mit Fileselektor) o Library directory Directory, in dem die Pure C - Libraries stehen. (Auswahl mit Fileselektor) o TEXT-Segment Adresse Vorgabe der Startadresse des TEXT-Segmentes bei relozierbarem Code. o DATA-Segment Adresse Vorgabe der Startadresse des DAAT-Segmentes bei relozierbarem Code. o BSS -Segment Adresse Vorgabe der Startadresse des BSS-Segmentes bei relozierbarem Code. o Stack Vorgeben einer Stackgr”že fr das Programm. Default: 4096 Bytes o Heap (nur TT) Angabe, wieviel Speicher das Programm mindestens ben”tigt. Zul„ssige Werte: 128kB bis 2048kB in Schritten von 128kB. o Editor-1 Auswahl des Editor-1 o Editor-2 Auswahl des Editor-2 o RCS Auswahl des Resource Construction Sets o Pure-C In diesem Verzeichnis mssen sich die Pure C - Programme befinden: PD.PRG, PASM.TTP, PCC.TTP, PLINK.TTP, PROFILER.PRG Hinweis fr Pure - Profiler - Benutzer ==> o Hilfe-Prg Pfad des PC_HELP - Programmes Dieser Eintrag ist nur notwendig, wenn PC_HELP nicht als Accessory l„uft und von PC_SHELL.APP zur Laufzeit gestartet werden soll. o Editor-1 Parameter Parameter zum Aufruf von Editor-1 o Editor-2 Parameter Parameter zum Aufruf von Editor-2 Pure C und Pure - Profiler benutzen verschiedene Formate fr die .HLP - Dateien. Werden z.B. PD.PRG und PROFILER.PRG im selben Directory abgelegt, so kommt es zu Namenskonflikten bei den .HLP - Dateien. Abhilfe: Im Pure - Profiler kann man unter 'Options/Environment...' den Suchpfad fr die .HLP - Dateien einstellen. Man kann deshalb z.B. im Pure-C - Pfad ein Directory PROFILER.HLP anlegen und dort die .HLP - Dateien des Pure - Profilers ablegen. In der PC-Shell k”nnen die Funktionstasten F1 - F10 frei mit Programmen belegt werden. o Parameter Hier k”nnen die Parameter beschrieben werden, die beim Programmstart mitbergeben werden sollen. o Programm Es erscheint der Fileselektor, mit dem man ein Programm ausw„hlen kann. o Halt nach Programende Es wird am Programmende der Programm-Status (Exit-Code) ausgegeben und auf eine Eingabe gewartet. (Nicht unter MagiC, da die Programme parallel gestartet werden) o Starten Das ausgew„hlte Programm wird mit den angegebenen Parametern gestartet. Es k”nnen bis zu 4 verschiedene Editoren (A-D) ausgesucht werden, die zur Bearbeitung der im Projektfenster zus„tzlich (zu Programm- sourcen) angegebenen Dateien dienen. Jedem Editor k”nnen mehrere Dateitypen (gleich Datei-Extender) zugeordnet werden. Ist z.B. das ACS.PRG fr den Datei-Extender *.ACS eingetragen, wird fr das editieren einer *.ACS Datei das ACS.PRG geladen. PC-Shell - Men: Extras ======================= o Resource... K Auswahl einer Resource-Datei mit dem Fileselektor und starten des Resource-Editors. o Debugger... Auswahl eines Programms mit dem Fileselektor und starten des Pure Debuggers. o Profiler... Auswahl eines Programms mit dem Fileselektor und starten des Pure Profilers. (Nicht unter MTOS) o Modul laden... Auswahl eines ACS-Moduls (*.AM) mit dem Fileselektor und Laden des Moduls. o Diverse... V Einstellungen o Desktop-Farbe Auswahl der Desktopfarbe, ab einer Aufl”sung >= 16 Farben (nur Single-TOS). o Fehlermeldungen ™ffnet das Fehlermeldungen-Fenster. o Source-Inhalt ”ffnet ein Fenster, in dem die Beschreibungen der Source-Dateien ausgegeben werden. Durch Mausklick auf den Dateinamen, wird die Datei in den Editor geladen. o Fenster-Popup W ”ffnet ein Popup-Fenster zum Toppen eines PC-Shell - Fensters. o Fenster ^W Aktuelles Fenster wechseln. o PRG starten... E Starten eines beliebigen Programms, das ber den Fileselektor ausgew„hlt wird. o Projekt - Bei Prg. starten/debuggen Projekt aktualisieren Bevor das Programm gestartet bzw der Debugger/Profiler aufge- rufen wird, wird von der PC-Shell das Projekt aktualisert, d.h.: es werden vor dem Aufruf alle Abh„ngigkeiten berprft und, wenn n”tig, eine neue Programmversion gebunden. - Quelltexte automatisch sichern Vor dem Starten eines Programms (bzw des Debuggers oder des Profilers) werden alle Quelltexte automatisch gesichert. - Im Hintergrund compilieren (Nur MagiC und MTOS) Ist diese Option ausgew„hlt, so werden die fr die Projekt- aktualisierung notwendigen Programme (Compiler, Linker, ...) parallel gestartet. o Editor Auswahl des Default-Editors fr PC-Shell - Internen Editor benutzen (PC-Editor) - Editor 1 benutzen - Editor 2 benutzen - ARGV Editor-1/2 Legt fest, ob PC-Shell beim Aufruf des Editors das ARGV-Protokoll verwendet. Nicht unter MagiC V2.x selektierbar. o Allgemein - Grow/Shrink-Boxen abschalten Das Zeichnen der Gro/Shrink-Boxen l„žt sich mit dieser Option abschalten. - Pulldown-Mens abschalten Ist diese Option ausgew„hlt, so werden ein Dropdown-Men statt des Pulldown-Mens im Fenster des internen Editors verwendet. - Dialoge in Mauszeigern„he zeichnen - Mauszeiger verstecken Ist diese Option ausgew„hlt, verschwindet der Mauszeiger sobald eine Taste gedrckt wird und erscheint erst wieder bei einer Mausbewegung. - 3D-Effekte abschalten Die 3D-Effekte bei der Darstellung der Dialoge wird abgeschaltet. Nur auf Farbbildschirmen selektierbar. - Einstellungen automatisch sichern Beim Verlassen der PC-Shell werden die aktuellen Einstellungen in der Datei PC_SHELL.INF gesichert. o Hilfe-Programm Auswahl der in PC-Shell benutzten Online-Hilfe - Als Programm starten Wird das Hilfe-Programm nicht als laufende Anwendung gefunden, so wird es im Bedarfsfall als Programm gestartet. Der Pfad und der Dateiname fr das zu startende Hilfe-Programm kann im Dialog 'Optionen/Pfade...' eingestellt werden. - PC-Help verwenden - ST-Guide verwenden - Hypertext Ist der ST-Guide ausgew„hlt, kann man hier die Hypertextdatei oder die Referenz eintragen, die die PC-Shell bei ihren Zugriffen auf das Online-Hilfesystem verwenden soll. In der Regel ist das die Datei PC_SHELL.REF oder aber die ALL.REF. o Datei-Extender fr Resource-Dateien Dateien mit der eingestellten Endung werden im Fileselektor in 'Extras/Resource...' verwendet. (Typischerweise .RCS fr ein Resource Construction Set und .ACS fr ACS). 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 die Datei in den zugeordneten Editor (bestimmt durch die Auswahl in 'Optionen/Source-Liste...' bzw 'Extras/Diverse...') geladen. Bei Verwendung des internen Editors (PC-Editor) wird der Cursor automatisch auf die betreffende Textstelle gesetzt. Bei manchen Editoren, wie z.B. EVEREST, ist es 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 das eingestellte Hilfe-System (PC_HELP oder ST-Guide) bei Fehlermeldungen aufgerufen. PC-Shell - Men: Hilfe ====================== Unter dem Menpunkt Hilfe lassen sich verschieden, wichtige Seiten der Online-Hilfe direkt ”ffnen: o PC-Shell... ™ffnen der Main-Seite der Online-Hilfe. o Men... ™ffnen der PC-Shell-Men-Beschreibung in der Online-Hilfe. o Editor... ™ffnen der Beschreibung des internen Editors der Online-Hilfe. o Index... ™ffnen der Index-Seite der Online-Hilfe. PC-Shell - Editor ================= Integriert in die PC-Shell ist ein eigener (interner) Editor. Das Men des internen Editors enth„lt die folgenden Eintr„ge: Datei Bearbeiten Suchen Extras Tastaturbedienung Der PC-Editor basiert auf dem Editor, der dem ACS pro V2.17 beiliegt. PC-Shell - Editor: Datei ======================== o ™ffnen... Es wird eine Datei in den Editor eingelesen. Eine vorher schon im Editor befindliche Datei wird dabei (im Editor) nach Rckfrage berschrieben. o Hinzufgen... ^H Ab Cursor wird die ausgew„hlte Datei eingefgt. o Sichern ^S Die Datei wird zurckgeschrieben. o Sichern als... ^M Die Datei kann unter einem anderen Namen gesichert werden. o Information... Es wird die Anzahl der Zeilen und die Gr”že der Datei angezeigt. o Schliežen ^U Der Editor wird geschlossen. Ist die aktuelle Datei noch nicht gesichert worden, so erfolgt eine Sicherheitsabfrage: PC-Shell -Editor: Bearbeiten ================================= o Rckg„ngig UNDO Die zuletzt ausgefhrte Operation wird zurckgenommen. o Ausschneiden ^X Der markierte Block wird in den internen Puffer kopiert und im Editor gel”scht. o Kopieren ^C Der markierte Block wird in den internen Puffer kopiert. o Einfgen ^V Der interne Puffer wird ab Cursor in das Editorfenster geschrieben. o Zeile aussch. ^Y Die Zeile, in der sich der Cursor befindet, wird ausgeschnitten, d.h. in den internen Puffer kopiert und im Editor gel”scht. o Block markieren ^B Mit "Block markieren" wird die jeweils aktuelle Cursorposition als Blockanfang bzw Blockende markiert. o Links einrcken ^J o Rechts einrcken ^K Der markierte Block wir um eine Tabulator-Position nach links bzw rechts verschoben. Die Gr”že von TAB kann unter 'Extras/Optionen..' eingestellt werden. Der Default ist 8. PC-Shell - Editor: Suchen ========================= o Finden... ^F Im Editfeld kann man den Text eingeben der im aktuellen Editor- fenster gesucht werden soll. o N„chster ^G Die Suche wird mit den unter 'Finde' vorgenommenen Einstellungen ab der aktuellen Cursorposition fortgesetzt. o Selektion ^I Der markierte Block wird als Suchstring bernommen. o Ersetzen... ^R In den Editfeldern kann man oben den Text angeben der gesucht werden soll und darunter den Text, durch den der gesuchte Text ersetzt werden soll. o N„chster ^T Das Ersetzen wird ab der aktuellen Cursorposition mit den unter 'Ersetze' vorgenommenen Einstellungen fortgesetzt. o Gehe zu... ^L Positionieren auf eine vorzugebende Zeile (Zeilennummer). o Setze Marke (CTRL 1, ..., CRTL 4) Es k”nne bis zu 4 Marken im Text gesetzt werden. Durch 'Gehe zu Marke...' kann auf eine so markierte Zeile direkt positioniert werden. o Gehe zu Marke... (ALT 1, ..., ALT 4) Auswahl einer Marke PC-Shell - Editor: Extras ========================= o šberschreiben INS Umschalten zwischen Einfge- und šberschreibmodus o Optionen.. T Selektionen Auswahl des Selektionsmodes fr Bl”cke: - kontinuierlich Es werden im selektierten Bereich alle Zeilen markiert. - Spaltenblock Mit der Maus wird ein Rechteck aufgezogen, das als Block markiert wird. Cursor Auswahl der Cursor-Darstellung im Editorfenster. Allgemein - autom. Einrcken - GEM-Klemmbrett Anstatt des internen Puffers wird das GEM-Klemmbrett (Clipboard) verwendet. TAB Einstellen der Tabulatorweite (Default: 8). o Help-ACC HELP Das unter dem Cursor befindliche Wort wird an das eingestellte Hilfesystem bergeben. o Projekt-Suche HELP Fr das unter dem Cursor befindliche Wort wird eine Projekt-Suche gestartet. o Fonts... Im Fontselektor kann ein nicht-proportionaler GDOS-Font ausge- w„hlt werden, der zur Darstellung im PC-Editor benutzt werden soll. o Einst. sichern Die Editor-Einstellungen werden in der Datei EDITOR.CFG gesichert. Die Datei wird in dem Dierctory erzeugt, in dem sich auch PC_SHELL.APP befindet. Tastaturbedienung des PC-Editors ================================ o CURSOR-Links CURSOR-Rechts CURSOR-Oben CURSOR-Unten Cursor-Positionierung um ein Zeichen nach links/rechts/oben/unten ver„ndern. o SHIFT CURSOR-Links SHIFT CURSOR-Rechts Cursor auf Zeilenanfang bzw -ende positionieren. o SHIFT CURSOR-Oben SHIFT CURSOR-Unten Eine Seite zurck/vorw„rts bl„ttern o CONTROL CURSOR-Links CONTROL CURSOR-Rechts Cursor auf vorherigen/n„chsten Wortanfang positionieren. o HOME Auf die 1. Zeile der Datei positionieren. o SHIFT HOME Auf die letzte Zeile der Datei positionieren. o HELP Aufruf der Online-Hilfe (PC_HELP oder ST-Guide) fr das Wort, das sich an der Cursorposition befindet. o SHIFT HELP Projektsuche fr das Wort, das sich an der Cursorposition befindet. o INS Umschalten vom Insert- in den šberschreibmodus und zurck. o UNDO Die zuletzt ausgefhrte Operation wird zurckgenommen. o CONTROL 1 CONTROL 2 CONTROL 3 CONTROL 4 Marke 1 - 4 setzen o CONTROL B Mit "Block markieren" wird die jeweils aktuelle Cursorposition als Blockanfang bzw Blockende markiert. o CONTROL C Der markierte Block wird in den internen Puffer kopiert. GEM-Klemmbrett: Der markierte Block wird im Clipboard als Datei SCRAP.TXT abgelegt o SHIFT CONTROL C GEM-Klemmbrett: Der markierte Block wird im Clipboard an den Inhalt der Datei SCRAP.TXT angeh„ngt. o CONTROL F String suchen. o CONTROL G Weitersuchen. o CONTROL H Ab Cursor wird die ausgew„hlte Datei eingefgt. o CONTROL I Der markierte Block wird als Suchstring bernommen. o CONTROL J Der markierte Block wir um eine Tabulator-Position nach links verschoben. o CONTROL K Der markierte Block wir um eine Tabulator-Position nach rechts verschoben. o CONTROL L Positionieren auf die angegebene Zeile. o CONTROL M Die Datei kann unter einem anderen Namen gesichert werden. o CONTROL R String durch einen anderen String ersetzen. o CONTROL S Die Datei wird zurckgeschrieben. o CONTROL T Ersetzung wiederholen. o CONTROL U Der Editor wird geschlossen. Ist die aktuelle Datei noch nicht gesichert worden, so erfolgt eine Sicherheitsabfrage. o CONTROL V Der interne Puffer wird ab Cursor in das Editorfenster geschrieben. GEM-Klemmbrett: Der Inhalt der Datei SCRAP.TXT wird ab Cursor in das Editorfenster geschrieben. o CONTROL X Der markierte Block wird in den internen Puffer kopiert und im Editor gel”scht. GEM-Klemmbrett: Der markierte Block wird im Clipboard als Datei SCRAP.TXT abgelegt und im Editor gel”scht. o CONTROL Y Die Zeile, in der sich der Cursor befindet, wird ausgeschnitten, d.h. in den internen Puffer kopiert und im Editor gel”scht. GEM-Klemmbrett: Die Zeile wird im Clipboard in der Datei SCRAP.TXT abgelegt und im Editor gel”scht. o ALTERNATE 1 ALTERNATE 2 ALTERNATE 3 ALTERNATE 4 Marke 1 - 4 anspringen o ALTERNATE T PC-Editor Optionen-Dialog aufrufen. PC-Projekt ========== Das jeweils aktuelle PC-Shell-Projekt wird im sogennanten Projektfenster dargestellt. Das Projektfenster besteht aus zwei Listboxen, jeweils einer fr Source-Dateien (max. 500) und einer fr Library-Dateien (max. 100). Die Auswahl und Bearbeiten der Source- und Library-Dateien geschieht durch Drag & Drop. Fr die Bedienung der Abh„ngigkeiten-Listbox gilt das unten beschriebene auch. Die Source-Dateien werden bei der Projekterstellung ('Compiler/Make' oder 'Compiler/Make All') folgendermažen bearbeitet: - *.C Dateien werden compiliert - *.S Dateien werden assembliert - *.O Dateien werden hinzugelinkt - *.LIB Dateien werden hinzugelinkt - *.PC Das Subprojekt wird aktualisiert - *.PRJ Das Subprojekt wird aktualisiert alle anderen Dateien werden ignoriert oder es wird fr sie der ausgew„hlte Source-Compiler gestartet. So kann man z.B. auch Headerdateien (*.H) mit in die Source-Dateien-Liste bernehmen, um sie zum editieren nicht suchen zu mssen. Ist ein Subprojekt (*.PC bzw *.PRJ) angegeben, so wird es (wenn n”tig) aktualisiert. Ist das Ergebnis ein Objekt (*.O bzw *.LIB), so wird es zum aktuellen Projekt hinzugebunden. Subprojekte k”nnen auch Subprojekte beinhalten. Die Library-Dateien mssen sich im Library-Directory befinden. (siehe 'Optionen/Linker...') 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. Projektfenster Source-Beschreibung Source-Compiler Wird das Projekt geschlossen, bevor Ver„nderungen, die in der .PC-Datei enthalten sind, gesichert wurden, erscheint eine Sicherheitsabfrage. Ausnahme: Im Dialog 'Extras/Diverse...' ist die Option "Einstellungen automatisch sichern" ausgew„hlt. PC-Shell - Projektfenster ========================= Beschreibung der Bedienelemente Tastaturbedienung Cursorbedienung Projektfenster: Beschreibung der Bedienelemente =============================================== o ? PC-Shell Programminfo (Entspricht dem Aufruf von 'PC_SHELL/Info...') o Prg.-Name Dialog N o Icon Source S Ausw„hlen von Source-Dateien im Fileselektor. (Selectric wird untersttzt) o Icon Library L Ausw„hlen von Library-Dateien im Fileselektor. (Selectric wird untersttzt) o Klemmbrett ^C / ^V speichern : Ziehen von Source- oder/und Library-Dateien auf das Klemmbrett. laden : Ziehen des Klemmbrettes in die Source- oder Library-Listbox o Mlleimer ^D L”schen : Ziehen von Source- oder/und Library-Dateien auf den Mlleimer. o Edit ^E 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. o Arbeit ^B Compilieren/Assemblieren/Source-Compiler Ziehen von Source-Dateien auf das Arbeit-Icon, oder Source-Dateien selektieren und Klick auf das Arbeit-Icon. Wird ein Subprojekt-Eintrag auf das Arbeit-Icon gezogen, so wird ein 'Make All' fr das Subprojekt durchgefhrt. o Option ^I Abh„ngigkeiten, lokale Compiler- bzw. Assembleroptionen und Hilfstexte (Source-Inhalt) einstellen. Es wird unterschieden zwischen - C- und Assemblersourcen - andere Dateien Projektfenster: Tastaturbedienung ================================= - Source neu (S) - Library neu (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. Projektfenster: Cursorbedienung =============================== - 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 (^A) der Cursor befindet, selektieren. - 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. Projektfenster: Prg.-Name o Pfad P Verzeichnis, in dem die unter Programm-Name angelegte Datei abgelegt wird. o Programm-Name Name des Programms, das im Projekt gebunden wird. Dateien mit der Extention .AM werden als ACS-Module betrachtet und geladen. o Kommandozeile Kommandozeile, mit der das Programm unter 'Compiler/Prg. starten' aufgerufen wird. Projektfenster: Option (Sourcen) ================================ In der Listbox k”nnen fr die in der Source-Listbox ausgew„hlte Datei weitere Dateien eingetragen werden, von denen die ausgew„hlte Datei abh„ngt (typischerweise .H - Dateien bei C-Sourcen). o Neu ^N Mit dem Fileselektor kann eine Datei ausgew„hlt werden, die in die Abh„ngigkeitsliste eingetragen wird. o Clipboard ^C / ^V o Mlleimer ^D Die in der Listbox selektierten Dateien werden aus der Listbox entfernt. o 'includes' ermitteln i Es werden alle #include - Dateien ermittelt, von der die Source abh„ngt und in die Abh„ngigkeitenliste eingetragen. Diese Funktion soll die Erstellung der Abh„ngigkeitenliste ver- einfachen. Es werden hier immer alle #include - Dateien einge- tragen, d.h.: auch #include - Dateien die nur durch "conditonal compiling" inkludiert werden, z.B.: #ifdef DEBUG #include "debug.h" #endif wird auch dann inkludiert, wenn das Makro DEBUG nicht definiert ist. o Optionen p Einstellen der Compiler/Assembler-Optionen fr die ausgew„hlte Datei. Vor Aufruf von Optionen (p) kann man ausw„hlen, welches die Default-Compileroptionen seien sollen: - globale Optionen g Es sind die Compiler-/Assembleroptionen gesetzt, die in 'Optionen/Compiler...' bzw in 'Optionen/Assembler...' eingestellt sind. - lokale Optionen l Es werden nur die lokalen Compiler/Assembler-Optionen verwendet. Die voreingestellten globalen Optionen werden in in diesem Fall nicht bercksichtigt. ==> C-Sourcen ==> Assemblersourcen o Source-Inhalt S Anschauen/ver„ndern der Dateibeschreibung Projektfenster: Option (Dateien) ================================ Fr alle Dateien in der Source-Listbox, die keine C- oder Assemblersourcen sind, kann ein Source-Compiler (nur *.TOS oder *.TTP) angegeben werden. Dieses Programm wird nur dann gestartet ('Compiler/Make', 'Compiler/Make All' und Icon 'Arbeit') wenn die Sourcedatei ein neueres Datum hat, als die Zieldatei (kann unter 'Zeitvergleich mit:' angegeben werden). o Program P Auswahl des Source-Compilers mit dem Fileselektor. o Kommandozeile Kommandozeile, die beim Aufruf des Source-Compilers benutzt werden soll. o Source-Compiler benutzen c Nur wenn der Schalter ausgew„hlt ist, wird der Source-Compiler fr die Datei aufgerufen. Vor Aufruf des Source-Compilers wird der aktuelle Projekt-Pfad gesetzt, sodaž nur der Name der Sourcedatei bergeben werden muž. o Source r Der Button bewirkt, daž der Name der Datei an die Kommandozeile angeh„ngt wird. o Zeitvergleich mit Z o Source-Inhalt S Anschauen/ver„ndern der Beschreibung Projektfenster: Optionen: Compileroptionen ========================================== Die Maske stimmt im wesentlichen mit der Maske fr die allgemeinen Compileroptionen in 'Optionen/Compiler...' berein. Zus„tzlich steht hier die Option O - Objekt-Datei umbenennen zur Verfgung. Die Objektdatei wird nicht unter ihrem Defaultnamen (z.B. SAMPLE.C --> SAMPLE.O) abgelegt, sondern unter dem hier ange- gebenen Namen. Ist keine Extention angegeben, so wird die Extention ".O" verwendet. Projektfenster: Optionen: Assembleroptionen =========================================== Die Maske stimmt im wesentlichen mit der Maske fr die allgemeinen Assembleroptionen in 'Optionen/Assembler...' berein. Zus„tzlich steht hier die Option O - Objekt-Datei umbenennen zur Verfgung. Die Objektdatei wird nicht unter ihrem Defaultnamen (z.B. SAMPLE.S --> SAMPLE.O) abgelegt, sondern unter dem hier ange- gebenen Namen. Ist keine Extention angegeben, so wird die Extention ".O" verwendet. Source-Beschreibung =================== Zu jeder Datei in der Source-Listbox im Projektfenster kann eine Beschreibung eingegeben werden. Fr die Beschreibungen gilt: - Maximale Gr”že je Beschreibung ist 32KBytes. - Die Beschreibungen werden in der zugeh”rigen .PC - Projektdatei gespeichert. - Clipboard-Untersttzung (^C, ^X, ^V, ^Y) Shareware ========= PC-Shell ist Shareware Registrierung, Kritik, Fragen und Anregungen zur PC-Shell an Frank Schramm Kasperstraže 5 D-21647 Moisburg Tel.: 04165-6173 MausNet : Frank Schramm @ HH2 Bankverbindung: StSpk Buxtehude BLZ: 241 520 80 Kto: 876235 Die Benutzung von PC-Shell kostet DM 20.- (Bar, Scheck oder šberweisung) an den Autor. 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, daž die komplette Anschrift angegeben wird, ggf. auch die Telefonnummer oder E-Mail-Anschrift (MausNet). Der Registrierungs-Schlssel wird nach erfolgter Bezahlung, nach Wunsch telefonisch, per Brief oder per E-Mail (MausNet) mitgeteilt. Registrierte Benutzer k”nnen jederzeit, durch zusenden einer formatierten Diskette und einem frankiertem Rckumschlag, die neueste Version beim Autor bekommen. HAFTUNGSAUSSCHLUSS PC-Shell wurde ausfhrlich getestet. Fr etwaige Sch„den, die durch die Verwendung von PC-Shell entstehen, kann der Autor keine Haftung bernehmen. Lieferumfang ============ Die aktuelle PC-Shell-Version wird als Archiv PC_300.LZH zur Verfgung gestellt. In diesem Archiv befinden sich die folgenden Dateien: - PC_SHELL.APP PC-Shell - Programm - PC_SHELL.AM ACS-Modul zum Bearbeiten von Unterprojekten. (Muž im gleichen Verzeichnis sein, wie PC_SHELL.APP) 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 Dieses Programm wird von PC-Shell unter MTOS und MagiC zum Compilieren im Hintergrund ben”tigt. (Muž im gleichen Verzeichnis sein, wie PC_SHELL.APP) Bei MagiC muž VT52.PRG installiert sein. - PC_SHELL.HYP, PC_SHELL.REF Online-Hilfe im ST-Guide-Format - PC_SHELL.TXT PC-Shell-Anleitung im ASCII-Format. - CHANGES.TXT Beschreibung der Versions„nderungen - PC_SHELL.UPL Upload-Text fr Mailboxen. - ST_GUIDE.TXT Eine Beschreibung zur Konvertierung der Dateien C.HLP, LIB.HLP und PASM.HLP aus dem Pure C - Systems in das ST-Guide - Format. Untersttzt wird die derzeit aktuelle Pure C - Version V1.1 vom 20.03.1993. PC-Shell l„uft auf TOS-Versionen >=1.04, MTOS und MagiC und einer Mindestaufl”sung mit 640 Pixeln Breite und 400 Pixeln H”he. ACS-Module laden ist m”glich fr Module, die mit der ACS V2.20 (oder h”her) erstellt wurden. Hardware: ST/STE/TT/Falcon030. Installation ============ Zuerst mssen die Dateien aus dem LHARC-Archiv extrahiert werden. (Alle Dateien befinden sich im Directory PC_SHELL.300 bzw in den Subdirectories DOKU und PC_HYP) - PC_SHELL.APP In das gewnschte Verzeichnis kopieren. - PC_SHELL.AM ACS-Modul zum Bearbeiten von Unterprojekten. (Muž im gleichen Verzeichnis sein, wie PC_SHELL.APP) 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 Dieses Programm wird von PC_SHELL.APP unter MTOS und MagiC zum Compilieren im Hintergrund ben”tigt. Es muž sich in diesem Fall im gleichen Verzeichnis befinden, wie PC_SHELL.APP. Bei MagiC muž VT52.PRG installiert sein. - PC_SHELL.UPL Diese Datei wird fr die Arbeit mit PC_SHELL.APP nicht ben”tigt. - DOKU\CHANGES.TXT Diese Datei wird fr die Arbeit mit PC_SHELL.APP nicht ben”tigt. - DOKU\PC_SHELL.TXT Diese Datei wird fr die Arbeit mit PC_SHELL.APP nicht ben”tigt. - PC_HYP\PC_SHELL.HYP Online-Hilfe im ST-Guide-Format. Diese Datei kopiert man in eines der Verzeichnisse, die in der Datei ST-GUIDE.INF der Variablen PATHS ("Suchpfadliste fr externe Referenzen") zugeordnet sind. - PC_HYP\PC_SHELL.REF REF-Datei fr PC_SHELL.HYP. Die Datei PC_SHELL.REF kopiert man in das selbe Directory wie die Datei PC_SHELL.HYP. Alternativ kann man den Inhalt mittels RefLink in die ALL.REF eintragen. - PC_HYP\ST_GUIDE.TXT Diese Datei wird fr die Arbeit mit PC_SHELL.APP nicht ben”tigt. PC-Shell verwendet die folgenden Konfigurationsdateien: - PC_SHELL.DEF Default-Einstellungen fr neue Projekte ('Datei/PC neu...'). (Ab PC-Shell V2.22) - PC_SHELL.INF Allgemeine Einstellungen der PC-Shell. (Ab PC-Shell V2.20) - EDITOR.CFG Einstellungen des PC-Editors (Fensterkoordinaten, Font, ...). (Siehe 'Extras/Einst. sichern' im Men des PC-Editors). (Ab PC-Shell V2.22) Alle drei Dateien befinden sich im Directory, in dem auch die PC-Shell abgelegt ist. Die in Klammern angegebene PC-Shell-Version gibt an, bis zu welcher „lteren Version diese Dateien in die Version V3.00 bernommen werden k”nnen. Die PC-Shell legt w„hrend der Laufzeit die folgenden Dateien an: - ERROR.DAT Datei fr die Fehlermeldungen. Befindet sich im Source-Pfad. (Siehe 'Extras/Fehlermeldungen') - PARALLEL.INF INF-Datei fr das Programm PARALLEL.TTP. Tempor„re Datei. Befindet sich im Source-Pfad. - PCC.CFG Batchdatei fr PCC.TTP. Zur šbergabe von Parametern an den Compiler Tempor„re Datei. Befindet sich im Source-Pfad. - PCLINK.CFG Batchdatei fr PLINK.TTP Zur šbergabe von Parametern an den Linker Tempor„re Datei. Befindet sich im Source-Pfad. PC-Shell History ================ Version 3.00 (17.06.1995) o Untersttzung von Subprojekten. Projekte k”nnen weitere (Sub-) Projekte als Abh„ngigkeiten enthalten. (Bearbeitung durch das ACS-Modul PC_SHELL.AM) o Projektbezogene Include-Pfade (4 fr Compiler/ 2 fr Assembler) Abspeicherung erfolgt in der jeweiligen Projektdatei (*.PC bzw *.PRJ) o Durch ein Fenster-Popup (Liste der ge”ffneten Fenster) k”nnen die einzelnen Fenster getoppt werden. o Zus„tzliche Source-Editoren mit konfigurierbaren Extendern. ('Optionen/Source-Liste...') o VA_START - Untersttzung fr externe Editoren. o Fehlerbeseitigung: - Diverse kleine Fehler beseitigt. - Farbicons unter MagiC 3.0 funktionsf„hig. Version 2.24 (18.01.1995) o Button 'includes ermitteln' im Abh„ngigkeiten-Dialog (Dank an Jan Starzynski @ HRO fr die Sourcen) o Compilierung im Hintergrund jetzt auch fr MTOS o ST-Guide Untersttzung. o Anleitung im ST-Guide - Format (Kontext-Hilfe) o Neue Schalter im Dialog 'Extras/Diverse...': - Einstellungen automatisch sichern. - Im Hintergrund compilieren (MTOS/MagiC) o Interner Editor - 'Shift Help' startet eine Projektsuche. - Wortweises Springen mit 'CTRL Left' bzw. 'CTRL Right' - Marke setzen mit CTRL 1-4 - Zu Marke springen mit ALT 1-4 - Block einrcken o Pure-Profiler starten, ber den Menpunkt 'Extras/Profiler...' und den Menpunkt 'Compiler/Prg. profilen' (Nicht unter MTOS) o ACS-Module laden, ber den Menpunkt 'Extras/Modul laden...' (Ab ACS V2.20) Der zuletzt eingestellte Modulpfad wird in der INF-Datei gesichert. o Fehlerbeseitigung: - In der Kommandozeile liežen sich nur Grožbuchstaben eingeben. - Ausblenden unter MagiC funktioniert jetzt. - Ein paar kleine Fehler in den Editor-Blockfunktionen beseitigt. Version 2.23 (12.11.1994) o Fr jede Source-Datei kann ein Hilfstext (z.B. Beschreibung des Inhalts) eingegeben werden. o Bei 'Prg. starten' kann jetzt eine Kommandozeile bergeben werden. (Prg.-Name Dialog) o Fr alle Dateien in der Source-Liste (ausgenommen sind *.C und *.S) kann ein Source-Compiler (nur *.TOS oder *.TTP) angegeben werden. Dadurch k”nnen z.B. Hypertexte fr ST-GUIDE gleich mit compiliert werden. o abschaltbare 3D-Dialoge. o Auswahl der Desktop-Farbe (nur Single-TOS). o Editor: Shift+Ctrl+C = der selektierte Block wird an eine, im GEM-Clipboard vorhandene, SCRAP.TXT Datei angeh„ngt. o Fehlerbeseitigung: - Diverse kleine Fehler beseitigt. - Fehler bei der PRJ-Auswertung beseitigt. Version 2.22 (11.08.1994) o Beenden des Compiliervorgangs usw. durch LinksSHIFT + RechtsSHIFT. o Neue Menpunkte: 'INF laden...' und 'INF sichern...' o Fehlerbeseitigung: - Unter MagiC gab es Probleme, wenn der Schalter 'Projekt aktualisieren' verwendet wurde. - Die Probleme mit den Editor-Fensterkoordinaten mžten beseitigt sein. Sollten noch Fehler auftreten -> EDITOR.CFG l”schen. - Diverse kleine Fehler beseitigt. Version 2.21 o Sichern der Editor-Fensterkoordinaten in EDITOR.CFG o Fehlerbeseitigung: - Unter MagiC gab es Probleme beim Linken. Version 2.20 o Die PureC-TTP's werden unter MagiC parallel gestartet. o Der 'warning level' ist jetzt im Compileroptionen- Dialog ausw„hlbar. o 'PRJ ”ffnen' ist funktionsf„hig. o Default-Einstellungen sichern (fr 'PC neu...'), von: - Compiler-, Assembler und Linker-Optionen - Librarydateien - Pfad fr den Prg-Namen o Neuer Men-Eintrag: 'Linken' o Zus„tzliche Include-Pfade fr Compiler und Assembler. o Durch bet„tigen der HELP-Taste im Fehlermeldungen-Fenster, wird die PureC-Hilfe fr Fehlermeldungen aufgerufen. o Fehlerbeseitigung: - Unter MagiC mit Farbaufl”sung, wurden die Icons im Projektfenster nicht gezeichnet. - Diverse kleine Fehler beseitigt. Version 2.19 o Projekt-Fenster auf Drag&Drop umgestellt. o Unregistrierte Version leicht eingeschr„nkt. (Dialogbox erscheint vor dem Compilieren). o Kommandozeile wird jetzt ausgewertet, eine *.PC- Datei wird geladen. o Internen Editor berarbeitet: - Untersttzung des GEM-Clipboards. - Blockselektion mit der Tastatur (^B/^K) o Projekt-Suche eingebaut. o Das PC_HELP.ACC kann jetzt auch als Programm verwendet werden. (siehe Pfade... und Diverse... Dialog) o Fehlerbeseitigung: - Beim Suchen im internen Editor, wurde ein 'Bing' mit Bconout(2, 7) an die Konsole gesandt. Unter TOS 1.06 (1040STE) + NVDI strzt dann der Rechner ab. Der Fehler liegt im TOS 1.06, deshalb wurde das 'Bing' herausgenommen. Version 2.18 o Abh„ngigkeiten-Dialog ge„ndert: - Listbox (max. 100 Eintr„ge) - Drag&Drop (Neu/Klemmbrett/Mlleimer Icons) - Die Abh„ngigkeitsdateien mssen jetzt nicht mehr im gleichen Verzeichnis liegen wie die Sourcedatei. o Das Textfeld 'Compiler Zusatz-Optionen' vergr”žert. o Zus„tzliche Optionen im Assembler-Optionen Dialog. o Die compilierten Objektdateien k”nnen jetzt auch umbenannt oder in einem anderen Verzeichnis abgelegt werden. (Compiler- und Assembleroption: -N und -O) o Im Programm-Namen Dialog kann auch ein anderes Verzeichnis angegeben werden. o Das Format der Projektdateien *.PC hat sich ge„ndert. Projektdateien ab Version 2.17d k”nnen geladen werden. o Zwei zus„tzliche Schalter im Diverse-Dialog: 1. Bei Prg. starten/debuggen Projekt aktualisieren (Make) 2. Quelltexte automatisch sichern. bei: - Aufruf von Programmen (Debugger, RCS, ext. Editor usw.). - PC-Shell beenden. - Compileraufrufen (Make/Make All/Assemblieren/usw). o Fehlerbeseitigung: - Unter einem Multitasking-System konnte bei ge”ffneter Dialogbox die Menzeile mit der Tastatur bedient werden. - Bei der 2.17d konnten ge”ffnete Editor-Fenster nicht in der PC_SHELL.INF abgespeichert werden. Version 2.17d o Alle Dialoge sind jetzt applikationsmodale Fensterdialoge. o Im Pfade-Dialog k”nnen Parameter fr die externen Editoren angegeben werden. Version 2.17c o Die Source-Dateien mssen sich jetzt nicht mehr, mit der Projektdatei im gleichen Verzeichnis befinden. Version 2.17b o Zus„tzlicher Menpunkt 'Prg. debuggen'. Version 2.17 o Die Checkboxen und Radiobuttons, sind jetzt auch ber den dazugeh”rigen Text selektierbar. o Die modalen Dialoge fliegen jetzt auch mit Let'em Fly. o Mit dem Menpunkt 'Fehlermeldungen' (Extras) wird das Fehlermeldungen-Fenster vom Desktop ge”ffnet. o Bei 'INF sichern' wird nun die ge”ffnete Projektdatei, und alle ge”ffneten Fenster in die PC_SHELL.INF bernommen. o Die INCLUDE-, LIB-Directory und Startup (Optionen) Textfelder vergr”žert und sie k”nnen jetzt ber den Fileselektor ausgew„hlt werden. o Die PC_SHELL.INF ist nicht mehr kompatibel, zur vorherigen Version. o Fehlerbeseitigung: - Auf dem Falcon030 funktionierten die Tastaturkrzel fr die Menzeile nicht einwandfrei. - PC-Shell strzte ab, wenn bei 'PC ”ffnen...' eine nicht vorhandene Datei angegeben wurde. - Programmaufrufe funktionieren jetzt auch unter MagiC! Version 2.16b o Fehlerbeseitigung: - PC-Shell strzte beim beenden ab, wenn Let'em Fly mit eingeschalteter Niceline-Option verwendet wurde. Version 2.16 o Erste ”ffentliche Version