Kurzbeschreibung TVPascalForm Version 1.00 - M r. 1993 alle Rechte bei: Jeanette Winzenburg Arndtstr. 12, W-1000 Berlin 61 Testen Sie das Programm nach Herzenslust, aber denken Sie daran, da es sich um eine Shareware-Version handelt: wenn Sie es regelm ig benutzen, sp testens aber nach Ablauf der Testzeit von 3 Monaten, m ssen Sie eine registrierte Version (zum fairen Preis von 30,00 DM bei Vorkasse; bei Nachnahme + 6,- DM) erwerben. Die Datei REGFORM.TXT enth lt ein Registrierungsformular, bereit zum Ausdrucken und Abschicken. - Eine Registrierung bringt einige Vorteile: - Sie erhalten 50% Rabatt auf das n chste Update. - Sie erhalten den vollst ndigen Quelltext. - Sie k nnen in den Genu von immer besseren Programmiertools kommen, weil Sie die weitere Programmentwicklung f rdern. - Inhalt Programmidee Optik Funktions bersicht Funktionen Einzelnen Fehlerbehandlung Grenzen - was TVPascalForm nicht kann/k nnen will Ein Kessel Buntes - Hinweise weiter Programmidee TVPascalForm ist eine Turbo Vision Applikation, mit der komfortabel alle Bezeichner in Pascal-Quelltexten in eine einheitliche Schreibweise gebracht werden. Die Leitidee bei der Programmentwicklung war, die Konvertierung so automatisch wie m glich - und das f r ALLE Bezeichner - ablaufen zu lassen. Die ProgrammiererIn soll m glichst vollst ndig von der l stigen Aufgabe des Wortlisten-Tippens verschont bleiben. Als Folge davon fordert TVPascalForm f r jeden gefundenen unbekannten Bezeichner eine verbindliche Schreibweise an - und merkt sich die Antwort f nftige Anwendungen in einer selbstadaptierenden Liste. weiter zur Optik Nach dem Start zeigt sich TVPascalForm im gewohnten TurboVision-Look mit Men zeile, Desktop und Statuszeile - das Hinweisfenster erinnert Sie daran, da Sie eine Shareware-Version testen. Der Datei-Dialog zur Auswahl eines Quelltextes ist aktiviert. In der Statuszeile werden die wichtigsten Befehle angezeigt, zus tzlich ist rechts unten der freie Heap eingeblendet, bei < 80k in roter Schrift. weiter zur Funktions bersicht Mit den unter TurboVision blichen Mittel - Men auswahl, Hotkey, Mausclick - wird ein Quelltext ausgew hlt und gleichzeitig die Konvertierung aller darin enthaltenen Bezeichner in eine einheitliche Schreibweise gestartet. Diese Bearbeitungsfunktion ist nach dem Programmstart und nach jeder erfolgreich abgeschlossenen Textkonvertierung aktiviert. Findet die Applikation einen ihr bisher unbekannten Bezeichner, fordert sie in einem Dialogfenster die Festlegung seiner Schreibweise an. Die g ltige Schreibweise wird in eine interne Liste eingef gt; die Liste wird bei Programmende gespeichert. Nach Ende der Sch nheitsoperation wird die geliftete Datei gespeichert, der Ausgangstext steht als Backup auch weiter zur Verf gung. Daneben k nnen die Referenzlisten editiert, ausgewechselt und auch - obwohl das der Programmidee zuwiderl uft! - aus ASCII-Listen importiert / zu ASCII- Listen exportiert werden. weiter zur Die Funktionen im Einzelnen Als TurboVision Applikation h lt sich die Programmbedienung an die von Pascal 6.0 gewohnten IDE- Konventionen, die hier nicht wiederholt werden. * Die Men zeile hat folgende Auswahlmen Bearbeiten Textkonvertierung, Dateioperationen Wortlisten Funktionen an den Referenzlisten weiter zur Der Men punkt Bearbeiten Er enth lt die Funktionen zur Auswahl und Bearbeitung des Quelltextes, zum Verzeichniswechsel, zur Programmunterbrechung und zum Programmende. Bearbeiten ffnet einen Datei-Dialog mit dem ein Pascal-Quelltext zur Bearbeitung ausgew hlt werden kann. Bei fehlerfreiem ffnen wird die Textkonvertierung gestartet - ein Hinweis "Bitte warten ..." erinnert Sie daran. Jedes Wort des Quelltextes wird mit den Referenzlisten abgeglichen; ist es nicht enthalten, erscheint auf dem Desktop ein Dialogfenster, in dem die Schreibweise festgelegt werden kann. Gleichzeitig wird die gesamte gerade bearbeitete Zeile zur besseren Orientierung eingeblendet. Bei Abbruch des Dialogs wird nach Best tigung die gesamte Bearbeitung abgebrochen, die Ausgangsdatei ist unver ndert. Nach erfolgreicher Bearbeitung wird die gesch nte Datei gespeichert, die Ausgangsdatei steht als Backup mit der Dateikennung ".JBK" zur Verf gung. Dieser Men punkt ist automatisch nach dem Programmstart und nach jeder Bearbeitung aktiviert. weiter zur Verzeichnis wechseln ffnet einen ChangeDirDialog. DOS-Shell wechselt zur DOS-Ebene, wenn der Arbeitsspeicher ausreicht; R ckkehr wie blich mit "Exit". Exit Programmende; wurde die interne Wortliste ge ndert, wird Speicherung vorgeschlagen. weiter zur Der Men punkt Wortlisten Er enth lt die Funktionen zum Editieren und Auswechseln der Referenzlisten. Daneben gibt es eine Funktion zum Import/Export von reinen ASCII-Listen. _ Intern verwaltet TVPascalForm drei Wortlisten, die in dieser Reihenfolge abgearbeitet werden: J - Reservierte Liste: Sie enth lt die reservierten Bezeichner von TP 6.0. C - Standard-Liste: Sie enth lt die Standard-Bezeichner von TP 6.0. h - Individual-Liste: Sie enth lt die selbstadaptierende Liste, in die neue Bezeichner eingef gt werden. Beim Programmstart liest TVPascalForm die drei Listen aus dem Dateien ResWort.JLT, Standard.JLT und MeinWort.JLT aus dem Verzeichnis, in dem das Programm gespeichert ist: die Listen sind als NachfolgeObjekte von TStringCollection gespeichert. / Reservierte, Standard, Individual editieren ffnet ein Dialogfenster, in dem Listeneintr ge ge ndert bzw. neue Bezeichner eingef gt werden k nnen. Es enth lt eine Listbox mit der Wortliste, eine Eingabezeile und die Aktionsschalter Ersetze (Default), Neu, Speichern und Abbruch. Listbox: durch Selektion eines Bezeichners wird dieser in die Eingabezeile bertragen und steht dort zur nderung bereit. Ersetze: der Text in der Eingabezeile ersetzt den fokussierten Listeneintrag; insbesondere wird der Eintrag gel scht, wenn die Eingabezeile leer ist. (s. auch: Hinweise) Neu: der Text der Eingabezeile wird in die Liste eingef Speichern: der Dialog wird beendet, die ge nderte Liste wird mit einem Backup der Dateikennung ".JBK" gespeichert. Abbruch: der Dialog wird beendet, die Wortliste ist unver ndert. Listeninfo die Dateinamen der aktuellen Referenzlisten werden in einem Fenster angezeigt. 1 Reservierte, Standard, Individual auswechseln ffnet einen Datei-Dialog, mit dem eine Datei zum Lesen einer neuen Liste ausgew hlt werden kann. Bei Erfolg ersetzt die neue Liste die bisher g ltige. Die aktuelle Individual-Liste wird mit Backup gespeichert. weiter zur als ASCII ffnet einen Datei-Dialog, mit dem eine Datei zum Lesen einer Referenzliste ausgew hlt werden kann. Bei Erfolg wird eine daraus erstellte ASCII-Liste (mit einem Wort pro Zeile) in einer Datei mit Kennung ".JXT" gespeichert. Existiert bereits eine Datei dieses Namens, so wird sie berschrieben. als Resource ffnet einen Datei-Dialog, mit dem eine Datei zum Lesen einer ASCII-Liste (in der jeweils ein Bezeichner pro Zeile erwartet wird) ausgew hlt werden kann. Bei Erfolg wird eine daraus erstellte Referenzliste in einer Datei mit der Dateikennung ".JLT" gespeichert. Existiert bereits eine Datei dieses Namens, so wird sie berschrieben. weiter zur Fehlerbehandlung Tritt bei der Ausf hrung einer Funktion ein Fehler auf, stellt TVPascalForm so weit wie m glich den Zustand vor dem Aufruf der Funktion wieder her und zeigt eine Fehlermeldung. weiter zur Grenzen - TVPascalForm ist f r fehlerfrei kompilierbare Pascal-Quelltexte konzipiert. Bei beliebigen Texten kann eine Bearbeitung auch funktionieren - Stringkonstanten oder Wortanf nge, die keine g ltigen Pascal-Wortanf nge (z. B. Ziffern, Umlaute ...) sind, k nnen dann aber zu Problemen f hren. A - Eine Sonderbehandlung f r Kommentare ist nicht vorgesehen. weiter zur Hinweise - ein Kessel Buntes - Stringkonstanten werden unver ndert bernommen. a - Einzelbuchstaben und Hexadezimalzahlen werden grunds tzlich in Gro buchstaben konvertiert. - Im Dialogfenster zum Bearbeiten von Wortlisten wird der fokussierte Eintrag der Listbox nur ersetzt, wenn die Eingabezeile selektiert ist: die Idee dabei ist, das Wort nicht unbeabsichtigt zu ver ndern. Als unsch ne Folge kann der Schalter "Ersetze" nicht mit der Maus, sondern nur ber die Tastatur bedient werden. Sorry: das ist ein klarer Versto gegen TV-Prinzipien, hat sich in der Praxis aber als sinnvoll herausgestellt. F r Vorschl ge zu einer prinzipientreuen L sung bin ich jederzeit offen... - In der - auch in TVPascalForm eingesetzten - TV Unit Stddlg ist im TFiledialog ein Bug, der das Programm sang- und klanglos abst rzen l t, wenn auf einem Diskettenlaufwerk beim ffnen des Filedialogs keine Datei mit dem bergebenen Dateinamen zu finden ist. Als "quick and dirty"-L sung legt TVPascalForm deshalb eine Datei "DUMMY" + aktuelle Dateikennung an, wenn er im aktuellen Verzeichnis keine passende Datei findet. Sorry! p - TV bernimmt die Fehlerbehandlung bei Disk-Errors: in der Statuszeile erscheint dann eine - englische - Fehlermeldung. Wie schon in der TV-Dokumentation erw hnt, mu man dann in der Regel mehrfach Esc bzw Enter dr cken. Eventuell ist auch die dann folgende Messagebox unpassend. Nun aber nicht die Nerven verlieren, sondern Fehler beheben und nochmal probieren!