@DATABASE Text-Wandler
@INDEX uebersicht
@REMARK $VER: Text-Wandler V3.9 (03.10.95)
@NODE MAIN "Text-Wandler V3.9 Online-Hilfe"



                           @{b}Text-Wandler V3.9@{ub}
                         <><><><><><X><><><><>
                      © 1992-1995 von Kai Seidel


                                Inhalt:

· @{" Einführung             " link ein}

· @{" Copyright              " link copyright}

· @{" System Voraussetzungen " link system}

· @{" Installation           " link install}


Programmaufruf & -benutzung:
    @{" Kickstart/Workbench 1.2/1.3 " link kick1x}
    @{" Kickstart/Workbench 2.x/3.x " link kick2x}
    @{" CLI/SHELL-Aufruf            " link aufruf}

    @{" Die Wandlungstabelle " link wandlung}

    @{" Beispiele         " link beispiel}
    @{" Fehlermeldungen   " link fehler}
    @{" Tips zum Wandeln  " link tips}
    
    @{" Registrierung     " link regist} - @{b}Hinweise zur Registrierung@{ub}
    @{" Updates / Support " link update} - Wo gibt es Updates & Support?

    @{" Einschränkungen der SHAREWARE Version " link einschraenkung}
    @{" Entwicklungs-Phasen                   " link entwicklung}
    @{" WICHTIGE INFORMATIONEN                " link wichtig}

@{" Speziellen Dank an ..." link speziellen}
@ENDNODE
@NODE ein "Einführung in den Text-Wandler"

@{b}Ein bißchen Theorie:@{ub}


Da  ich  neben  meinem  Amiga noch einen MS-DOS Rechner für die Bearbeitung
meiner  Mailbox-Programme  & Texte habe, ist es immer lästig, daß die AMIGA
ASCII-Tabelle  nicht  mit  der  IBM-Tabelle übereinstimmt.  Die AMIGA-Texte
sind  auf  einem MS-DOS Rechner (fast) nicht lesbar.  Aus diesem Grund habe
ich  mich  entschlossen  einen  Text-Wandler  zu  schreiben,  der die Texte
zwischen  beiden  ASCII-Formaten  umwandelt.   Ebenso sind die unterschied-
lichen  Zeilenenden  zwischen  MS-DOS  und  AMIGA  ein  Problem.  Der AMIGA
benutzt  ein  $0a  (=Zeilenvorschub)  und  der  MS-DOS  Rechner  ein  $0d0a
(=Wagenrücklauf + Zeilenvorschub) für das Zeilenende.


@{b}Zum Programm:@{ub}


Mein  Programm  behebt  diese  Problematik.   Es  ist in 100% Assembler ge-
schrieben  und nutzt somit die VOLLE Rechnergeschwindigkeit aus.  Es werden
immer  16KByte  (=16384  Bytes) von dem zu wandelnden Text-File eingelesen,
umgewandelt und wieder unter dem neuen Namen abgespeichert.  Es werden aber
nicht  nur  16KByte Speicher vom Programm allokiert.  Insgesamt sollten ca.
80  KByte  an RAM-Speicher frei sein.  (Fast?) Alle Fehleingaben werden vom
Programm  abgefangen.  Um eine möglichst hohe Geschwindigkeit zu erreichen,
wurden  im  Programm  8 (acht) voneinander getrennte Routinen, zwei für die
Umwandlung  von  Texten  zwischen MS-DOS und Amiga, ebenfalls zwei, für die
Konvertierung   von   Texten   zwischen  Amiga  und  Atari,  eine  für  die
Konvertierung  in  normale  ASCII-Zeichen  (Ä=Ae),  eine für die Entfernung
unbenutzter  Space-  oder Tabulatorzeichen, eine zum Entfernen von lästigen
ANSI-Sequenzen   und  eine  zum  Benutzen  einer  eigenen  Wandlungstabelle
integriert.   Ebenfalls  sind drei komplette ASCII-Tabellen im Programm mit
drin,  die  es  problemlos  ermöglichen,  auch andere Zeichen als >ÄÖÜäöüß<
umzuwandeln.   Das  Programm besitzt ab Version 2.0 einen STARTUP-Code.  Es
kann  seither  also  sowohl  vom  CLI/SHELL  als auch von der Workbench aus
genutzt werden!

Der Text-Wandler konvertiert seit der Version 1.4 folgende Sonderzeichen:

   ÄÖÜäöüߢ£¡¤¥§ª«¬­°±²µ¶º»¼½¿ÅÆÇÉÑàáâåæçèéêëìíîïñòóôøúûÿ

Diese  Zeichen  werden  in beide Wandlungs-Richtungen korrekt transferiert.
Leider  sind das auch die einzigen Sonderzeichen, die sowohl in der MS-DOS-
und der AMIGA-ASCII-Tabelle vorhanden sind.

Den   Wandlungsablauf   kann   man   mit   der  Tastenkombination  >CTRL-C<
(=Control-Taste  +  C  gleichzeitig)  abbrechen  bzw.  im Fenster-Modus mit
einem Druck auf das Stop-Gadget.

Während des Wandlungs-Ablaufes wird die aktuelle Position der Text-Position
angegeben.
@ENDNODE
@NODE copyright "Verbreitung- & Copyright-Hinweise"

@{b}Verbreitungs- & Copyright-Hinweise:@{ub}

