home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / TOOLS / TXT2EXE / INFO.TXT next >
Text File  |  1993-12-01  |  16KB  |  434 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16. ================================================================================
  17.  
  18.        Dokumentation zu TXT2EXE V3.01:
  19.  
  20.                  TEXT nach EXE - Übersetzer
  21.  
  22.  
  23. ================================================================================
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. Inhalt:
  31. ──────
  32.  
  33.    1. Zweck
  34.    2. Programm-Aufruf
  35.    3. Leistungen
  36.    4. Anwendungen // Benchmarks
  37.    5. Probleme
  38.    6. Versionen
  39.    7. Public-Domain Info
  40.    8. Erweiterungen // Urheber-Vermerk
  41.  
  42.  
  43. ================================================================================
  44.  
  45.  
  46.  
  47. 1. Zweck
  48. ────────
  49.  
  50.    TXT2EXE ist ein Programm, welches Text-Dateien in lauffähige Programme
  51.    "übersetzen" kann:
  52.  
  53.    Text-Datei ----> TXT2EXE ---> lauffähiges Programm
  54.  
  55.    Vorteile:
  56.       * keine Befehle wie "type xyz.xyz | more ..." mehr
  57.       * einfaches Suchen
  58.       * einfache Anwendung
  59.       * gute Performance
  60.       * professionelle Weitergabe von README-Dateien oder Texten aller Art
  61.       * Interne Virus-Erkennung durch CRC
  62.       * farbliches Hervorheben von Textpassagen
  63.       * Text und "Compiler" können wieder extrahiert werden
  64.       * schnelles Suchen über Stichwortliste
  65.  
  66.    Nachteile:
  67.       * Vergrößerung der ursprünglichen Datei
  68.  
  69.    1.1 Vorgehensweise (Interna)
  70.    ────────────────────────────
  71.  
  72.      Das Programm TXT2EXE erstellt von sich selbst eine Kopie und hängt den
  73.      Text am Programmende an. Zusätzlich wird noch eine Verwaltungsliste 
  74.      (für interne Zwecke) an das Ende dieses Programms "angehängt". 
  75.    
  76.      Wenn die Option Begriffliste gewählt wurde, so werden alle Worte des 
  77.      Textes auf "Füllworte" (wie "und", "oder",... ) gefiltert und sortiert an 
  78.      das Ende dieses Programms "angehängt".
  79.  
  80.      Das so entstandene Programm zeigt den ursprünglichen Text auf dem 
  81.      Bildschirm an und erlaubt es ihn mittels den Cursor-Tasten durchzu-
  82.      blättern, nach Begriffen zu suchen, den Text wieder zu extrahieren 
  83.      oder auszudrucken.
  84.  
  85.    1.2 Dateien auf der Diskette
  86.    ────────────────────────────
  87.  
  88.      Das Programm TXT2EXE liegt in 2 Versionen auf der Diskette vor:
  89.  
  90.      * eine Version, die den Text in eine lauffähige EXE-Datei umwandelt.
  91.        (TXT2EXEo.EXE)
  92.  
  93.      * eine Version, die zusätzlich noch eine Stichwortliste aus dem Text
  94.        generiert. Über diese Stichwortliste können Begriffe sehr schnell
  95.        im Text gefunden werden.
  96.        (TXT2EXEs.EXE)
  97.  
  98.     Mit diesem Unterschied sind die Programme identisch in Funktion und
  99.     Aufruf.
  100.  
  101.  
  102.      Inhaltsverzeichnis der Diskette:
  103.  
  104.          ┌───────────────────────────────────────────── Übersetzungsprogramm
  105.       ┌──┼────────────────────────────────────────┐     mit Stichwortliste
  106.       │  │                                        │
  107.       │ TXT2EXES EXE     19707 27.04.92   16:16   │
  108.       │ TXT2EXEO EXE     12676 27.04.92   16:16 ──┼──── Übersetzungsprogramm
  109.       │ LESEN    EXE     43393 27.04.92   16:16   │     ohne Stichwortliste
  110.       │  │                                        │
  111.       └──┼────────────────────────────────────────┘
  112.          └───────────────────────────────────────────── diese Datei
  113.  
  114.  
  115. ================================================================================
  116.  
  117.  
  118. 2. Programm-Aufruf
  119. ─────────────────
  120.  
  121.    TXT2EXEs <Textdatei> <Exedatei> [Überschrift]      (Stichwortliste)
  122.    TXT2EXEo <Textdatei> <Exedatei> [Überschrift]      (ohne Stichwortliste)
  123.  
  124.    Die Parameter "textdatei" und "exedatei" müssen angegeben werden. Existiert
  125.    die "exedatei" bereits, so wird diese nach einer Rückfrage überschrieben
  126.    oder aber das Programm abgebrochen.
  127.  
  128.    Überschrift ist ein optionaler Parameter, welceher auch weggelassen werden
  129.    kann.
  130.  
  131.    Beispiel:
  132.  
  133.      C:\>TXT2EXE lesen.txt lesen.exe Produktwerbung für XYZ
  134.  
  135.    Dieser Aufruf würde ein Programm (LESEN.EXE) erzeugen, das den Text der ur-
  136.    sprünglichen Datei (LESEN.TXT) beinhaltet. Wird das so entstandene Programm
  137.    (LESEN.EXE) gestartet, so erscheint "Produktwerbung für XYZ" als Überschrift.
  138.  
  139.  
  140.   (Wird das Programm größer als der zur Verfügung stehende Speicher, so ist
  141.    dies unbedeutend, da TXT2EXE eine Speicherverwaltung eingebaut hat, die es
  142.    ermöglicht mit 96-128 KB Hauptspeicher beliebig große Dateien zu verwalten)
  143.  
  144.    Wenn das Programm ohne Parameter aufgerufen wird, so erscheint folgender
  145.    Gebrauchshinweis:
  146.  
  147.    ┌───────────────────────────────────────────────────────────────────┐
  148.    │ TXT2EXE V3.01                                                     │
  149.    │ Zweck  : Texte in lauffähige EXE-Dateien umwandeln.               │
  150.    │ Aufruf : TXT2EXE <Textdatei> <Programmdatei.EXE> [Überschrift]    │
  151.    │ (c) 1991/92 P.Fischer-Haaser                                      │
  152.    └───────────────────────────────────────────────────────────────────┘
  153.  
  154.  
  155. ================================================================================
  156.  
  157.  
  158. 3. Leistungen:
  159. ──────────────
  160.  
  161.    * lauffähig auf allen IBM-kompatibeln Rechnen mit Standard-Grafik-Karte
  162.      (VGA/EGA/Hercules/CGA), 196 KB freiem Hauptspeicher und einem
  163.      Disketten-Laufwerk. Ideal ist ein 286er oder höher mit Festplatte.
  164.  
  165.    * max. 2 Mrd. Zeilen // Stichworte pro Text werden verwaltet (!!)
  166.      (Text-Dateigrößen im GByte-Bereich)
  167.  
  168.    * 192 KBytes Hauptspeicher werden benötigt zum Ansehen // Übersetzen
  169.      "beliebig" großer Dateien
  170.  
  171.    * Gleichbleibende Performance beim Browsen beliebig großer Texte
  172.  
  173.    * Umschaltung Farbe // Schwarz-Weiss (F2)
  174.  
  175.    * integrierte Suchfunktion (F3) // Weitersuchen (F4)
  176.  
  177.    * sortierte Stichwortliste aus dem Text kann generiert werden (F5)
  178.      Die Stichwortliste wird über ein Wortfilter erstellt, das ca. 1000
  179.      deutsche Füllworte wie "und", "oder",... erkennt und diese aus-
  180.      filtert.
  181.  
  182.    * Das Übersetzungs-Programm kann aus jeder neu entstandenen Programm-
  183.      Datei wieder entpackte werden (ALT-F10) 
  184.  
  185.    * Der Text in dem entstandenen Programm kann in einer anderen Datei
  186.      abgelegt oder ausgedruckt werden. (SHIFT-F10)
  187.  
  188.    * Ab Version 2.2x wird kein dauerhaftes File-Locking mehr durchgeführt
  189.      (Netzwerk-Fähigkeit gewährleistet)
  190.  
  191.    * Teile des Textes können farblich hervorgehoben werden :
  192.  
  193.      Einleitendes Zeichen     : °07°°°e1
  194.        Zeichenfarbe           : in Hex (0..F)
  195.        Hintergrundfarbe       : in Hex (0..7)
  196.  
  197.       Bsp.: °°07 --> °07 Schwarz auf Hellgrau        °e1
  198.             °°F3 --> °F3 Weiss auf Türkis            °e1
  199.             °°E4 --> °E4 Gelb auf Rot                °e1
  200.  
  201.      Farb-Tabelle :
  202.     ┌─────────────────────┬────────────────────┐
  203.     │ Hintergrund und     │  nur für Zeichen   │
  204.     │ Zeichen             │                    │
  205.     ├─────────────────────┼────────────────────┤
  206.     │ Schwarz       - 0   │  Dunkelgrau    - 8 │
  207.     │ Blau          - 1   │  Hellblau      - 9 │
  208.     │ Grün          - 2   │  Hellgrün      - A │
  209.     │ Türkis        - 3   │  Helles Türkis - B │
  210.     │ Rot           - 4   │  Helles Rot    - C │
  211.     │ Magenta       - 5   │  Helles Magenta- D │
  212.     │ Braun         - 6   │  Gelb          - E │
  213.     │ Hellgrau      - 7   │  Weiss         - F │
  214.     └─────────────────────┴────────────────────┘
  215.  
  216. °07     Farben von 0 bis 7 sind als Hintergrundfarben erlaubt
  217. °F0     Farben von 0 bis F sind als Zeichenfarben erlaubt
  218.  
  219. ================================================================================
  220.  
  221.  
  222. 4. Probleme:
  223. ───────────
  224.  
  225.    * Probleme treten auf, wenn das mit TXT2EXE erstellte Programm mit
  226.      EXE-Komprimieren wie PKLITE, EXEPACK oder LZEXE verkleinert wird,
  227.      da bei diesen Programmen interne Verweis-Tabellen in ihrer Position
  228.      verändert werden können. (Meldung : CRC-Fehler)
  229.  
  230.    * Auf Netzwerken sollte der Benutzer von TXT2EXE ein Schreibrecht auf die
  231.      verwendeten Verzeichnisse besitzen.
  232.  
  233.    * Um einen Text zu "übersetzen" benötigt TXT2EXE temporär ca. 2,5-3 mal
  234.      soviel Plattenplatz wie die Größe der ursprünglichen Datei war, dabei
  235.      kann der verfügbare Plattenplatz nicht ausreichen (...)
  236.  
  237.    * TXT2EXE öffnet 3 bzw. 4 Dateien. Wird TXT2EXE in einer Shell getartet,
  238.      so kann die Meldung "Zu viele Dateien geöffnet" erscheinen. Abhilfe:
  239.      files = 30 in CONFIG.SYS.
  240.  
  241.  
  242. ================================================================================
  243.  
  244.  
  245. 5. Anwendungen // Benchmarks
  246. ────────────────────────────
  247.  
  248.    Für untenstehnede Aufrufe wurde folgende Test-Konfiguration verwendet:
  249.  
  250.    Betriebssystem : MS-DOS 4.01
  251.    Rechner        : 486 / 25 MHz / 8 MB -- kein (!!) HD-Cache-Programm
  252.                     ( files=30, buffers=20)
  253.    Festplatte     : Quantum LPS240
  254.    Grafik         : Video 7 VRAM IIe - VGA
  255.    Texte          : DOS.DAT    40.436 (Artikel aus DOS 1987-92)
  256.                     CTMC.DAT  407.637 (Artikel aus c't und MC 1983-92)
  257.  
  258.    Programme      : BENCH.EXE Programm um die Laufzeit von Programmen zu
  259.                               messen. Ein PD-Produkt von Turbo-Power Software
  260.  
  261.  
  262.    Arbeitsverzeichnis der Festplatte :
  263.    ┌───────────────────────────────────────────┐
  264.    │ C:\TP\EXE\TST>dir                         │
  265.    │ TXT2EXES EXE     19707 27.04.92   13:23   │
  266.    │ TXT2EXEO EXE     12676 27.04.92   13:24   │
  267.    │ CTMC     DAT    407822 21.03.92   12:55   │
  268.    │ DOS      DAT     40441 21.03.92   13:19   │
  269.    └───────────────────────────────────────────┘
  270.  
  271.   5.1 Ohne Stichwortliste
  272.   ───────────────────────
  273.   
  274.    5.1.1 DOS.DAT
  275.    ─────────────
  276.  
  277.    ┌──────────────────────────────────────────────────────────┐
  278.    │  C:\TP\EXE\TST>bench txt2exeo dos.dat dos.exe            │
  279.    │  BENCH. Utility for benchmarking programs.               │
  280.    │  TXT2EXEO V3.01 (o)                                      │
  281.    │  748 Zeilen bearbeitetDOS.EXE generiert. // 55 KBytes    │
  282.    │  (c) 1991/92 P.Fischer-Haaser                            │
  283.    │  Elapsed time: 6.24 seconds                              │
  284.    └──────────────────────────────────────────────────────────┘
  285.  
  286.    5.1.2 CTMC.DAT
  287.    ──────────────
  288.  
  289.    ┌───────────────────────────────────────────────────────────┐
  290.    │ C:\TP\EXE\TST>bench txt2exeo ctmc.dat ctmc.exe            │
  291.    │ BENCH. Utility for benchmarking programs.                 │
  292.    │ TXT2EXEO V3.01 (o)                                        │
  293.    │ 7286 Zeilen bearbeitetCTMC.EXE generiert. // 442 KBytes   │
  294.    │ (c) 1991/92 P.Fischer-Haaser                              │
  295.    │ Elapsed time: 35.52 seconds                               │
  296.    └───────────────────────────────────────────────────────────┘
  297.  
  298.    Wird keine Stichwortliste erzeugt (TXT2EXEo) so dauert benötigt das
  299.    Überstzen nur eine kurz Zeitspanne, die linear mit der Länge der
  300.    Textdatei ansteigt. ( ungefähr 12 KBytes / s)
  301.  
  302.  
  303.   5.2 Mit Stichwortliste
  304.   ──────────────────────
  305.  
  306.    5.2.1 DOS.DAT
  307.    ─────────────
  308.  
  309.    ┌────────────────────────────────────────────────────────────────┐
  310.    │ C:\TP\EXE\TST>bench txt2exes dos.dat dos.exe                   │
  311.    │ BENCH. Utility for benchmarking programs.                      │
  312.    │ TXT2EXE V3.01 (s)                                              │
  313.    │ 748 Zeilen bearbeitet                                          │
  314.    │ Stichwortliste bearbeiten...                                   │
  315.    │ 1002 Stichworte gefunden  // DOS.EXE generiert. // 82 KBytes   │
  316.    │ (c) 1991/92 P.Fischer-Haaser                                   │
  317.    │ Elapsed time: 15.89 seconds                                    │
  318.    └────────────────────────────────────────────────────────────────┘
  319.  
  320.    5.2.2 CTMC.DAT
  321.    ──────────────
  322.  
  323.    ┌─────────────────────────────────────────────────────────────────┐
  324.    │ C:\TP\EXE\TST>bench txt2exes ctmc.dat ctmc.exe                  │
  325.    │ BENCH. Utility for benchmarking programs.                       │
  326.    │ TXT2EXE V3.01 (s)                                               │
  327.    │ 7286 Zeilen bearbeitet                                          │
  328.    │ Stichwortliste bearbeiten...                                    │
  329.    │ 6261 Stichworte gefunden  // CTMC.EXE generiert. // 574 KBytes  │
  330.    │ (c) 1991/92 P.Fischer-Haaser                                    │
  331.    │ Elapsed time: 511.74 seconds                                    │
  332.    └─────────────────────────────────────────────────────────────────┘
  333.  
  334.    Wird eine Stichwortliste erzeugt, so liegt die Dauer der Übersetzung
  335.    weit über der Zeit, die für eine Übersetzung ohne Stichwortliste benötigt
  336.    wird. Dies ist so zu erklären: Bei jedem gefundenen Wort wird zunächst
  337.    geprüft, ob es ein sinnvolles Wort ist (Wortfilter). Ist dies der Fall,
  338.    so muß das Wort in die Liste einsortiert werden...
  339.  
  340.  
  341. ================================================================================
  342.  
  343.  
  344. 6. Versionen
  345. ────────────
  346.  
  347.   0.9x lauffähiger Prototyp (Dateilängen <= 64 KB) in Turbo Pascal 5.5
  348.        (TXT2EXE > 40 KBytes)
  349.  
  350.   1.0x funktionsfähiges Programm
  351.        (TXT2EXE = 25 KBytes)
  352.  
  353.   1.1x Suchfunktion eingebaut
  354.  
  355.   1.2x Extraktion von TEXT und Compiler
  356.  
  357.   1.5  File I/O und Video I/O in Assembler
  358.  
  359.   2.01 Erweiterung auf 2 Mrd. Zeilen
  360.        Turbo Pascal 6.0
  361.        (TXT2EXE 16 KBytes)
  362.  
  363.   2.1x internes Caching, Bug bei der Extraktion von Dateien entdeckt
  364.        (TXT2EXE < 13 KBytes)
  365.  
  366.   2.2  Verbesserung bei der Speicherverwaltung
  367.        File-Locking auf Netzwerken "wegprogrammiert"
  368.        (TXT2EXE 12 KBytes)
  369.  
  370.   3.00ß Erkennung von Binär-Dateien vor der Umwandlung
  371.        Text-Kompression (ca 20%)
  372.        Generierung einer sortierten Stichwortliste über Wortfilter
  373.        keine Compiler-Extraktion mehr möglich
  374.  
  375.   aktuelle Version:
  376.  
  377.   3.01 (27.April 1992)
  378.  
  379.        Kompression wieder entfernt (Laufzeit !!!)
  380.        Compiler-Extraktion wieder möglich
  381.        2 Programme: TXT2EXEo.EXE und TXT2EXEs.EXE
  382.  
  383.  
  384. ================================================================================
  385.  
  386.  
  387. 7. PD-Info
  388. ──────────
  389.  
  390.    Dieses Programm ist ein Public-Domain Produkt. Jeder darf mit TXT2EXE
  391.    beliebig viele Text in Programme übersetzen und weitergeben (Damit ist auch
  392.    die Weitergabe des Übersetzers inbegriffen). Falls Sie TXT2EXE nützlich
  393.    finden und öfters damit arbeiten, würde ich mich über einen freiwilligen
  394.    Anerkennungsbeitrag (ganz nach Ihrem Ermessen, DM 10,-- wären sicherlich
  395.    fair) freuen. Bei einem guten Essen im Gasthaus geben Sie ja auch gerne mal
  396.    ein "Trinkgeld".  
  397.  
  398.    Firmen, die TXT2EXE gewerblich einsetzen möchten und spezielle Anpassungen
  399.    oder Änderungen (z.B. Firmenname im Programm) wünschen, bitte ich, mit mir
  400.    Kontakt aufzunehmen. Programmanpassungen (gegen Berechnung) sind möglich.
  401.    (Siehe unten: Erweiterungen)
  402.    
  403.    Für eventuelle Schäden, die durch die Nutzung von TXT2EXE entstehen, ist 
  404.    alleinig der Benutzer von TXT2EXE verantwortlich. Mit dem Einsatz des
  405.    Programmes wird dieser Haftungsausschluß anerkannt.
  406.    
  407.    Für Verbesserungs-Vorschläge, Erweiterungen und Kritik am Programm bin ich
  408.    jederzeit offen:
  409.  
  410.                      Peter Fischer-Haaser
  411.                      Mozartstr. 10
  412.                      D-7100 Heilbronn
  413.                      Tel.: 07131/81947
  414.  
  415.  
  416. ================================================================================
  417.  
  418.  
  419. 8. Erweiterungen // Urheber-Vermerk
  420. ───────────────────────────────────
  421.  
  422.    Der Urheber-Vermerk der nach Gebrauch eines mit TXT2EXE generierten
  423.    Programms erscheint, kann gegen eine Gebühr entfernt oder ersetzt
  424.    werden. Ebenso können gegen eine geringe Gebühr auch Funktionen in
  425.    TXT2EXE eingefügt bzw. entfernt werden; der Pascal // Assembler -
  426.    Quelltext ist ebenfalls erhältlich. Anfagen bitte an obige Adresse.
  427.  
  428.  
  429. ================================================================================
  430.  
  431.  
  432. TXT2EXE wurde mit Turbo-Pascal 6.0 und Turbo-Assembler 2.01 erstellt
  433.  
  434.