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!