Betrifft nur die SHAREWARE-Version:

 Das  Programm  darf  NUR  in  Verbindung  mit  dieser  Anleitung  und  dem
 Registrierungsformular    für   eine   Höchstgebühr   von   4,-   DM   für
 Bearbeitungs-/Kopiergebühren weitergegeben werden!

 Diese Shareware-Version darf von jeder PD-Serie aufgenommen werden.
 ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

Betreffend der VOLLVERSION (=registrierte Version):

 Die  registrierte  Version  darf  NICHT  weitergegeben  oder auf PD-Serien
 angeboten  werden!   Ebenso  ist es den REGISTRIERTEN Benutzern untersagt,
 ihre Version an Dritte weiterzugeben!

 Die Req.Library ist Copyrighted von Colin Fox und Bruce Dawson!

 Die ReqTools.Library ist Copyrighted von Nico François!


 Weitere @{" WICHTIGE INFOS ... " link wichtig}
@ENDNODE
@NODE system "Voraussetzungen an das System"

@{b}Voraussetzungen an das System:@{ub}

Eigentlich  keine  großen.   Der Text-Wandler müßte mit jeder Konfiguration
laufen.  Voraussetzung ist allerdings @{"Kickstart" link kick} 1.2 oder höher!

Kickstart/WB 2.x (Intuition/Gadtools V37 oder höher):

  Für  den  Filerequester wird die >ASL.LIBRARY< benötigt.  Diese MUSS sich
  im   "LIBS:"   Verzeichniss   der   Bootdiskette   befinden.    Sie  wird
  normalerweise ab Workbench 2.x mitgeliefert!

Kickstart/WB 1.2/1.3:

  Für den Filerequester wird die >REQ.LIBRARY< benötigt.  Sollte sich diese
  nicht   im  Archiv  befinden,  sollte  man  mal  auf  den  Fish-Disketten
  nachsehen.  Diese Library muß vor dem Start in das LIBS:  Verzeichnis der
  Workbench  Diskette  bzw.   der  Boot-Partition  kopiert werden!  Ist sie
  nicht vorhanden, kann der Text-Wandler im Workbench-Modus nicht gestartet
  werden (entsprechende Fehlermeldung wird ausgegeben)!
@ENDNODE
@NODE install "Installation"

@{b}Installation:@{ub}

Man kopiere die Dateien

	Text-Wandler
    und Text-Wandler.info

in  ein  beliebiges  Verzeichnis und starte das Programm von der SHELL oder
Workbench aus.
@ENDNODE
@NODE kick1x "Kickstart/Workbench 1.2/1.3"

@{b}Die Benutzung unter Kickstart/Workbench 1.2/1.3@{ub}

Die  Shareware-Version  öffnet zuerst ein INFO-Window.  Das Window kann man
mit   einem   Click   auf   dessen   CLOSE-Gadget  (=Schließ-Schalter)  zum
Verschwinden  bringen.   Es  erscheint  nun  das  eigentliche  Text-Wandler
Fenster mit folgenden Gadgets:

- Quell-Datei wählen

  Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  Req.library.   Mit  diesem  kann  man  sich  nun  bequem  per Maus den zu
  wandelnden Text aussuchen.

- Gadget rechts neben >Quell-Datei wählen<

  Dies  ist  ein  sog.   String-Gadget.   Wenn  man  per  Filerequester die
  Text-Datei  gewählt  hat, erscheint hier der komplette Filename inclusive
  Pfad.   Hier kann man auch per Hand die Eingabe machen, indem man auf das
  Gadget clickt.

- Ziel-Datei wählen

  Hier kann wieder per Filerequester der Dateiname des fertig konvertierten
  Files gewählt werden.

- Gadget rechts neben >Ziel-Datei wählen<

  Hier wieder das zugehörige String-Gadget für den Ziel-Datei-Name + Pfad.

- Tabelle wählen

  Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  Req.library.   Mit  diesem  wählt  man  die Wandlungs-Tabelle (dazu unten
  mehr).

- Gadget rechts neben >Tabelle wählen<

  Hier  wieder  das zugehörige String-Gadget für den Dateinamen bzw.  -Pfad
  der Tabelle.

- Gadget rechts neben >MODUS<

  Hier kann der gewünschte Modus eingestellt werden, mit dem der Quell-Text
  behandelt werden soll.

- OK bzw. STOP

  Wurde  Quell-  und  Ziel-Datei sowie der entsprechende Modus eingestellt,
  kann   man   mit  OK  den  Konvertierungsvorgang  starten.   Während  des
  Konvertierens  wird  das  OK-Gadget zum STOP-Gadget.  Man kann also durch
  click auf das Stop-Gadget die Konvertierung abbrechen.


Neben  >Position:<  erscheint  während der Konvertierung immer die aktuelle
Text-Position, an der der Wandler momentan arbeitet.

Treten Fehler auf, so werden diese bei >Status< ausgegeben.
@ENDNODE
@NODE kick2x "Kickstart/Workbench 2.x/3.x"

@{b}Die Benutzung unter Kickstart/Workbench 2.x/3.x@{ub}

Der Text-Wandler  öffnet  einen  Screen  im aktuellen Darstellungsmodi der
Workbench   (PAL/NTSC).    Dazu   ein   Window,  in dem  die  Gadgets  und
Filerequester  dargestellt werden.  Die Shareware-Version öffnet zuerst ein
INFO-Window.    Das   Window   kann   man   mit   einem  Click  auf  dessen
"WEITER"-Gadget zum Verschwinden bringen.

