home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / TextEditors&Viewers / TextConverter / TXTWND39.LHA / Deutsch / Text-Wandler.DOK < prev    next >
Encoding:
Text File  |  1995-10-03  |  28.2 KB  |  751 lines
  1.  
  2.  
  3.                            Text-Wandler V3.9
  4.                          <><><><><><X><><><><>
  5.                       © 1992-1995 von Kai Seidel
  6.  
  7.  
  8. Ein bißchen Theorie:
  9. ********************
  10.  
  11. Da  ich  neben  meinem  Amiga noch einen MS-DOS Rechner für die Bearbeitung
  12. meiner  Mailbox-Programme  & Texte habe, ist es immer lästig, daß die AMIGA
  13. ASCII-Tabelle  nicht  mit  der  IBM-Tabelle übereinstimmt.  Die AMIGA-Texte
  14. sind  auf  einem MS-DOS Rechner (fast) nicht lesbar.  Aus diesem Grund habe
  15. ich  mich  entschlossen  einen  Text-Wandler  zu  schreiben,  der die Texte
  16. zwischen  beiden  ASCII-Formaten  umwandelt.   Ebenso sind die unterschied-
  17. lichen  Zeilenenden  zwischen  MS-DOS  und  AMIGA  ein  Problem.  Der AMIGA
  18. benutzt  ein  $0a  (=Zeilenvorschub)  und  der  MS-DOS  Rechner  ein  $0d0a
  19. (=Wagenrücklauf + Zeilenvorschub) für das Zeilenende.
  20.  
  21.  
  22. Zum Programm:
  23. *************
  24.  
  25. Mein  Programm  behebt  diese  Problematik.   Es  ist in 100% Assembler ge-
  26. schrieben  und nutzt somit die VOLLE Rechnergeschwindigkeit aus.  Es werden
  27. immer  16KByte  (=16384  Bytes) von dem zu wandelnden Text-File eingelesen,
  28. umgewandelt und wieder unter dem neuen Namen abgespeichert.  Es werden aber
  29. nicht  nur  16KByte Speicher vom Programm allokiert.  Insgesamt sollten ca.
  30. 80  KByte  an RAM-Speicher frei sein.  (Fast?) Alle Fehleingaben werden vom
  31. Programm  abgefangen.  Um eine möglichst hohe Geschwindigkeit zu erreichen,
  32. wurden  im  Programm  8 (acht) voneinander getrennte Routinen, zwei für die
  33. Umwandlung  von  Texten  zwischen MS-DOS und Amiga, ebenfalls zwei, für die
  34. Konvertierung   von   Texten   zwischen  Amiga  und  Atari,  eine  für  die
  35. Konvertierung  in  normale  ASCII-Zeichen  (Ä=Ae),  eine für die Entfernung
  36. unbenutzter  Space-  oder Tabulatorzeichen, eine zum Entfernen von lästigen
  37. ANSI-Sequenzen   und  eine  zum  Benutzen  einer  eigenen  Wandlungstabelle
  38. integriert.   Ebenfalls  sind drei komplette ASCII-Tabellen im Programm mit
  39. drin,  die  es  problemlos  ermöglichen,  auch andere Zeichen als >ÄÖÜäöüß<
  40. umzuwandeln.   Das  Programm besitzt ab Version 2.0 einen STARTUP-Code.  Es
  41. kann  seither  also  sowohl  vom  CLI/SHELL  als auch von der Workbench aus
  42. genutzt werden!
  43.  
  44. Der Text-Wandler konvertiert seit der Version 1.4 folgende Sonderzeichen:
  45.  
  46.    ÄÖÜäöüߢ£¡¤¥§ª«¬­°±²µ¶º»¼½¿ÅÆÇÉÑàáâåæçèéêëìíîïñòóôøúûÿ
  47.  
  48. Diese  Zeichen  werden  in beide Wandlungs-Richtungen korrekt transferiert.
  49. Leider  sind das auch die einzigen Sonderzeichen, die sowohl in der MS-DOS-
  50. und der AMIGA-ASCII-Tabelle vorhanden sind.
  51.  
  52. Den   Wandlungsablauf   kann   man   mit   der  Tastenkombination  >CTRL-C<
  53. (=Control-Taste  +  C  gleichzeitig)  abbrechen  bzw.  im Fenster-Modus mit
  54. einem Druck auf das Stop-Gadget.
  55.  
  56. Während des Wandlungs-Ablaufes wird die aktuelle Position der Text-Position
  57. angegeben.
  58.  
  59.  
  60. Voraussetzungen an das System:
  61. ******************************
  62.  
  63. Eigentlich  keine  großen.   Der Text-Wandler müßte mit jeder Konfiguration
  64. laufen.  Voraussetzung ist allerdings Kickstart 1.2 oder höher!
  65.  
  66. Kickstart/WB 2.x/3.x (Intuition/Gadtools V37 oder höher):
  67.  
  68.   Für  den  Filerequester wird die >ASL.LIBRARY< benötigt.  Diese MUSS sich
  69.   im   "LIBS:"   Verzeichniss   der   Bootdiskette   befinden.    Sie  wird
  70.   normalerweise ab Workbench 2.x mitgeliefert!
  71.  
  72. Kickstart/WB 1.2/1.3:
  73.  
  74.   Für den Filerequester wird die >REQ.LIBRARY< benötigt.  Sollte sich diese
  75.   nicht   im  Archiv  befinden,  sollte  man  mal  auf  den  Fish-Disketten
  76.   nachsehen.  Diese Library muß vor dem Start in das LIBS:  Verzeichnis der
  77.   Workbench  Diskette  bzw.   der  Boot-Partition  kopiert werden!  Ist sie
  78.   nicht vorhanden, kann der Text-Wandler im Workbench-Modus nicht gestartet
  79.   werden (entsprechende Fehlermeldung wird ausgegeben)!
  80.  
  81.  
  82. Installation:
  83. *************
  84.  
  85. Man kopiere die Dateien
  86.  
  87.     Text-Wandler
  88.     und Text-Wandler.info
  89.  
  90. in  ein  beliebiges  Verzeichnis und starte das Programm von der SHELL oder
  91. Workbench aus.
  92.  
  93.  
  94. WORKBENCH-Aufruf:
  95. *****************
  96.  
  97. Ein  Doppelclick  auf das Text-Wandler-Icon und der Textwandler startet mit
  98. der Intuition-Oberfläche (im sog.  Workbench-Modus).
  99.  
  100. Je  nach  Kickstart/Workbench  Version öffnet der Text-Wandler unterschied-
  101. liche Screens und Windows.
  102.  
  103.  
  104. Die Benutzung unter Kickstart/Workbench 1.2/1.3
  105. ***********************************************
  106. Die  Shareware-Version  öffnet zuerst ein INFO-Window.  Das Window kann man
  107. mit   einem   Click   auf   dessen   CLOSE-Gadget  (=Schließ-Schalter)  zum
  108. Verschwinden  bringen.   Es  erscheint  nun  das  eigentliche  Text-Wandler
  109. Fenster mit folgenden Gadgets:
  110.  
  111. - Quell-Datei wählen
  112.  
  113.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  114.   Req.library.   Mit  diesem  kann  man  sich  nun  bequem  per Maus den zu
  115.   wandelnden Text aussuchen.
  116.  
  117. - Gadget rechts neben >Quell-Datei wählen<
  118.  
  119.   Dies  ist  ein  sog.   String-Gadget.   Wenn  man  per  Filerequester die
  120.   Text-Datei  gewählt  hat, erscheint hier der komplette Filename inclusive
  121.   Pfad.   Hier kann man auch per Hand die Eingabe machen, indem man auf das
  122.   Gadget clickt.
  123.  
  124. - Ziel-Datei wählen
  125.  
  126.   Hier kann wieder per Filerequester der Dateiname des fertig konvertierten
  127.   Files gewählt werden.
  128.  
  129. - Gadget rechts neben >Ziel-Datei wählen<
  130.  
  131.   Hier wieder das zugehörige String-Gadget für den Ziel-Datei-Name + Pfad.
  132.  
  133. - Tabelle wählen
  134.  
  135.   Wird   dieses  Gadget  angeklickt,  öffnet  sich  der  Filerequester  der
  136.   Req.library.   Mit  diesem  wählt  man  die Wandlungs-Tabelle (dazu unten
  137.   mehr).
  138.  
  139. - Gadget rechts neben >Tabelle wählen<
  140.  
  141.   Hier  wieder  das zugehörige String-Gadget für den Dateinamen bzw.  -Pfad
  142.   der Tabelle.
  143.  
  144. - Gadget rechts neben >MODUS<
  145.  
  146.   Hier kann der gewünschte Modus eingestellt werden, mit dem der Quell-Text
  147.   behandelt werden soll.
  148.  
  149. - OK bzw. STOP
  150.  
  151.   Wurde  Quell-  und  Ziel-Datei sowie der entsprechende Modus eingestellt,
  152.   kann   man   mit  OK  den  Konvertierungsvorgang  starten.   Während  des
  153.   Konvertierens  wird  das  OK-Gadget zum STOP-Gadget.  Man kann also durch
  154.   click auf das Stop-Gadget die Konvertierung abbrechen.
  155.  
  156.  
  157. Neben  >Position:<  erscheint  während der Konvertierung immer die aktuelle
  158. Text-Position, an der der Wandler momentan arbeitet.
  159.  
  160. Treten Fehler auf, so werden diese bei >Status< ausgegeben.
  161.  
  162.  
  163. Die Benutzung unter Kickstart/Workbench 2.x/3.x
  164. ***********************************************
  165. Der  Text-Wandler  öffnet  einen  Screen  im aktuellen Darstellungsmodi der
  166. Workbench   (PAL/NTSC).    Dazu   ein   Window,  in  dem  die  Gadgets  und
  167. Filerequester  dargestellt werden.  Die Shareware-Version öffnet zuerst ein
  168. INFO-Window.    Das   Window   kann   man   mit   einem  Click  auf  dessen
  169. "WEITER"-Gadget zum Verschwinden bringen.
  170.  
  171. Das Text-Wandler Fenster enthält folgende Gadgets:
  172.  
  173. - Quell-Datei wählen
  174.  
  175.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  176.   Req.library.   Mit  diesem  kann  man  sich  nun  bequem  per Maus den zu
  177.   wandelnden Text aussuchen.
  178.  
  179. - Gadget rechts neben >Quell-Datei wählen<
  180.  
  181.   Dies  ist  ein  sog.   String-Gadget.   Wenn  man  per  Filerequester die
  182.   Text-Datei gewählt hat, erscheint hier der komplette Filename inclusive
  183.   Pfad.   Hier kann man auch per Hand die Eingabe machen, indem man auf das
  184.   Gadget clickt.
  185.  
  186. - Ziel-Datei wählen
  187.  
  188.   Hier kann wieder per Filerequester der Dateiname des fertig konvertierten
  189.   Files gewählt werden.
  190.  
  191. - Gadget rechts neben >Ziel-Datei wählen<
  192.  
  193.   Hier wieder das zugehörige String-Gadget für den Ziel-Datei-Name + Pfad.
  194.  
  195. - Tabelle wählen
  196.  
  197.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  198.   Req.library.   Mit  diesem  wählt  man  die Wandlungs-Tabelle (dazu unten
  199.   mehr).
  200.  
  201. - Gadget rechts neben >Tabelle wählen<
  202.  
  203.   Hier  wieder  das zugehörige String-Gadget für den Dateinamen bzw.  -Pfad
  204.   der Tabelle.
  205.   Ist  das  MODUS-Gadget nicht auf "Wandlungstabelle benutzen" eingestellt,
  206.   so ist dieses String-Gadget, sowie dasjenige zum Auswaehlen des Files mit
  207.   dem Filerequester abgeschaltet.
  208.  
  209.  
  210. - Gadget unterhalb >MODUS<
  211.  
  212.   Hier kann der gewünschte Modus eingestellt werden, mit dem der Quell-Text
  213.   behandelt werden soll.
  214.  
  215. - Start/Stop
  216.  
  217.   Wurde  Quell-  und  Ziel-Datei sowie der entsprechende Modus eingestellt,
  218.   kann  mit  "Start/Stop"  der  Konvertierungsvorgang getartet werden.  Man
  219.   kann  also  durch nochmaligen click auf das Stop-Gadget die Konvertierung
  220.   abbrechen.
  221.  
  222.  
  223. Neben  >Position:<  erscheint  während der Konvertierung immer die aktuelle
  224. Text-Position, an der der Wandler momentan arbeitet.
  225.  
  226. Treten Fehler auf, so werden diese bei >Status< ausgegeben.
  227.  
  228. Mit  dem Close-Gadget des Windows wird das Programm beendet.  Die aktuellen
  229. Einstellungen,  wie  Konvertierungs-Modus,  File-Pfade  &  Namen, werden im
  230. ENV:-  Verzeichniss  temporär  gespeichert.   Das  File  das angelegt wird,
  231. lautet  "tw.tmp" und wird beim nächsten Aufruf wieder eingeladen.  Wird ein
  232. Reset ausgelöst, wird dieses File gelöscht.
  233. Will  man  seine  Grundeinstellung dauerhaft speichern, so muß das File vom
  234. ENV:- in das ENVARC:-Verzeichniss kopiert werden.
  235.  
  236.  
  237.  
  238. CLI/SHELL-Aufruf:
  239. *****************
  240.  
  241. Text-Wandler [-i/-a/-m/-t/-s/-c/-u/-r/-z]
  242.          [-o] [-n] <Quell-Datei> <Ziel-Datei> [Tabelle]
  243.  
  244. <> Argumente
  245. [] Optionen
  246.  
  247.  
  248. ARGUMENTE:
  249. **********
  250.  
  251. Die  Argumente  <Quell-Datei>  und  <Ziel-Datei>  MÜSSEN  angegeben werden!
  252. Ausgenommen  ist  die  Anwahl  der  "-u" Option, mit der man die Intuition-
  253. Oberfläche  aufruft!   Andernfalls  bekommt  man  vom Programm eine Fehler-
  254. meldung.  Die Reihenfolge MUß ebenfalls eingehalten werden.
  255.  
  256. Besitzt  ein  File-Name  ein  Leerzeichen,  so muß der gesamte File-Name in
  257. Anführungszeichen stehen!  (siehe Beispiele unten)
  258.  
  259. Man  kann  zusätzlich statt dem Ziel-Dateinamen auch einen Pfad angeben, in
  260. den die Quell-Datei, und mit dem Quell-Dateinamen, konvertiert wird.
  261.  
  262. OPTIONEN:
  263. *********
  264.  
  265.  Von den folgenden neun Optionen kann jeweils immer nur EINE gewählt
  266.  werden:
  267.  
  268. -i  Der  Text  ist  im  AMIGA-ASCII-Format und soll ins MS-DOS-ASCII-Format
  269.     inclusive Sonderzeichenwandlung konvertiert werden.
  270.  
  271. -a  Der  Text  ist  im  MS-DOS-ASCII-Format und soll ins AMIGA-ASCII-Format
  272.     inclusive Sonderzeichenwandlung konvertiert werden.
  273.  
  274. -t  Der  Text  ist im AMIGA-ASCII-Format und soll ins ATARI-ST-ASCII-Format
  275.     inclusive Sonderzeichenwandlung konvertiert werden.
  276.  
  277. -m  Der  Text  ist im ATARI-ST-ASCII-Format und soll ins AMIGA-ASCII-Format
  278.     inclusive Sonderzeichenwandlung konvertiert werden.
  279.  
  280. -s  Der  Text ist  entweder  im AMIGA-ASCII-  oder  im MS-DOS-ASCII-Format.
  281.     Aus   diesem  Text  werden  nun  alle  überflüssigen  Leerzeichen  oder
  282.     Tabulatoren  (siehe  Einschränkungen  der  SHAREWARE  Version)  aus dem
  283.     Quelltext entfernt.
  284.  
  285. -c  Die  im  AMIGA-Text  (!)  enthaltenen  Umlaute  wie ÄÖÜ etc.  werden in
  286.     gewöhnliche ASCII-Zeichen umgewandelt.  Z.B.  >Ä< wird zu >AE<.
  287.  
  288. -u  Der  Text-Wandler springt in den Workbench-Modus.  D.h.  es öffnet sich
  289.     ein Fenster, in dem man sämtliche Optionen per Maus anwählen kann!
  290.  
  291. -r
  292.  
  293.   ANSI-Sequenzen werden hiermit aus AMIGA-Texten herausgelöscht.
  294.  
  295. -z  Benutzt  für den Wandlungsablauf eine Eigene Tabelle.  Ist diese Option
  296.     angewählt,  MUSS  als  dritter  Filename  der Name der Wandlungstabelle
  297.     stehen ([Tabelle])!  Siehe Einschränkungen der SHAREWARE Version!
  298.  
  299.   Wird  keiner  der  oben  angegebenen  OPTIONEN  gewählt, so wird der Text
  300.   automatisch ins MS-DOS-Format konvertiert.
  301.  
  302.  Die restlichen zwei Optionen können, müssen aber nicht angegeben werden:
  303.  
  304. -o  Wenn  ein File mit demselben Namen des angegebenen Ziel-Filenamen schon
  305.     existiert,  so wird bei dieser Option keine Sicherheitsabfrage gemacht,
  306.     ob das File überschrieben werden darf.
  307.  
  308. -n  Schaltet die  Anzeige für die aktuelle  Textposition des Wandelvorgangs
  309.     ab (spart ein paar Zyklen).
  310.  
  311.  
  312. BEISPIELE:
  313. **********
  314.  
  315. Zur Veranschaulichung ein paar Beispiele:
  316.  
  317. 1.  Text  auf Disk in DF0:  Namens "Test.txt" ist im AMIGA-Format  und soll
  318.     ins  MS-DOS-Format konvertiert werden.  Dabei soll der Fertige ins RAM:
  319.     unter dem Namen "Hallo.txt".  Dazu ist folgender Aufruf nötig:
  320.  
  321.    Text-Wandler -i DF0:Test.txt RAM:Hallo.txt
  322.  
  323. 2.  Text  auf  Festplatte DH0:  Namens "Guten Tag.TXT" ist  im AMIGA-Format
  324.     und  soll  ins MS-DOS-Format auf den Datenträger DF2:  mit dem gleichen
  325.     namen konvertiert werden.
  326.  
  327.    Text-Wandler -i "DH0:Guten Tag.TXT" DF2:
  328.  
  329. 3.  Text auf Disk in PC0:  Namens "LESEN.TXT" ist im MS-DOS-Format und soll
  330.     ins  AMIGA-Format  auf  Festplatte WORK:  mit dem Namen "Lies Mich.TXT"
  331.     konvertiert  werden.   Eventuell  schon  vorhandenes  File mit gleichem
  332.     Namen ("Lies Mich.txt") darf gelöscht werden.
  333.  
  334.    Text-Wandler -a-o PC0:LESEN.TXT "WORK:Lies Mich.TXT"
  335.  
  336. 4.  Text  in  RAM:   Namens  "Temp.TXT" im AMIGA- oder  MS-DOS-Format wurde
  337.     gerade   editiert.    Es   sollen   eventuell   vorhandene,  unwichtige
  338.     Leerzeichen  oder  Tabulatoren an den Zeilenenden entfernt werden.  Das
  339.     fertige  File  soll  dann  "RAM:Fertig.TXT"  heißen.   Ebenso  soll die
  340.     Ausgabe   der  aktuellen  Textposition  des  Text-Wandlers  unterdrückt
  341.     werden.
  342.  
  343.    Text-Wandler -s-n RAM:Temp.TXT RAM:Fertig.TXT
  344.  
  345. 5.  Text  auf  Disk DF2:  Namens "Text-Wandler.DOK" im AMIGA- oder  MS-DOS-
  346.     Format,  besitzt Umlaute.  Diese sollen in Normalbuchstaben auf DISK in
  347.     DF1:  mit Namen "TXTWND.DOK" gewandelt werden.
  348.  
  349.    Text-Wandler -c DF2:Text-Wandler.DOK DF1:TXTWND.DOK
  350.  
  351. 6.  Man will den Text-Wandler mit der Intuition-Oberfläche starten und  mit
  352.     dieser sämtliche Eingaben machen.
  353.  
  354.    Text-Wandler -u
  355.  
  356. 7.  Ein  Capture-File  (z.B.   von  JRComm) enthält lästige  ANSI-Sequenzen
  357.     welche  entfernt  werden sollen.  Das File heißt "DF1:Beispiel.CAP" und
  358.     soll ins RAM:  gewandelt werden.
  359.  
  360.    Text-Wandler -r DF1:Beispiel.CAP RAM:
  361.  
  362. 8.  Ein  Text  soll  nach  eigenem Belieben gewandelt werden.  Dazu hat man
  363.     sich eine eigene Tabelle angelegt (siehe unten), die die Buchstaben und
  364.     Sonderzeichen  einfach vertauscht.  Die Tabelle heißt "t:Tab.tab".  Der
  365.     Text,  der  gewandelt werden soll ist im RAM:  und schreibt sich "Hallo
  366.     Herr XYZ".  Der fertige Text soll in das Verzeichniss T:  mit dem Namen
  367.     "Guten_Tag.TXT".
  368.  
  369.    Text-Wandler -z "RAM:Hallo Herr XYZ" T:Guten_Tag.TXT t:Tab.tab
  370.  
  371.  
  372. Die Wandlungstabelle:
  373. *********************
  374.  
  375. Hier  ist nun die Text-Wandler Version, auf die viele Leute gewartet haben!
  376. Ab  Version  3.0  kann der Text-Wandler in sekundenschnelle jeden Text nach
  377. Belieben verunstalten.  Doch nun konkret:
  378.  
  379. Die  CLI/SHELL-Option  "-z"  bzw.   der  Wandlungs-Modus  "Wandlungstabelle
  380. benutzen"  benötigen  eine  sog.   Wandlungs-Tabelle.   Diese hat folgendes
  381. Aussehen:
  382.  
  383. "abc"="def"; /* gewandelt wird >abc< in >def< */
  384. 34,"Hallo",34=">Helau<"; // Hier wird "Hallo" in >Helau< konvertiert
  385. $0a=$0d,$0a; /* Das Amiga-Linefeed wird durch MS-DOS Carriage Return
  386.         und Linefeed ersetzt */
  387. .....
  388. .
  389. .
  390. usw.
  391.  
  392. Es dürfen Strings, Hex- und Dezimalzahlen angegeben werden.  Strings müssen
  393. in   Anführungszeichen   gesetzt   werden   und   Hexzahlen  benötigen  ein
  394. Dollarzeichen vor der Zahl.
  395.  
  396. Das   'Istgleichzeichen'   "="   trennt   die  beiden  Zeichen(folgen)  die
  397. konvertiert werden sollen.  Am Ende benötigt der Text-Wandler ein Semikolon
  398. ";" um das Ende einer Definition zu markieren.
  399.  
  400. Kommentare  sind nun auch möglich.  Entweder normale C- oder C++ Kommentare
  401. dürfen  angegeben  werden, wobei erstere mit der Zeichenfolge "/*" beginnen
  402. und  mit  "*/"  Enden.   C++ Kommentare beginnen mit "//" und Enden mit dem
  403. Zeilenende !
  404.  
  405. Zum genaueren Verständnis ein paar Beispiele:
  406.  
  407. Der  Buchstabe  "a"  (klein  a)  soll  im Text in ein GROSSES "A" gewandelt
  408. werden.  Dazu kann man folgende Kombinationen benutzen:
  409.  
  410.   $61=$41;
  411.    oder
  412.   "a"="A";
  413.    oder
  414.   97=$41;
  415.    etc.
  416.  
  417. Die Zeichen "-" und "+" sollen miteinander vertauscht werden:
  418.  
  419.   $2B=$2D;
  420.   $2D=$2B;
  421.    oder
  422.   "-"="+";
  423.   "+"="-";
  424.    etc.
  425.  
  426. Alle Leerzeichen sollen mit einem "_" ersetzt werden:
  427.  
  428.   $20=$5F;
  429.    oder
  430.   32="_";
  431.  
  432. Jedes "!" soll eliminiert werden:
  433.  
  434.   "!"=;
  435.  
  436.  
  437. Natürlich  kann  man  sich  hiermit eine ganz eigenen ASCII-Zeichensatz zu-
  438. sammenstellen.
  439.  
  440.  
  441. Fehlermeldungen:
  442. ****************
  443.  
  444. Für folgende Fehleingaben/Probleme existieren Fehlermeldungen:
  445.  
  446. - Keine Angaben gemacht
  447. - Falsche/Keine Option(en) angegeben
  448. - Keine oder nur ein Filename wurde angegeben
  449. - Quell- und Ziel-Dateinamen sind gleich *)
  450. - Quell-Datei nicht vorhanden
  451. - Ziel-Datei bereits vorhanden *)
  452. - Ziel-Datei-Pfad unzulässig
  453. - nicht genügend Speicher vorhanden
  454. - Fehler beim lesen/schreiben des Quell-/Zielfiles
  455. - Angabe der unkorrekten Zeile der Wandlungstabelle
  456.  
  457. ACHTUNG !!! Die mit *) gekennzeichneten Fehlermeldungen werden bei
  458. der Benutzung der Intuition-Oberfläche >NICHT< gemacht !!!
  459.  
  460.  
  461. Tips zum Wandeln:
  462. *****************
  463.  
  464. Um längere Texte zu wandeln ist es ratsam diese ins RAM zu kopieren, sofern
  465. dieser groß genug ist, und die Texte von dort aus wandeln zu lassen, da die
  466. Zugriffsgeschwindigkeit   der   Laufwerke   auf   Diskette   nicht   gerade
  467. überwältigend ist.
  468.  
  469. Die   Switches  kann  man  an  beliebiger  Stelle  setzen!   Lediglich  die
  470. Reihenfolge   der  QUELL-File-,  ZIEL-File-  und  Tabellen-File  Namen  muß
  471. eingehalten werden!
  472.  
  473.  
  474. Bekannte Fehler:
  475. ****************
  476.  
  477. Wie immer: KEINE BEKANNT
  478.  
  479. Die  groben  BUG's  werden  vor  Ausgabe der neusten Version immer behoben.
  480. Meist  sind  es  jedoch  die  kleinen,  fiesen, die man erst durch längeres
  481. Arbeiten mit dem Text-Wandler erkennt.
  482.  
  483. Trotzdem  versuche  ich  die  erkannten  Fehler  sofort aus dem Programm zu
  484. entfernen!
  485.  
  486.  
  487.  
  488. Wichtige Informationen:
  489. ***********************
  490.  
  491.   Es wird weder eine Garantie für die vollständige Funktionsfähigkeit, noch
  492.   die juristische Verantwortung oder irgendeine Haftung für Folgen, die auf
  493.   fehlerhafte  Angaben  bzw.   die  Benutzung  des  Programms  zurückgehen,
  494.   übernommen.  Sie nutzen diese Software auf eigenes Risiko!
  495.  
  496.   Bitte    >ausschließlich<    ASCII-Text-Dateien   mit   diesem   Programm
  497.   konvertieren, da es ansonsten zu Abstürzen kommen kann!
  498.  
  499.  
  500. Falls Fehler auftreten:
  501. ***********************
  502.  
  503. Dann  bitte  an  mich  eine Message mit möglichst genauem Fehler-Report per
  504. ZERBERUS-Netz    an    SYSOP@CHIEMGAU.zer.sub.org,    per    INTERNET    an
  505. mail061@fh-rosenheim.de oder an folgenden Adresse:
  506.  
  507. Kai Seidel
  508. Traunsteiner Str. 19
  509. 83355 Grabenstaett
  510. GERMANY
  511.  
  512. oder per Telefon: +49 (0)8661 8087 (privat)
  513.           +49 (0)8661 8104 (Mailbox - 24h Online; 1200-33600 Baud)
  514.  
  515. Wenn  Du  Verbesserungsvorschläge hast, dann schreib mir doch, ruf mich an,
  516. oder  schreib  mir  ne Nachricht übers Z-NETZ an SYSOP@CHIEMGAU.zer.sub.org
  517. oder per INTERNET an mail061@fh-rosenheim.de.
  518.  
  519.  
  520. Einschränkungen der SHAREWARE Version:
  521. **************************************
  522.  
  523. Die   Routine,   die  unbenuzte  Spaces  am  Zeilenende  löscht,  kann  nur
  524. AMIGA-Texte korrekt wandeln.  Ebenso werden NUR Spaces gelöscht, nicht aber
  525. Tabulatoren!  Das "ß" wird bei der Option "-c" nicht mitgewandelt.
  526.  
  527. Beim  Aufruf  unter  Intuition  ist  eine  Art  Nerv-Requester  in Form der
  528. Shareware-Information eingebaut.
  529.  
  530. Die  Modi  "ANSI-Remove"  und "Wandlungs-Tabelle benutzen" sind nur von der
  531. Intuition-Oberfläche aus abrufbar !
  532.  
  533. Bei  der  Konvertierung  von Texten mit Hilfe von selbsdefinierten Tabellen
  534. werden  maximal  32 Zeichen eingelesen !  Deshalb bitte nicht wundern, wenn
  535. der  Textwandler  beim  Parsen  einen  Fehler  ausgibt!  Folgende Zeile ist
  536. möglich:
  537.  
  538. "ä"="ae";"ö"="oe";"ü"="ue";
  539.  
  540. Das sind 28 Zeichen, was zum Testen vorerst ausreichen sollte!
  541.  
  542. Diese Einschränkungen sind in der VOLLVERSION natürlich aufgehoben.
  543.  
  544.  
  545. SHAREWARE-GEBÜHR/REGISTRIERUNG:
  546. *******************************
  547.  
  548. Solltest du an dem Programm Gefallen finden oder du es öfter benutzen, dann
  549. fände  ich  es  fair,  mir 15,- DM für die registrierte Version zukommen zu
  550. lassen.
  551.  
  552. Für  die  Registrierung  drucke  bitte das File "Registrierung.TXT" aus und
  553. schicke  es  mir  ausgefüllt  an die angegebene Adresse.  Solltest du keine
  554. Druckmöglichkeit    haben,    dann    schreibe    die   Adresse,   Tel-Nr.,
  555. Computerkonfiguration  und  gewünschte Zahlungsart auf einen Zettel, den Du
  556. mir  dann  zusendest.   Für  Überweisungen  benutze  bitte  die  angegebene
  557. Konto-Nr.  im Registrierungsformular.
  558.  
  559. Bisher  registrierte Benutzer müssen nichts draufzahlen !!!  Sie haben also
  560. den  Vorteil  durch  ihre frühe Registrierung immer die aktuellen Versionen
  561. umsonst zu bekommen!
  562.  
  563. Du  bist  dann  berechtigt, immer die neuste Version nutzen zu dürfen!  Die
  564. NEUSTE  VERSION  bekommst  Du  von  mir  entweder  in  meiner Mailbox (Tel.
  565. 08661-8104   24h),   oder  Du  schickst  mir  einen  frankierten,  an  Dich
  566. adressierten  Rückumschlag  MIT  Diskette,  den ich umgehend mit der neuen,
  567. registrierten Text-Wandler-Version zurücksende!
  568.  
  569.  
  570. Verbreitungs- & Copyright-Hinweise:
  571. ***********************************
  572.  
  573. Betrifft nur die SHAREWARE-Version:
  574.  
  575.  Das  Programm  darf  NUR  in  Verbindung  mit  dieser  Anleitung  und  dem
  576.  Registrierungsformular    für   eine   Höchstgebühr   von   4,-   DM   für
  577.  Bearbeitungs-/Kopiergebühren weitergegeben werden!
  578.  
  579.  Diese Shareware-Version darf von jeder PD-Serie aufgenommen werden.
  580.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  581.  
  582. Betreffend der VOLLVERSION (=registrierte Version):
  583.  
  584.  Die  registrierte  Version  darf  NICHT  weitergegeben  oder auf PD-Serien
  585.  angeboten  werden!   Ebenso  ist es den REGISTRIERTEN Benutzern untersagt,
  586.  ihre Version an Dritte weiterzugeben!
  587.  
  588.  Die Req.Library ist Copyrighted von Colin Fox und Bruce Dawson!
  589.  
  590.  Die ReqTools.Library ist Copyrighted von Nico François!
  591.  
  592.  
  593. Speziellen Dank:
  594. ****************
  595.  
  596.  ...    an  meinen  Bruder  Roger  und  seinen  Freund  für  die  englische
  597.         Übersetzung und das Korrekturlesen der Dokumentation!
  598.  
  599.  ...    an   Ralph   Babel   und   Garry   Glendown   für   die  Hilfe  bei
  600.         programmtechnischen Fragen!
  601.  
  602.  ...    an Colin Fox und Bruce Dawson für ihre großartige req.library!
  603.  
  604.  ...    an Nico François für seine spitzen ReqTools.library!
  605.  
  606.  ...    und an  Commodore für die Produktion dieses Superrechners, denn nur
  607.         AMIGA macht's möglich !!!
  608.  
  609.  
  610. Entwicklungs-Phasen:
  611. ********************
  612.  
  613. V1.0    Erste Version vom 25.4.92
  614. V1.1    Version vom 1.5.92
  615.     -Unterstützung von Filenamen mit Leerzeichen durch Angabe mit
  616.      Anführungszeichen eingebaut
  617.     -Test, auf zwei gleiche Filenamen eingebaut
  618. V1.2    Version vom 3.7.92
  619.     -Schweren BUG beim Wandeln in Richtung IBM-Format entfernt!
  620.     -Speicher-Allokier-Routine verschoben -> noch kürzere Wandlungs-
  621.      zeiten!
  622.     -Zusätzliche Optimierungen vorgenommen (beq.s, moveq ect.)
  623. V1.2a   Version vom 6.7.92
  624.     -Falschen USAGE-Text berichtigt
  625. V1.3    Version vom 11.7.92
  626.     -Wandel-Puffer wurde auf 16384 heruntergesetzt.
  627.     -Weiteren Wandel-BUG behoben; Probleme gab's beim Wandeln von
  628.      IBM-Texten ins AMIGA-Format. Die Returns ($0d0a), die durch den
  629.      Puffer von 16384 getrennt werden, werden jetzt auch richtig
  630.      gewandelt!
  631.     -Weitere Optimierungen vorgenommen; Die Anzahl der Lade-Bytes und
  632.      der Bytes, die gespeichert werden, ist gleich -> SUPERKURZE
  633.      Wandlungszeiten auch von Festplatte auf Festplatte!
  634.     -BUG, der ein einwandfreies Funktionieren unter Kick 1.2/1.3
  635.      verhindert, in letzter Minute entfernt.
  636. V1.4    Version vom 21.7.92
  637.     -Zusätzliche Sonderzeichen werden, neben den Umlauten, jetzt auch
  638.      gewandelt (siehe oben).
  639. V1.5    Version vom 24.7.92
  640.     -Die Verwechslung des Zeichens "ª" mit "|" in der Version 1.4 wurde
  641.      berichtigt (ist für die Konvertierung von z.B. C-Sourcen wichtig).
  642.     -Bei Angabe eines Directories statt dem Ziel-Namen, wird der Text
  643.      mit dem Quell-Namen dorthin konvertiert.
  644.     -Sicherheitsabfrage bei bereits existierenden Ziel-File eingebaut.
  645.     -Neuen Switch (-o) eingebaut, der die Sicherheitsabfrage auf Exis-
  646.      tenz eines Files mit gleichem Namen wie der Ziel-File-Name, ab-
  647.      schaltet.
  648.     -Ohne Angabe eines Switches wird der Text nun ins MS-DOS-Format
  649.      konvertiert.
  650. V1.6    Version vom 11.8.92  PROGRAMMLÄNGE: 4756 Bytes
  651.     -Optimierungen vorgenommen -> kürzerer Code!
  652.     -Der Wandler ist nun mit CTRL-C abbrechbar !
  653.     -Eine Anzeige, um die aktuelle Zahl der bereits gewandelten Bytes
  654.      auszugeben, wurde eingebaut; sie läßt sich mit dem -n Switch
  655.      abschalten.
  656.     -Neuer Switch, um unnötige Spaces bzw. Tabs am Zeilenende zu
  657.      entfernen, eingebaut.
  658. V1.7    Version vom 13.8.92  PROGRAMMLÄNGE: 5160 Bytes
  659.     -Beim Wandeln ins AMIGA-Format wurde das 1. Zeichen des Textes
  660.      überlesen. Dieser Bug wurde entfernt!
  661.     -Mit der -c Option werden Umlaute wie z.B. >Ö< in >Oe< gewandelt.
  662. V2.0    Version vom 10.9.92  PROGRAMMLÄNGE: 11280 Bytes
  663.     -Komplette, mausorientierte Intuitionoberfläche hinzugefügt
  664.      -> alles per Maus steuerbar !
  665. V2.1    Version vom 23.9.92  PROGRAMMLÄNGE: 11864 Bytes
  666.     -Bug beim Wandeln von MS-DOS-Text in Amiga-Text entfernt:
  667.      IBM-Return wird auf 0x0d0a jetzt getestet!
  668.     -ANSI-Remover eingebaut. Lästige ANSI-Sequenzen können nun pro-
  669.      blemlos entfernt werden!
  670. V2.2    Version vom 22.11.92 PROGRAMMLÄNGE: 13248 Bytes
  671.     -Unter Kickstart 1.x funktionierte das String-Gadget nicht korrekt.
  672.      Bug behoben!
  673.     -Wandlungsrichtung für ATARI-ASCII-Texte mit implementiert!
  674.     -Versions-String eingebaut - Damit läßt sich jetzt auch mit dem
  675.      CLI/SHELL-Befehl "VERSION Text-Wandler" die aktuelle Version des
  676.      Text-Wandlers abfragen.
  677.     -Der USAGE-Text (beim Aufruf mit "?") wird nun in 12'er Zeilen
  678.      ausgegeben und auf die RETURN-Taste gewartet.
  679. V2.2a   Version vom 30.11.92 PROGRAMMLÄNGE: 13256 Bytes
  680.     -Mehrere Bugs wurden behoben:
  681.      + Der ANSI-Remover funktioniert jetzt wieder !
  682.      + Bei der Frage, ob das schon vorhandenen Ziel-File überschrie-
  683.        ben werden soll, wurde bei Eingabe von "J" oder "N" + RETURN
  684.        das Return ueberlesen!
  685. V2.3    Version vom 06.12.92 PROGRAMMLÄNGE: 13248 Bytes
  686.     -Das "STOP"-Gadget lief nicht ordnungsgemäß! Der Computer ist
  687.      daraufhin immer abgestuerzt ! Bug behoben!
  688.     -Zu lange ANSI-Sequenzen wurden nicht herausgefiltert! Auch dieser
  689.      Bug wurde behoben !
  690. V3.0    Version vom 15.1.93 PROGRAMMLÄNGE: 20764 Bytes
  691.     -OS 2.x Benutzeroberfläche eingebaut!
  692.     -Option zum Wandeln mit eigener Tabelle eingebaut!
  693.     -String-Gadget-Bug unter Kick/WB 1.2/1.3 behoben!
  694. V3.1    Version vom 22.2.93 PROGRAMMLÄNGE: 21128 Bytes
  695.     -Der Usage-Text paßt sich nun der Fensterhöhe an. D.H. die Ausgabe
  696.      stoppt automatisch, wenn das Fenster voll ist.
  697.     -Unter der Intuition-Oberfläche waren einige Wandlungsarten ver-
  698.      tauscht! Fehler behoben!
  699. V3.5    Version vom 27.3.94 PROGRAMMLÄNGE: 23576 (Deutsche Version)
  700.                        23132 (Englische Version)
  701.     -Ab sofort gibt es eine Deutsche und eine Englische Version!
  702.     -Die Wandlungstabelle darf jetzt neben HEX- auch Dezimalzahlen
  703.      und Strings enthalten
  704.     -Es werden jetzt nicht mehr Zeichen 1:1 über die Tabelle gewandelt,
  705.      sondern beliebig viele Zeichen können zu beliebig vielen kon-
  706.      vertiert werden!
  707. V3.6    Version vom 21.5.94 PROGRAMMLÄNGE: 23948 (Deutsche Version)
  708.                        23500 (Englische Version)
  709.     -Das "ß" wurde in "us" gewandelt !!! Bug behoben
  710.     -Das CLI-Window wird nun auf RAW geschaltet, damit lassen sich
  711.      bei der Abfrage auch einzelne Zeichen lesen!
  712.     -Wird die Ausgabe beim CLI-Aufruf auf ein File umgeleitet, wird
  713.      ein evtl. vorhandenes Zielfile trotzdem ueberschrieben (fuer
  714.      automatisierte Aufrufe, z.B. beim Einsatz in Mailboxen)
  715. V3.7    Version vom 09.10.94 PROGRAMMLÄNGE: 23604 (Deutsche Version)
  716.                         23112 (Englische Version)
  717.     -Tabellen-Wandlungs-Routine erheblich verbessert!
  718.     -Allgemeiner konvertierungs-Bug behoben
  719. V3.8    Version vom 06.08.95 PROGRAMMLÄNGE: 24732 (Deutsche Version)
  720.                         24244 (Englische Version)
  721.     -Einstellungen werden beim Verlassen des Programms nun temporär
  722.      gespeichert und bei erneutem Programmstart wieder geladen
  723.     -Beim anwählen der Files durch den Filerequester wurde immmer
  724.      der letzte Filepfad benutzt; Jeder der 3 Filerequester besitzt
  725.      nun seinen eigenen Filepfad
  726.     -Das Anwählen der nicht benutzten Gadgets beim Konvertieren OHNE
  727.      eigene Tabelle ist jetzt unterdrückt
  728. V3.9    Version vom 03.10.95 PROGRAMMLÄNGE: 24928 (Deutsche Version)
  729.                         24424 (Englische Version)
  730.     -Bei der Anwahl einer neuen Wandlungstabelle im WB-Modus wurde
  731.      diese nicht richtig bearbeitet! Bug behoben
  732.     -Vollversion: Unter Kickstart 1.3 wurde bei zu langem Namen
  733.      (der registrierten Person) der Text über den Fensterrahmen
  734.      hinaus geschrieben. Zeile ist jetzt in zwei Teile geteilt
  735.      worden
  736.     -Im WB-Modus werden jetzt in der Status-Zeile mehr Informations-
  737.      Texte ausgegeben
  738.     -Ein paar kleinere Textfehler ausgebessert ('für' statt 'fuer'
  739.      etc.)
  740.     -Ab Kick2.x: Im WB-Modus wird bei vorhandenem Ziel-File jetzt
  741.      ein Requester geöffnet, in dem gefragt wird ob das File über-
  742.      schrieben werden soll
  743.     -Ab Kick2.x: Wird im WB-Modus als Zielfilename nur ein Pfad
  744.      angegeben, so öffnet sich ein Requester, der den Pfad des
  745.      Zielfiles und den Quellfilenamen enthält und nachfrägt, ob
  746.      dieser benutzt werden soll
  747.     -Tabelle wird nach dem decodieren im Speicher jetzt sortiert;
  748.     -In der Tabelle wurde eine dezimale Null nicht anerkannt!
  749.     -Die Routine welche die Fenster-Struktur des CLIs holt, brachte
  750.      unter ENFORCER immer einen Fehler. Bug behoben.
  751.