home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1240 / handbuch.txt < prev    next >
Encoding:
Text File  |  1993-05-31  |  9.6 KB  |  266 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  11.                            ▓▓                 ▓▓░░
  12.                            ▓▓   LISTER.EXE    ▓▓░░
  13.                            ▓▓                 ▓▓░░
  14.                            ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░
  15.                              ░░░░░░░░░░░░░░░░░░░░░
  16.  
  17.  
  18.                             Shareware-Version 3.3
  19.  
  20.                    Listingoptimierer für dBASE-Programmcode
  21.  
  22.  
  23.  
  24.  
  25. LISTER.EXE                                                            Seite  1
  26. ──────────────────────────────────────────────────────────────────────────────
  27.  
  28.  
  29.                           K U R Z A N L E I T U N G
  30.  
  31.  
  32. Das Utility LISTER.EXE liest dBASE - Quellcodedateien und bereitet ihre
  33. Form etwas auf:
  34.  
  35.      -  alle Leerzeilen werden entfernt,
  36.  
  37.      -  alle führenden Leerzeichen und Tabulatoren werden entfernt,
  38.         Schleifen und Bedingungen durch Leerzeichen eingerückt,
  39.  
  40.      -  logische Werte und Konjunktionen (.T., .F., .AND., .OR., .NOT.) werden
  41.         in Großbuchstaben umgewandelt, davor und danach ein Leerzeichen einge-
  42.         fügt,
  43.  
  44.      -  vor und nach den vier Rechensymbolen (+, -, *, /) und dem Gleichheits-
  45.         zeichen wird ein Leerzeichen eingefügt, falls es nicht schon vorhanden
  46.         ist,
  47.  
  48.      -  nach einem Komma und der schließenden Klammer wird ein Leerzeichen ein-
  49.         gefügt,
  50.  
  51.      -  wahlweise fortlaufende Zeilennummern,
  52.  
  53.      -  wahlweise optische Hervorhebung von Schleifen und Bedingungen,
  54.  
  55.      -  alle Befehle und Variablen werden in Kleinbuchstaben umgewandelt,
  56.         können jedoch wahlweise in Großbuchstaben ausgegeben werden,
  57.  
  58.      -  Kommentare in Befehlszeilen ("&&") auf Fluchtlinie.
  59.  
  60.      -  Kommentarzeilen, die mit einem Asterisk "*" beginnen, werden unver-
  61.         ändert übernommen,
  62.  
  63.      -  Programmzeilen zwischen den Befehlen TEXT ... ENDTEXT werden unver-
  64.         ändert übernommen.
  65.  
  66.      -  Programmzeilen, die mit dem Befehl RUN beginnen, werden unverändert
  67.         übernommen.
  68.  
  69.      -  Wahlweise kann die aktuelle Version vor die Datei geschrieben werden.
  70.  
  71.      -  Wahlweise kann ein Vorspann vor die Datei geschrieben werden.
  72.  
  73. Das Programm erstellt eine ASCII-Datei, die den aufbereiteten Quellcode ent-
  74. hält. Gleichzeitig können Sie den Text wahlweise auf den Bildschirm und/oder
  75. Drucker ausgeben lassen. Wenn Sie bereits während der Programmierung Ihren
  76. Quellcode ausführlich dokumentieren, erhalten Sie damit eine komplette Pro-
  77. grammbeschreibung mit sämtlichen Informationen über das Programm.
  78.  
  79. LISTER.EXE                                                            Seite  2
  80. ──────────────────────────────────────────────────────────────────────────────
  81.  
  82.  
  83. INSTALLATION:
  84.  
  85. Auf der Diskette sollten Sie folgende Dateien finden:
  86.  
  87.         BESTELL.TXT     - Bestellformular für Vollversion
  88.         DBCOMP.PRG      - dBASE IV-Quellcode zur Demonstration
  89.         DBCOMP.ASC      - mit LISTER bearbeitete Datei
  90.         DBCOMP.DBF      - wird für DBCOMP.PRG benötigt
  91.         HANDBUCH.TXT    - Bedienungsanleitung
  92.         LISTER.EXE      - Programm
  93.         DSINFO.TXT      - Informationen zur DS
  94.  
  95. Kopieren Sie die Datei LISTER.EXE in ein beliebiges Unterverzeichnis der Fest-
  96. platte, auf das ein Pfad gelegt wurde (z. B. PATH = C:\DOS).
  97.  
  98.  
  99. BEDIENUNG:
  100.  
  101. Das Programm unterscheidet zwischen dem interaktiven und dem Batchmodus.
  102. Im interaktiven Modus können Sie erforderliche Einstellungen selbst vornehmen,
  103. im Batchmodus läuft das Programm völlig selbständig und eignet sich deshalb
  104. für den Aufruf aus Batchdateien.
  105.  
  106.  
  107. 1. Starten Sie das Programm vom aktuellen Laufwerk oder Unterverzeichnis mit
  108.    dem Aufruf
  109.                       C:> LISTER <Filename> [/A | /B | /?]
  110.  
  111.    Beim Aufruf ohne <Filename> erhalten Sie darauf eine Auswahl aller vor-
  112.    handenen Dateien mit der Endung .PRG . Wählen Sie die zutreffende Datei
  113.    mit dem Leuchtbalken aus.
  114.    Mit den Tasten "Page Down" und "Page Up" können Sie in der Auswahl blät-
  115.    tern.
  116.  
  117.    Mit dem Parameter /A starten Sie den Batchmodus für ASCII-Dateien. Sie er-
  118.    halten eine Datei mit der Endung .ASC, die Zeilennummern und die grafische
  119.    Aufbereitung der Schleifen und Bedingungen enthält. Die evtl. vorhandene
  120.    Version wird nicht geändert.
  121.  
  122.    Mit dem Parameter /B starten Sie den Batchmodus für PRG-Dateien. Die vor-
  123.    handene Quellcode-Datei wird in .BAK umbenannt. Sie erhalten eine Datei
  124.    mit der Endung .PRG, die nur den aufbereiteten Quellcode enthält (keine
  125.    Zeilennummern und grafische Aufbereitung der Schleifen und Bedingungen).
  126.    Die Version wird entweder eingefügt oder geändert.
  127.    Diese Datei können Sie problemlos unter dBASE oder CLIPPER einsetzen.
  128.  
  129.    Mit dem Parameter /? wird ein Hilfebildschirm ausgegeben.
  130.  
  131.    Ohne die Parameter /A und /B startet das Programm im interaktiven Modus.
  132.    Hier können Sie die Einstellungen selbst vornehmen.
  133.  
  134. LISTER.EXE                                                            Seite  3
  135. ──────────────────────────────────────────────────────────────────────────────
  136.  
  137.  
  138. 2. Im interaktiven Modus erhalten Sie als nächstes die Eingabemaske. Hier
  139.    können Sie folgende Einstellungen vornehmen:
  140.  
  141.    -  Programmname
  142.       ist der Name Ihrer dBASE - Quellcodedatei (Endung immer .PRG)
  143.  
  144.    -  Textdatei
  145.       ist der Name der ASCII-Datei, die erstellt wird (Endung immer .ASC)
  146.  
  147.    -  Version ausgeben
  148.       geben Sie hier ein "J" ein, wird die aktuelle Versionsnummer des Quell-
  149.       codes ausgegeben
  150.  
  151.    -  Großbuchstaben
  152.       geben Sie hier ein "J" ein, wird der Quellcode in Großbuchstaben ausge-
  153.       geben
  154.  
  155.    -  Linker Rand
  156.       ist der linke Rand des Ausdrucks (nur auf Drucker wirksam)
  157.  
  158.    -  Zeilen je Seite
  159.       ist die Anzahl der Zeilen des Ausdrucks (nur auf Drucker wirksam)
  160.  
  161.    -  Zeilennummern
  162.       schaltet die Ausgabe von Zeilennummern ein oder aus
  163.  
  164.    -  Grafik
  165.       schaltet die Hervorhebung von Schleifen und Bedingungen durch Grafikzei-
  166.       chen ein oder aus
  167.  
  168.    -  Vorspann
  169.       gibt einige Kommentarzeilen aus. Hier können Sie anschließend Beschrei-
  170.       bungen zum Programm eintragen. Die in der Datei enthaltenen Prozeduren
  171.       und Funktionen werden automatisch ermittelt und aufgeführt.
  172.  
  173.    -  An Drucker
  174.       der erstellte ASCII-Text wird sofort an den Drucker gesandt.
  175.       Schalten Sie den Drucker zweckmäßigerweise auf einen kleinen Zeichen-
  176.       abstand. Der Ausdruck wird dadurch übersichtlicher.
  177.  
  178.    -  An Bildschirm
  179.       der erstellte ASCII-Text wird auf dem Bildschirm ausgegeben
  180.  
  181. Das Programm erstellt dann im aktuellen Laufwerk oder Unterverzeichnis die
  182. ASCII-Datei und gibt den Text wahlweise auf den Drucker und/oder den Bild-
  183. schirm aus.
  184.  
  185. LISTER.EXE                                                            Seite  4
  186. ──────────────────────────────────────────────────────────────────────────────
  187.  
  188.  
  189.      !!! WICHTIG !!!
  190.  
  191.   -  Das Programm legt während des Ablaufs einige temporäre Dateien an,
  192.      deren Größe von der Länge des Quellcodes abhängt. Sie können diese
  193.      Dateien durch Setzen der Umgebungsvariablen TEMP auf ein beliebiges
  194.      Laufwerk (z. B. RAM-Disk) umleiten. Geben Sie dazu im Betriebssystem
  195.      z. B. ein:
  196.  
  197.               SET TEMP=D:\ <Return>
  198.  
  199.   -  Die größte Zeilennummer, die das Programm vergeben kann, ist 99.999.
  200.      Ist Ihr Quellcode länger, müssen Sie die Zeilennummern in der ASCII-
  201.      Datei nachträglich ändern.
  202.  
  203.   -  Das Programm kann nur Zeilen mit einer maximalen Länge von 256 Zeichen
  204.      bearbeiten. Enthält Ihr Quellcode längere Zeilen, sollten Sie vor der
  205.      Bearbeitung die Zeilen durch das Semikolon ";" trennen.
  206.  
  207.   -  Das Programm erwartet, daß Sie den Quellcode ausschreiben (nicht nur
  208.      4 Buchstaben). Außerdem sollten Sie auf Kommentare "&&" in Befehlszeilen,
  209.      die nachfolgende Schlüsselwörter enthalten, verzichten. Dies kann bei der
  210.      optischen Aufbereitung der Schleifen und Bedingungen zu Fehlern führen.
  211.  
  212.   -  Das Programm erkennt folgende Schleifen und Bedingungen:
  213.  
  214.          o  IF ... ELSE ... ENDIF
  215.  
  216.          o  DO CASE ... CASE ... OTHERWISE ... ENDCASE
  217.  
  218.          o  DO WHILE ... ENDDO
  219.  
  220.          o  FOR ... NEXT
  221.  
  222.          o  SCAN ... ENDSCAN
  223.  
  224.          o  PRINTJOB ... ENDPRINTJOB
  225.  
  226.          o  BEGIN TRANSACTION ... END TRANSACTION
  227.  
  228.          o  TEXT ... ENDTEXT
  229.  
  230.   -  Das Programm arbeitet am schnellsten im Batchmodus, da die gleichzeitige
  231.      Bildschirm- und/oder Druckausgabe den Ablauf bremsen.
  232.  
  233. LISTER.EXE                                                            Seite  5
  234. ──────────────────────────────────────────────────────────────────────────────
  235.  
  236.  
  237. COPYRIGHT:
  238.  
  239. LISTER ist ein durch das Urheberrechtsschutzgesetz geschütztes Programm.
  240. Sie finden auf dieser Diskette eine voll funktionstüchtige Prüfversion.
  241. Diese Shareware-/Prüfversion darf sowohl kommerziell wie privat beliebig
  242. kopiert und verteilt werden. Nur durch Ihre Mithilfe bei der Werbung und
  243. durch den Direktvertrieb können Shareware-Produkte sehr preiswert ange-
  244. boten werden.
  245.  
  246. Bitte zahlen Sie bei regelmäßiger Benutzung dieses Programms die Lizenz-
  247. gebühr von 50 DM. Sie erhalten dann die neueste Vollversion. Mit Ihrer
  248. finanziellen Unterstützung von Shareware-Autoren fördern Sie die Entwik-
  249. klung preiswerter Software. Einen Bestellschein finden Sie in der Datei
  250. BESTELL.TXT.
  251.  
  252. Ich übernehme keinerlei Haftung für Schäden an Rechnern oder Datenverluste aus
  253. dem Gebrauch von LISTER.
  254.  
  255. Falls Sie Tips oder Verbesserungsvorschläge zu LISTER haben, teilen Sie sie
  256. mir bitte mit. Vielen Dank im voraus für Ihre Unterstützung.
  257.  
  258.  
  259.  
  260.          Erlangen, 1. Juni 1993
  261.  
  262.          Bernd Hohenester
  263.          Aschaffenburger Straße 16
  264.          D-91056 Erlangen
  265.          Tel.: (09131) 4 87 88
  266.