Das Text-Wandler Fenster enthält folgende Gadgets:

- Quell-Datei wählen

  Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  Req.library.   Mit  diesem  kann  man  sich  nun  bequem  per Maus den zu
  wandelnden Text aussuchen.

- Gadget rechts neben >Quell-Datei wählen<

  Dies  ist  ein  sog.   String-Gadget.   Wenn  man  per  Filerequester die
  Text-Datei gewählt hat, erscheint hier der komplette Filename inclusive
  Pfad.   Hier kann man auch per Hand die Eingabe machen, indem man auf das
  Gadget clickt.

- Ziel-Datei wählen

  Hier kann wieder per Filerequester der Dateiname des fertig konvertierten
  Files gewählt werden.

- Gadget rechts neben >Ziel-Datei wählen<

  Hier wieder das zugehörige String-Gadget für den Ziel-Datei-Name + Pfad.

- Tabelle wählen

  Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  Req.library.   Mit  diesem  wählt  man  die Wandlungs-Tabelle (dazu unten
  mehr).

- Gadget rechts neben >Tabelle wählen<

  Hier  wieder  das zugehörige String-Gadget für den Dateinamen bzw.  -Pfad
  der Tabelle.
  Ist  das  MODUS-Gadget nicht auf "Wandlungstabelle benutzen" eingestellt,
  so ist dieses String-Gadget, sowie dasjenige zum Auswaehlen des Files mit
  dem Filerequester abgeschaltet.

- Gadget unterhalb >MODUS<

  Hier kann der gewünschte Modus eingestellt werden, mit dem der Quell-Text
  behandelt werden soll.

- Start/Stop

  Wurde  Quell-  und  Ziel-Datei sowie der entsprechende Modus eingestellt,
  kann  mit  "Start/Stop"  der  Konvertierungsvorgang getartet werden.  Man
  kann  also  durch nochmaligen click auf das Stop-Gadget die Konvertierung
  abbrechen.


Neben  >Position:<  erscheint  während der Konvertierung immer die aktuelle
Text-Position, an der der Wandler momentan arbeitet.

Treten @{"Fehler" link Fehler} auf, so werden diese bei >Status< ausgegeben.

Mit  dem Close-Gadget des Windows wird das Programm beendet.  Die aktuellen
Einstellungen,  wie  Konvertierungs-Modus,  File-Pfade  &  Namen, werden im
ENV:-  Verzeichniss  temporär  gespeichert.   Das  File  das angelegt wird,
lautet  "tw.tmp" und wird beim nächsten Aufruf wieder eingeladen.  Wird ein
Reset ausgelöst, wird dieses File gelöscht.
Will  man  seine  Grundeinstellung dauerhaft speichern, so muß das File vom
ENV:- in das ENVARC:-Verzeichniss kopiert werden.
@ENDNODE
@NODE aufruf "CLI/SHELL-Aufruf" 

CLI/SHELL-Aufruf:

Text-Wandler [-i/-a/-m/-t/-s/-c/-u/-r/-z]
	     [-o] [-n] <Quell-Datei> <Ziel-Datei> [Tabelle]

<> Argumente
[] Optionen

ARGUMENTE:

Die  Argumente  <Quell-Datei>  und  <Ziel-Datei>  MÜSSEN  angegeben werden!
Ausgenommen  ist  die  Anwahl  der  "-u" Option, mit der man die Intuition-
Oberfläche  aufruft!   Andernfalls  bekommt  man  vom Programm eine Fehler-
meldung.  Die Reihenfolge MUß ebenfalls eingehalten werden.

Besitzt  ein  File-Name  ein  Leerzeichen,  so muß der gesamte File-Name in
Anführungszeichen stehen!  (siehe Beispiele unten)

Man  kann  zusätzlich statt dem Ziel-Dateinamen auch einen Pfad angeben, in
den die Quell-Datei, und mit dem Quell-Dateinamen, konvertiert wird.


OPTIONEN:

 Von den folgenden neun Optionen kann jeweils immer nur EINE gewählt
 werden:

-i  Der  Text  ist  im  AMIGA-ASCII-Format und soll ins MS-DOS-ASCII-Format
    inclusive Sonderzeichenwandlung konvertiert werden.

-a  Der  Text  ist  im  MS-DOS-ASCII-Format und soll ins AMIGA-ASCII-Format
    inclusive Sonderzeichenwandlung konvertiert werden.

-t  Der  Text  ist im AMIGA-ASCII-Format und soll ins ATARI-ST-ASCII-Format
    inclusive Sonderzeichenwandlung konvertiert werden.

-m  Der  Text  ist im ATARI-ST-ASCII-Format und soll ins AMIGA-ASCII-Format
    inclusive Sonderzeichenwandlung konvertiert werden.

-s  Der  Text ist  entweder  im AMIGA-ASCII-  oder  im MS-DOS-ASCII-Format.
    Aus   diesem  Text  werden  nun  alle  überflüssigen  Leerzeichen  oder
    Tabulatoren  (siehe  Einschränkungen  der  SHAREWARE  Version)  aus dem
    Quelltext entfernt.

-c  Die  im  AMIGA-Text  (!)  enthaltenen  Umlaute  wie ÄÖÜ etc.  werden in
    gewöhnliche ASCII-Zeichen umgewandelt.  Z.B.  >Ä< wird zu >AE<.

