================================================================================ Dokumentation zu TXT2EXE V3.01: TEXT nach EXE - šbersetzer ================================================================================ Inhalt: ÄÄÄÄÄÄ 1. Zweck 2. Programm-Aufruf 3. Leistungen 4. Anwendungen // Benchmarks 5. Probleme 6. Versionen 7. Public-Domain Info 8. Erweiterungen // Urheber-Vermerk ================================================================================ 1. Zweck ÄÄÄÄÄÄÄÄ TXT2EXE ist ein Programm, welches Text-Dateien in lauff„hige Programme "bersetzen" kann: Text-Datei ----> TXT2EXE ---> lauff„higes Programm Vorteile: * keine Befehle wie "type xyz.xyz | more ..." mehr * einfaches Suchen * einfache Anwendung * gute Performance * professionelle Weitergabe von README-Dateien oder Texten aller Art * Interne Virus-Erkennung durch CRC * farbliches Hervorheben von Textpassagen * Text und "Compiler" k”nnen wieder extrahiert werden * schnelles Suchen ber Stichwortliste Nachteile: * Vergr”áerung der ursprnglichen Datei 1.1 Vorgehensweise (Interna) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Das Programm TXT2EXE erstellt von sich selbst eine Kopie und h„ngt den Text am Programmende an. Zus„tzlich wird noch eine Verwaltungsliste (fr interne Zwecke) an das Ende dieses Programms "angeh„ngt". Wenn die Option Begriffliste gew„hlt wurde, so werden alle Worte des Textes auf "Fllworte" (wie "und", "oder",... ) gefiltert und sortiert an das Ende dieses Programms "angeh„ngt". Das so entstandene Programm zeigt den ursprnglichen Text auf dem Bildschirm an und erlaubt es ihn mittels den Cursor-Tasten durchzu- bl„ttern, nach Begriffen zu suchen, den Text wieder zu extrahieren oder auszudrucken. 1.2 Dateien auf der Diskette ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Das Programm TXT2EXE liegt in 2 Versionen auf der Diskette vor: * eine Version, die den Text in eine lauff„hige EXE-Datei umwandelt. (TXT2EXEo.EXE) * eine Version, die zus„tzlich noch eine Stichwortliste aus dem Text generiert. šber diese Stichwortliste k”nnen Begriffe sehr schnell im Text gefunden werden. (TXT2EXEs.EXE) Mit diesem Unterschied sind die Programme identisch in Funktion und Aufruf. Inhaltsverzeichnis der Diskette: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ šbersetzungsprogramm ÚÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ mit Stichwortliste ³ ³ ³ ³ TXT2EXES EXE 19707 27.04.92 16:16 ³ ³ TXT2EXEO EXE 12676 27.04.92 16:16 ÄÄÅÄÄÄÄ šbersetzungsprogramm ³ LESEN EXE 43393 27.04.92 16:16 ³ ohne Stichwortliste ³ ³ ³ ÀÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ diese Datei ================================================================================ 2. Programm-Aufruf ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ TXT2EXEs [šberschrift] (Stichwortliste) TXT2EXEo [šberschrift] (ohne Stichwortliste) Die Parameter "textdatei" und "exedatei" mssen angegeben werden. Existiert die "exedatei" bereits, so wird diese nach einer Rckfrage berschrieben oder aber das Programm abgebrochen. šberschrift ist ein optionaler Parameter, welceher auch weggelassen werden kann. Beispiel: C:\>TXT2EXE lesen.txt lesen.exe Produktwerbung fr XYZ Dieser Aufruf wrde ein Programm (LESEN.EXE) erzeugen, das den Text der ur- sprnglichen Datei (LESEN.TXT) beinhaltet. Wird das so entstandene Programm (LESEN.EXE) gestartet, so erscheint "Produktwerbung fr XYZ" als šberschrift. (Wird das Programm gr”áer als der zur Verfgung stehende Speicher, so ist dies unbedeutend, da TXT2EXE eine Speicherverwaltung eingebaut hat, die es erm”glicht mit 96-128 KB Hauptspeicher beliebig groáe Dateien zu verwalten) Wenn das Programm ohne Parameter aufgerufen wird, so erscheint folgender Gebrauchshinweis: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ TXT2EXE V3.01 ³ ³ Zweck : Texte in lauff„hige EXE-Dateien umwandeln. ³ ³ Aufruf : TXT2EXE [šberschrift] ³ ³ (c) 1991/92 P.Fischer-Haaser ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ================================================================================ 3. Leistungen: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ * lauff„hig auf allen IBM-kompatibeln Rechnen mit Standard-Grafik-Karte (VGA/EGA/Hercules/CGA), 196 KB freiem Hauptspeicher und einem Disketten-Laufwerk. Ideal ist ein 286er oder h”her mit Festplatte. * max. 2 Mrd. Zeilen // Stichworte pro Text werden verwaltet (!!) (Text-Dateigr”áen im GByte-Bereich) * 192 KBytes Hauptspeicher werden ben”tigt zum Ansehen // šbersetzen "beliebig" groáer Dateien * Gleichbleibende Performance beim Browsen beliebig groáer Texte * Umschaltung Farbe // Schwarz-Weiss (F2) * integrierte Suchfunktion (F3) // Weitersuchen (F4) * sortierte Stichwortliste aus dem Text kann generiert werden (F5) Die Stichwortliste wird ber ein Wortfilter erstellt, das ca. 1000 deutsche Fllworte wie "und", "oder",... erkennt und diese aus- filtert. * Das šbersetzungs-Programm kann aus jeder neu entstandenen Programm- Datei wieder entpackte werden (ALT-F10) * Der Text in dem entstandenen Programm kann in einer anderen Datei abgelegt oder ausgedruckt werden. (SHIFT-F10) * Ab Version 2.2x wird kein dauerhaftes File-Locking mehr durchgefhrt (Netzwerk-F„higkeit gew„hrleistet) * Teile des Textes k”nnen farblich hervorgehoben werden : Einleitendes Zeichen : ø07øøøe1 Zeichenfarbe : in Hex (0..F) Hintergrundfarbe : in Hex (0..7) Bsp.: øø07 --> ø07 Schwarz auf Hellgrau øe1 øøF3 --> øF3 Weiss auf Trkis øe1 øøE4 --> øE4 Gelb auf Rot øe1 Farb-Tabelle : ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Hintergrund und ³ nur fr Zeichen ³ ³ Zeichen ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ Schwarz - 0 ³ Dunkelgrau - 8 ³ ³ Blau - 1 ³ Hellblau - 9 ³ ³ Grn - 2 ³ Hellgrn - A ³ ³ Trkis - 3 ³ Helles Trkis - B ³ ³ Rot - 4 ³ Helles Rot - C ³ ³ Magenta - 5 ³ Helles Magenta- D ³ ³ Braun - 6 ³ Gelb - E ³ ³ Hellgrau - 7 ³ Weiss - F ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ø07 Farben von 0 bis 7 sind als Hintergrundfarben erlaubt øF0 Farben von 0 bis F sind als Zeichenfarben erlaubt ================================================================================ 4. Probleme: ÄÄÄÄÄÄÄÄÄÄÄ * Probleme treten auf, wenn das mit TXT2EXE erstellte Programm mit EXE-Komprimieren wie PKLITE, EXEPACK oder LZEXE verkleinert wird, da bei diesen Programmen interne Verweis-Tabellen in ihrer Position ver„ndert werden k”nnen. (Meldung : CRC-Fehler) * Auf Netzwerken sollte der Benutzer von TXT2EXE ein Schreibrecht auf die verwendeten Verzeichnisse besitzen. * Um einen Text zu "bersetzen" ben”tigt TXT2EXE tempor„r ca. 2,5-3 mal soviel Plattenplatz wie die Gr”áe der ursprnglichen Datei war, dabei kann der verfgbare Plattenplatz nicht ausreichen (...) * TXT2EXE ”ffnet 3 bzw. 4 Dateien. Wird TXT2EXE in einer Shell getartet, so kann die Meldung "Zu viele Dateien ge”ffnet" erscheinen. Abhilfe: files = 30 in CONFIG.SYS. ================================================================================ 5. Anwendungen // Benchmarks ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Fr untenstehnede Aufrufe wurde folgende Test-Konfiguration verwendet: Betriebssystem : MS-DOS 4.01 Rechner : 486 / 25 MHz / 8 MB -- kein (!!) HD-Cache-Programm ( files=30, buffers=20) Festplatte : Quantum LPS240 Grafik : Video 7 VRAM IIe - VGA Texte : DOS.DAT 40.436 (Artikel aus DOS 1987-92) CTMC.DAT 407.637 (Artikel aus c't und MC 1983-92) Programme : BENCH.EXE Programm um die Laufzeit von Programmen zu messen. Ein PD-Produkt von Turbo-Power Software Arbeitsverzeichnis der Festplatte : ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ C:\TP\EXE\TST>dir ³ ³ TXT2EXES EXE 19707 27.04.92 13:23 ³ ³ TXT2EXEO EXE 12676 27.04.92 13:24 ³ ³ CTMC DAT 407822 21.03.92 12:55 ³ ³ DOS DAT 40441 21.03.92 13:19 ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 5.1 Ohne Stichwortliste ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 5.1.1 DOS.DAT ÄÄÄÄÄÄÄÄÄÄÄÄÄ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ C:\TP\EXE\TST>bench txt2exeo dos.dat dos.exe ³ ³ BENCH. Utility for benchmarking programs. ³ ³ TXT2EXEO V3.01 (o) ³ ³ 748 Zeilen bearbeitetDOS.EXE generiert. // 55 KBytes ³ ³ (c) 1991/92 P.Fischer-Haaser ³ ³ Elapsed time: 6.24 seconds ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 5.1.2 CTMC.DAT ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ C:\TP\EXE\TST>bench txt2exeo ctmc.dat ctmc.exe ³ ³ BENCH. Utility for benchmarking programs. ³ ³ TXT2EXEO V3.01 (o) ³ ³ 7286 Zeilen bearbeitetCTMC.EXE generiert. // 442 KBytes ³ ³ (c) 1991/92 P.Fischer-Haaser ³ ³ Elapsed time: 35.52 seconds ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Wird keine Stichwortliste erzeugt (TXT2EXEo) so dauert ben”tigt das šberstzen nur eine kurz Zeitspanne, die linear mit der L„nge der Textdatei ansteigt. ( ungef„hr 12 KBytes / s) 5.2 Mit Stichwortliste ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 5.2.1 DOS.DAT ÄÄÄÄÄÄÄÄÄÄÄÄÄ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ C:\TP\EXE\TST>bench txt2exes dos.dat dos.exe ³ ³ BENCH. Utility for benchmarking programs. ³ ³ TXT2EXE V3.01 (s) ³ ³ 748 Zeilen bearbeitet ³ ³ Stichwortliste bearbeiten... ³ ³ 1002 Stichworte gefunden // DOS.EXE generiert. // 82 KBytes ³ ³ (c) 1991/92 P.Fischer-Haaser ³ ³ Elapsed time: 15.89 seconds ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 5.2.2 CTMC.DAT ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ C:\TP\EXE\TST>bench txt2exes ctmc.dat ctmc.exe ³ ³ BENCH. Utility for benchmarking programs. ³ ³ TXT2EXE V3.01 (s) ³ ³ 7286 Zeilen bearbeitet ³ ³ Stichwortliste bearbeiten... ³ ³ 6261 Stichworte gefunden // CTMC.EXE generiert. // 574 KBytes ³ ³ (c) 1991/92 P.Fischer-Haaser ³ ³ Elapsed time: 511.74 seconds ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Wird eine Stichwortliste erzeugt, so liegt die Dauer der šbersetzung weit ber der Zeit, die fr eine šbersetzung ohne Stichwortliste ben”tigt wird. Dies ist so zu erkl„ren: Bei jedem gefundenen Wort wird zun„chst geprft, ob es ein sinnvolles Wort ist (Wortfilter). Ist dies der Fall, so muá das Wort in die Liste einsortiert werden... ================================================================================ 6. Versionen ÄÄÄÄÄÄÄÄÄÄÄÄ 0.9x lauff„higer Prototyp (Dateil„ngen <= 64 KB) in Turbo Pascal 5.5 (TXT2EXE > 40 KBytes) 1.0x funktionsf„higes Programm (TXT2EXE = 25 KBytes) 1.1x Suchfunktion eingebaut 1.2x Extraktion von TEXT und Compiler 1.5 File I/O und Video I/O in Assembler 2.01 Erweiterung auf 2 Mrd. Zeilen Turbo Pascal 6.0 (TXT2EXE 16 KBytes) 2.1x internes Caching, Bug bei der Extraktion von Dateien entdeckt (TXT2EXE < 13 KBytes) 2.2 Verbesserung bei der Speicherverwaltung File-Locking auf Netzwerken "wegprogrammiert" (TXT2EXE 12 KBytes) 3.00á Erkennung von Bin„r-Dateien vor der Umwandlung Text-Kompression (ca 20%) Generierung einer sortierten Stichwortliste ber Wortfilter keine Compiler-Extraktion mehr m”glich aktuelle Version: 3.01 (27.April 1992) Kompression wieder entfernt (Laufzeit !!!) Compiler-Extraktion wieder m”glich 2 Programme: TXT2EXEo.EXE und TXT2EXEs.EXE ================================================================================ 7. PD-Info ÄÄÄÄÄÄÄÄÄÄ Dieses Programm ist ein Public-Domain Produkt. Jeder darf mit TXT2EXE beliebig viele Text in Programme bersetzen und weitergeben (Damit ist auch die Weitergabe des šbersetzers inbegriffen). Falls Sie TXT2EXE ntzlich finden und ”fters damit arbeiten, wrde ich mich ber einen freiwilligen Anerkennungsbeitrag (ganz nach Ihrem Ermessen, DM 10,-- w„ren sicherlich fair) freuen. Bei einem guten Essen im Gasthaus geben Sie ja auch gerne mal ein "Trinkgeld". Firmen, die TXT2EXE gewerblich einsetzen m”chten und spezielle Anpassungen oder Žnderungen (z.B. Firmenname im Programm) wnschen, bitte ich, mit mir Kontakt aufzunehmen. Programmanpassungen (gegen Berechnung) sind m”glich. (Siehe unten: Erweiterungen) Fr eventuelle Sch„den, die durch die Nutzung von TXT2EXE entstehen, ist alleinig der Benutzer von TXT2EXE verantwortlich. Mit dem Einsatz des Programmes wird dieser Haftungsausschluá anerkannt. Fr Verbesserungs-Vorschl„ge, Erweiterungen und Kritik am Programm bin ich jederzeit offen: Peter Fischer-Haaser Mozartstr. 10 D-7100 Heilbronn Tel.: 07131/81947 ================================================================================ 8. Erweiterungen // Urheber-Vermerk ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Der Urheber-Vermerk der nach Gebrauch eines mit TXT2EXE generierten Programms erscheint, kann gegen eine Gebhr entfernt oder ersetzt werden. Ebenso k”nnen gegen eine geringe Gebhr auch Funktionen in TXT2EXE eingefgt bzw. entfernt werden; der Pascal // Assembler - Quelltext ist ebenfalls erh„ltlich. Anfagen bitte an obige Adresse. ================================================================================ TXT2EXE wurde mit Turbo-Pascal 6.0 und Turbo-Assembler 2.01 erstellt