-u  Der  Text-Wandler springt in den Workbench-Modus.  D.h.  es öffnet sich
    ein Fenster, in dem man sämtliche Optionen per Maus anwählen kann!

-r  ANSI-Sequenzen werden hiermit aus AMIGA-Texten herausgelöscht.

-z  Benutzt  für den Wandlungsablauf eine Eigene Tabelle.  Ist diese Option
    angewählt,  MUSS  als  dritter  Filename  der Name der Wandlungstabelle
    stehen ([Tabelle])!  Siehe Einschränkungen der SHAREWARE Version!

  Wird  keiner  der  oben  angegebenen  OPTIONEN  gewählt, so wird der Text
  automatisch ins MS-DOS-Format konvertiert.

 Die restlichen zwei Optionen können, müssen aber nicht angegeben werden:

-o  Wenn  ein File mit demselben Namen des angegebenen Ziel-Filenamen schon
    existiert,  so wird bei dieser Option keine Sicherheitsabfrage gemacht,
    ob das File überschrieben werden darf.

-n  Schaltet die  Anzeige für die aktuelle  Textposition des Wandelvorgangs
    ab (spart ein paar Zyklen).
@ENDNODE
@NODE wandlung "Wandlungstabelle"

@{b}Die Wandlungstabelle:@{ub}

Hier  ist nun die Text-Wandler Version, auf die viele Leute gewartet haben!
Ab  Version  3.0  kann der Text-Wandler in sekundenschnelle jeden Text nach
Belieben verunstalten.  Doch nun konkret:

Die  CLI/SHELL-Option  "-z"  bzw.   der  Wandlungs-Modus  "Wandlungstabelle
benutzen"  benötigen  eine  sog.   Wandlungs-Tabelle.   Diese hat folgendes
Aussehen:

"abc"="def"; /* gewandelt wird >abc< in >def< */
34,"Hallo",34=">Helau<"; // Hier wird "Hallo" in >Helau< konvertiert
$0a=$0d,$0a; /* Das Amiga-Linefeed wird durch MS-DOS Carriage Return
		und Linefeed ersetzt */
.....
.
.
usw.

Es dürfen Strings, Hex- und Dezimalzahlen angegeben werden.  Strings müssen
in   Anführungszeichen   gesetzt   werden   und   Hexzahlen  benötigen  ein
Dollarzeichen vor der Zahl.

Das   'Istgleichzeichen'   "="   trennt   die  beiden  Zeichen(folgen)  die
konvertiert werden sollen.  Am Ende benötigt der Text-Wandler ein Semikolon
";" um das Ende einer Definition zu markieren.

Kommentare  sind nun auch möglich.  Entweder normale C- oder C++ Kommentare
dürfen  angegeben  werden, wobei erstere mit der Zeichenfolge "/*" beginnen
und  mit  "*/"  Enden.   C++ Kommentare beginnen mit "//" und Enden mit dem
Zeilenende !

Zum genaueren Verständnis ein paar Beispiele:

Der  Buchstabe  "a"  (klein  a)  soll  im Text in ein GROSSES "A" gewandelt
werden.  Dazu kann man folgende Kombinationen benutzen:

  $61=$41;
   oder
  "a"="A";
   oder
  97=$41;
   etc.

Die Zeichen "-" und "+" sollen miteinander vertauscht werden:

  $2B=$2D;
  $2D=$2B;
   oder
  "-"="+";
  "+"="-";
   etc.

Alle Leerzeichen sollen mit einem "_" ersetzt werden:

  $20=$5F;
   oder
  32="_";

Jedes "!" soll eliminiert werden:

  "!"=;


Natürlich  kann  man  sich  hiermit eine ganz eigenen ASCII-Zeichensatz zu-
sammenstellen.
@ENDNODE
@NODE beispiel "Beispiele"

@{b}BEISPIELE:@{ub}

Zur Veranschaulichung ein paar Beispiele:

1.  Text  auf Disk in DF0:  Namens "Test.txt" ist im AMIGA-Format  und soll
    ins  MS-DOS-Format konvertiert werden.  Dabei soll der Fertige ins RAM:
    unter dem Namen "Hallo.txt".  Dazu ist folgender Aufruf nötig:

   Text-Wandler -i DF0:Test.txt RAM:Hallo.txt

2.  Text  auf  Festplatte DH0:  Namens "Guten Tag.TXT" ist  im AMIGA-Format
    und  soll  ins MS-DOS-Format auf den Datenträger DF2:  mit dem gleichen
    namen konvertiert werden.

   Text-Wandler -i "DH0:Guten Tag.TXT" DF2:

3.  Text auf Disk in PC0:  Namens "LESEN.TXT" ist im MS-DOS-Format und soll
    ins  AMIGA-Format  auf  Festplatte WORK:  mit dem Namen "Lies Mich.TXT"
    konvertiert  werden.   Eventuell  schon  vorhandenes  File mit gleichem
    Namen ("Lies Mich.txt") darf gelöscht werden.

   Text-Wandler -a-o PC0:LESEN.TXT "WORK:Lies Mich.TXT"

4.  Text  in  RAM:   Namens  "Temp.TXT" im AMIGA- oder  MS-DOS-Format wurde
    gerade   editiert.    Es   sollen   eventuell   vorhandene,  unwichtige
    Leerzeichen  oder  Tabulatoren an den Zeilenenden entfernt werden.  Das
    fertige  File  soll  dann  "RAM:Fertig.TXT"  heißen.   Ebenso  soll die
    Ausgabe   der  aktuellen  Textposition  des  Text-Wandlers  unterdrückt
    werden.

   Text-Wandler -s-n RAM:Temp.TXT RAM:Fertig.TXT

5.  Text  auf  Disk DF2:  Namens "Text-Wandler.DOK" im AMIGA- oder  MS-DOS-
    Format,  besitzt Umlaute.  Diese sollen in Normalbuchstaben auf DISK in
    DF1:  mit Namen "TXTWND.DOK" gewandelt werden.

   Text-Wandler -c DF2:Text-Wandler.DOK DF1:TXTWND.DOK

6.  Man will den Text-Wandler mit der Intuition-Oberfläche starten und  mit
    dieser sämtliche Eingaben machen.

   Text-Wandler -u

7.  Ein  Capture-File  (z.B.   von  JRComm) enthält lästige  ANSI-Sequenzen
    welche  entfernt  werden sollen.  Das File heißt "DF1:Beispiel.CAP" und
    soll ins RAM:  gewandelt werden.

   Text-Wandler -r DF1:Beispiel.CAP RAM:

8.  Ein  Text  soll  nach  eigenem Belieben gewandelt werden.  Dazu hat man
    sich eine eigene Tabelle angelegt (siehe unten), die die Buchstaben und
    Sonderzeichen  einfach vertauscht.  Die Tabelle heißt "t:Tab.tab".  Der
    Text,  der  gewandelt werden soll ist im RAM:  und schreibt sich "Hallo
    Herr XYZ".  Der fertige Text soll in das Verzeichniss T:  mit dem Namen
    "Guten_Tag.TXT".

   Text-Wandler -z "RAM:Hallo Herr XYZ" T:Guten_Tag.TXT t:Tab.tab
@ENDNODE
@NODE fehler "Fehlermeldungen"

@{b}Fehlermeldungen:@{ub}

Für folgende Fehleingaben/Probleme existieren Fehlermeldungen:

- Keine Angaben gemacht
- Falsche/Keine Option(en) angegeben
- Keine oder nur ein Filename wurde angegeben
- Quell- und Ziel-Dateinamen sind gleich *)
- Quell-Datei nicht vorhanden
- Ziel-Datei bereits vorhanden *)
- Ziel-Datei-Pfad unzulässig
- nicht genügend Speicher vorhanden
- Fehler beim lesen/schreiben des Quell-/Zielfiles
- Angabe der unkorrekten Zeile der Wandlungstabelle

ACHTUNG !!! Die mit *) gekennzeichneten Fehlermeldungen werden bei
der Benutzung der Intuition-Oberfläche >NICHT< gemacht !!!

@{b}Falls Fehler auftreten:@{ub}

Dann  bitte  an  mich  eine Message mit möglichst genauem Fehler-Report per
ZERBERUS-Netz      an      SYSOP@CHIEMGAU.zer.sub.org,     per     INTERNET
mail061@fh-rosenheim.de oder an folgenden Adresse:

Kai Seidel
Traunsteiner Str. 19
83355 Grabenstaett
GERMANY

oder per Telefon: +49 (0)8661 8087 (privat)
		  +49 (0)8661 8104 (Mailbox - 24h Online; 1200-33600 Baud)

Wenn  Du  Verbesserungsvorschläge hast, dann schreib mir doch, ruf mich an,
oder  schreib  mir  ne Nachricht übers Z-NETZ an SYSOP@CHIEMGAU.zer.sub.org
oder INTERNET an mail061@fh-rosenheim.de.

@{b}Bekannte Fehler:@{ub}

Wie immer: KEINE BEKANNT

Die  groben  BUG's  werden  vor  Ausgabe der neusten Version immer behoben.
Meist  sind  es  jedoch  die  kleinen,  fiesen, die man erst durch längeres
Arbeiten mit dem Text-Wandler erkennt.

Trotzdem  versuche  ich  die  erkannten  Fehler  sofort aus dem Programm zu
entfernen!

@ENDNODE
@NODE tips "Tips zum Wandeln"

@{b}Tips zum Wandeln:@{ub}

Um längere Texte zu wandeln ist es ratsam diese ins RAM zu kopieren, sofern
dieser groß genug ist, und die Texte von dort aus wandeln zu lassen, da die
Zugriffsgeschwindigkeit   der   Laufwerke   auf   Diskette   nicht   gerade
überwältigend ist.

Die   Switches  kann  man  an  beliebiger  Stelle  setzen!   Lediglich  die
Reihenfolge   der  QUELL-File-,  ZIEL-File-  und  Tabellen-File  Namen  muß
eingehalten werden!
@ENDNODE
@NODE regist "Shareware-Gebühr/Registrierung"

@{b}SHAREWARE-GEBÜHR/REGISTRIERUNG:@{ub}

Solltest du an dem Programm Gefallen finden oder du es öfter benutzen, dann
fände  ich  es  fair,  mir 15,- DM für die registrierte Version zukommen zu
lassen.

Für  die  Registrierung  drucke  bitte das File "@{"Registrierung.TXT"link Re}" aus und
schicke  es  mir  ausgefüllt  an die angegebene Adresse.  Solltest du keine
Druckmöglichkeit    haben,    dann    schreibe    die   Adresse,   Tel-Nr.,
Computerkonfiguration  und  gewünschte Zahlungsart auf einen Zettel, den Du
mir  dann  zusendest.   Für  Überweisungen  benutze  bitte  die  angegebene
Konto-Nr.  im Registrierungsformular.

Bisher  registrierte Benutzer müssen nichts draufzahlen !!!  Sie haben also
den  Vorteil  durch  ihre frühe Registrierung immer die aktuellen Versionen
umsonst zu bekommen!

Du  bist  dann  berechtigt, immer die neuste Version nutzen zu dürfen!  Die
NEUSTE  VERSION  bekommst  Du  von  mir  entweder  in  meiner Mailbox (Tel.
08661-8104   24h),   oder  Du  schickst  mir  einen  frankierten,  an  Dich
adressierten  Rückumschlag  MIT  Diskette,  den ich umgehend mit der neuen,
registrierten Text-Wandler-Version zurücksende!
@ENDNODE
@NODE Re "Registrierung"

  Formular bitte gedruckt und ausgefüllt an folgende Adresse schicken:

                            Kai Seidel
                            Traunsteiner Str. 19
                            83355 Grabenstätt
                            GERMANY

----- 8< ---------------------------------------------------------------------


                       Text-Wandler V3.8 Registrierformular
                       ------------------------------------


   Name:  ___________________________           Datum: ______________________

   Adresse: _________________________________________________________________

      Postleitzahl: ____________ Wohnort: ___________________________________

       Telefon-Nr.: ______________-_______________

     EMail-Adresse: ________________________________________________________

                    ________________________________________________________

                    ________________________________________________________


   Computerkonfiguarion (Computertyp, Ausstattung, Zubehör etc.):

                    ________________________________________________________

                    ________________________________________________________

                    ________________________________________________________


   Woher haben Sie dieses Programm: ________________________________________


                                                        German DM    US$
   Ich möchte:

      X    die registrierte Version des Text-Wandlers.....15.00     10.00

      o    Ich schicke eine Diskette mit, damit die
           registrierte Version des Text-Wandlers
           drauf kopiert wird.............................--.--     --.--

      o    Ich schicke KEINE Diskette mit!.................1.00      1.00

      o    Ich wohne ausserhalb Deutschlands. Um anstehende
           Kosten zu decken füge ich.......................5.00      5.00
           hinzu.

   Ich...
      o    schicke einen Euroscheck.......................--.--     --.--
      o    schicke einen Verrechnungsscheck...............--.--     --.--
      o    schicke das Geld per Post (nur DM oder US $)...--.--     --.--
      o    überweise das Geld bequem per Bank.............--.--     --.--
      o    möchte per Nachname zahlen......................8.00      8.00

                              Porto & Verpackung           3.00      3.00
                                                     ====================

                                        Gesamtsumme: ____________________

  Bankverbindung :

  Raiffeisenbank Chieming-Grabenstaett eG, Konto-Nr. 230227, BLZ 701 691 11


  Ich habe das Copyright und die Benutzungsbestimmungen gelesen und

  bin mit diesen einverstanden.




  _____________________  ____________________________________________
         (Datum)                         (Unterschrift)
@ENDNODE
@NODE update "Update/Support"

@{b}Update/Support:@{ub}

Kai Seidel
Traunsteiner Str. 19
83355 Grabenstaett
GERMANY

oder per Telefon: +49 (0)8661 8087 (privat)
		  +49 (0)8661 8104 (Mailbox - 24h Online; 1200-33600 Baud)

ZERBERUS-Netz an SYSOP@CHIEMGAU.zer.sub.org

Wenn  Du  Verbesserungsvorschläge hast, dann schreib mir doch, ruf mich an,
oder schreib mir ne Nachricht übers Z-NETZ an SYSOP@CHIEMGAU.zer.sub.org.
@ENDNODE
@NODE einschraenkung "Einschränkungen der SHAREWARE Version"

@{b}Einschränkungen der SHAREWARE Version:@{ub}

-  Die  Routine,  die  unbenuzte  Spaces  am  Zeilenende  löscht,  kann nur
AMIGA-Texte korrekt wandeln.  Ebenso werden NUR Spaces gelöscht, nicht aber
Tabulatoren!  Das "ß" wird bei der Option "-c" nicht mitgewandelt.

-  Beim  Aufruf  unter  Intuition  ist  eine Art Nerv-Requester in Form der
Shareware-Information eingebaut.

-  Die Modi "ANSI-Remove" und "Wandlungs-Tabelle benutzen" sind nur von der
Intuition-Oberfläche aus abrufbar !

-  Bei der Konvertierung von Texten mit Hilfe von selbsdefinierten Tabellen
werden  maximal  32 Zeichen eingelesen !  Deshalb bitte nicht wundern, wenn
der  Textwandler  beim  Parsen  einen  Fehler  ausgibt!  Folgende Zeile ist
möglich:

   "ä"="ae";"ö"="oe";"ü"="ue";

   Das sind 28 Zeichen, was zum Testen vorerst ausreichen sollte!


Diese Einschränkungen sind in der VOLLVERSION natürlich aufgehoben.
@ENDNODE
@NODE entwicklung "Entwicklungs-Phasen"

@{b}Entwicklungs-Phasen:@{ub}

V1.0    Erste Version vom 25.4.92
V1.1    Version vom 1.5.92
	-Unterstützung von Filenamen mit Leerzeichen durch Angabe mit
	 Anführungszeichen eingebaut
	-Test, auf zwei gleiche Filenamen eingebaut
V1.2    Version vom 3.7.92
	-Schweren BUG beim Wandeln in Richtung IBM-Format entfernt!
	-Speicher-Allokier-Routine verschoben -> noch kürzere Wandlungs-
	 zeiten!
	-Zusätzliche Optimierungen vorgenommen (beq.s, moveq ect.)
V1.2a   Version vom 6.7.92
	-Falschen USAGE-Text berichtigt
V1.3    Version vom 11.7.92
	-Wandel-Puffer wurde auf 16384 heruntergesetzt.
	-Weiteren Wandel-BUG behoben; Probleme gab's beim Wandeln von
	 IBM-Texten ins AMIGA-Format. Die Returns ($0d0a), die durch den
	 Puffer von 16384 getrennt werden, werden jetzt auch richtig
	 gewandelt!
	-Weitere Optimierungen vorgenommen; Die Anzahl der Lade-Bytes und
	 der Bytes, die gespeichert werden, ist gleich -> SUPERKURZE
	 Wandlungszeiten auch von Festplatte auf Festplatte!
	-BUG, der ein einwandfreies Funktionieren unter Kick 1.2/1.3
	 verhindert, in letzter Minute entfernt.
V1.4    Version vom 21.7.92
	-Zusätzliche Sonderzeichen werden, neben den Umlauten, jetzt auch
	 gewandelt (siehe oben).
V1.5    Version vom 24.7.92
	-Die Verwechslung des Zeichens "ª" mit "|" in der Version 1.4 wurde
	 berichtigt (ist für die Konvertierung von z.B. C-Sourcen wichtig).
	-Bei Angabe eines Directories statt dem Ziel-Namen, wird der Text
	 mit dem Quell-Namen dorthin konvertiert.
	-Sicherheitsabfrage bei bereits existierenden Ziel-File eingebaut.
	-Neuen Switch (-o) eingebaut, der die Sicherheitsabfrage auf Exis-
	 tenz eines Files mit gleichem Namen wie der Ziel-File-Name, ab-
	 schaltet.
	-Ohne Angabe eines Switches wird der Text nun ins MS-DOS-Format
	 konvertiert.
V1.6    Version vom 11.8.92  PROGRAMMLÄNGE: 4756 Bytes
	-Optimierungen vorgenommen -> kürzerer Code!
	-Der Wandler ist nun mit CTRL-C abbrechbar !
	-Eine Anzeige, um die aktuelle Zahl der bereits gewandelten Bytes
	 auszugeben, wurde eingebaut; sie läßt sich mit dem -n Switch
	 abschalten.
	-Neuer Switch, um unnötige Spaces bzw. Tabs am Zeilenende zu
	 entfernen, eingebaut.
V1.7    Version vom 13.8.92  PROGRAMMLÄNGE: 5160 Bytes
	-Beim Wandeln ins AMIGA-Format wurde das 1. Zeichen des Textes
	 überlesen. Dieser Bug wurde entfernt!
	-Mit der -c Option werden Umlaute wie z.B. >Ö< in >Oe< gewandelt.
V2.0    Version vom 10.9.92  PROGRAMMLÄNGE: 11280 Bytes
	-Komplette, mausorientierte Intuitionoberfläche hinzugefügt
	 -> alles per Maus steuerbar !
V2.1    Version vom 23.9.92  PROGRAMMLÄNGE: 11864 Bytes
	-Bug beim Wandeln von MS-DOS-Text in Amiga-Text entfernt:
	 IBM-Return wird auf 0x0d0a jetzt getestet!
	-ANSI-Remover eingebaut. Lästige ANSI-Sequenzen können nun pro-
	 blemlos entfernt werden!
V2.2    Version vom 22.11.92 PROGRAMMLÄNGE: 13248 Bytes
	-Unter Kickstart 1.x funktionierte das String-Gadget nicht korrekt.
	 Bug behoben!
	-Wandlungsrichtung für ATARI-ASCII-Texte mit implementiert!
	-Versions-String eingebaut - Damit läßt sich jetzt auch mit dem
	 CLI/SHELL-Befehl "VERSION Text-Wandler" die aktuelle Version des
	 Text-Wandlers abfragen.
	-Der USAGE-Text (beim Aufruf mit "?") wird nun in 12'er Zeilen
	 ausgegeben und auf die RETURN-Taste gewartet.
V2.2a   Version vom 30.11.92 PROGRAMMLÄNGE: 13256 Bytes
	-Mehrere Bugs wurden behoben:
	 + Der ANSI-Remover funktioniert jetzt wieder !
	 + Bei der Frage, ob das schon vorhandenen Ziel-File überschrie-
	   ben werden soll, wurde bei Eingabe von "J" oder "N" + RETURN
	   das Return ueberlesen!
V2.3    Version vom 06.12.92 PROGRAMMLÄNGE: 13248 Bytes
	-Das "STOP"-Gadget lief nicht ordnungsgemäß! Der Computer ist
	 daraufhin immer abgestuerzt ! Bug behoben!
	-Zu lange ANSI-Sequenzen wurden nicht herausgefiltert! Auch dieser
	 Bug wurde behoben !
V3.0    Version vom 15.1.93 PROGRAMMLÄNGE: 20764 Bytes
	-OS 2.x Benutzeroberfläche eingebaut!
	-Option zum Wandeln mit eigener Tabelle eingebaut!
	-String-Gadget-Bug unter Kick/WB 1.2/1.3 behoben!
V3.1    Version vom 22.2.93 PROGRAMMLÄNGE: 21128 Bytes
	-Der Usage-Text paßt sich nun der Fensterhöhe an. D.H. die Ausgabe
	 stoppt automatisch, wenn das Fenster voll ist.
	-Unter der Intuition-Oberfläche waren einige Wandlungsarten ver-
	 tauscht! Fehler behoben!
V3.5    Version vom 27.3.94 PROGRAMMLÄNGE: 23576 (Deutsche Version)
					   23132 (Englische Version)
	-Ab sofort gibt es eine Deutsche und eine Englische Version!
	-Die Wandlungstabelle darf jetzt neben HEX- auch Dezimalzahlen
	 und Strings enthalten
	-Es werden jetzt nicht mehr Zeichen 1:1 über die Tabelle gewandelt,
	 sondern beliebig viele Zeichen können zu beliebig vielen kon-
	 vertiert werden!
V3.6    Version vom 21.5.94 PROGRAMMLÄNGE: 23948 (Deutsche Version)
					   23500 (Englische Version)
	-Das "ß" wurde in "us" gewandelt !!! Bug behoben
	-Das CLI-Window wird nun auf RAW geschaltet, damit lassen sich
	 bei der Abfrage auch einzelne Zeichen lesen!
	-Wird die Ausgabe beim CLI-Aufruf auf ein File umgeleitet, wird
	 ein evtl. vorhandenes Zielfile trotzdem ueberschrieben (fuer
	 automatisierte Aufrufe, z.B. beim Einsatz in Mailboxen)
V3.7    Version vom 09.10.94 PROGRAMMLÄNGE: 23604 (Deutsche Version)
					    23112 (Englische Version)
	-Tabellen-Wandlungs-Routine erheblich verbessert!
	-Allgemeiner konvertierungs-Bug behoben
V3.8	Version vom 06.08.95 PROGRAMMLÄNGE: 24732 (Deutsche Version)
					    24244 (Englische Version)
	-Einstellungen werden beim Verlassen des Programms nun temporär
	 gespeichert und bei erneutem Programmstart wieder geladen
	-Beim anwählen der Files durch den Filerequester wurde immmer
	 der letzte Filepfad benutzt; Jeder der 3 Filerequester besitzt
	 nun seinen eigenen Filepfad
	-Das Anwählen der nicht benutzten Gadgets beim Konvertieren OHNE
	 eigene Tabelle ist jetzt unterdrückt
V3.9	Version vom 03.10.95 PROGRAMMLÄNGE: 24928 (Deutsche Version)
					    24424 (Englische Version)
	-Bei der Anwahl einer neuen Wandlungstabelle im WB-Modus wurde
	 diese nicht richtig bearbeitet! Bug behoben
	-Vollversion: Unter Kickstart 1.3 wurde bei zu langem Namen
	 (der registrierten Person) der Text über den Fensterrahmen
	 hinaus geschrieben. Zeile ist jetzt in zwei Teile geteilt
	 worden
	-Im WB-Modus werden jetzt in der Status-Zeile mehr Informations-
	 Texte ausgegeben
	-Ein paar kleinere Textfehler ausgebessert ('für' statt 'fuer'
	 etc.)
	-Ab Kick2.x: Im WB-Modus wird bei vorhandenem Ziel-File jetzt
	 ein Requester geöffnet, in dem gefragt wird ob das File über-
	 schrieben werden soll
	-Ab Kick2.x: Wird im WB-Modus als Zielfilename nur ein Pfad
	 angegeben, so öffnet sich ein Requester, der den Pfad des
	 Zielfiles und den Quellfilenamen enthält und nachfrägt, ob
	 dieser benutzt werden soll
	-Tabelle wird nach dem decodieren im Speicher jetzt sortiert;
	-In der Tabelle wurde eine dezimale Null nicht anerkannt!
	-Die Routine welche die Fenster-Struktur des CLIs holt, brachte
	 unter ENFORCER immer einen Fehler. Bug behoben.
@ENDNODE
@NODE speziellen "Speziellen Dank"

@{b}Speziellen Dank an ...@{ub}

 ...    an  meinen  Bruder  Roger  und  seinen  Freund  für  die  englische
        Übersetzung und das Korrekturlesen der Dokumentation!
 
 ...    an Georg Lobensommer für dieses Guide!

 ...    an   Ralph   Babel   und   Garry   Glendown   für   die  Hilfe  bei
        programmtechnischen Fragen!

 ...    an Colin Fox und Bruce Dawson für ihre großartige req.library!

 ...    an Nico François für seine spitzen ReqTools.library!

 ...    und an  Commodore für die Produktion dieses Superrechners, denn nur
        AMIGA macht's möglich !!!
@ENDNODE
@NODE wichtig "Wichtige Zusatzinformationen"

@{b}WICHTIG:@{ub}

  Es wird weder eine Garantie für die vollständige Funktionsfähigkeit, noch
  die juristische Verantwortung oder irgendeine Haftung für Folgen, die auf
  fehlerhafte  Angaben  bzw.   die  Benutzung  des  Programms  zurückgehen,
  übernommen.  Sie nutzen diese Software auf eigenes Risiko!

  Bitte    >ausschließlich<    ASCII-Text-Dateien   mit   diesem   Programm
  konvertieren, da es an- sonsten zu Abstürzen kommen kann!
@ENDNODE