
                      +---------------------------+
                      |                           |
                      |  ***  UDEC/UENC 1.2  ***  |
                      |                           |
                      +---------------------------+


  Der DOS Universaldekoder fuer UUENCODE,XXENCODE,MPACK(mime),SHIP und
  BINHEX (Mac+Intel) Files.

 - UDEC 1.2
   Syntax : udec [-Optionen] [lw:\pfad\file.ext] [@lw:\pfad\filelist.txt]
            Wildcards sind zulaessig !
            z.B. udec ..\*.uue ..\*.mpk @filelist.txt -c!ns
  Optionen: -A  automatische Namensgebung bei unzulaessigen Filenamen
            -B  unterdrueckt Bildschirmausgabe bei Ausgabeumleitung
            -C  loescht dekodierte Quelldateien
            -C! loescht dekodierte Quelldateien
                ohne Sicherheitsabfrage zu Beginn
            -E  sortiert die Quelldateien nach Namenserweiterungen
            -N  sortiert die Quelldateien nach Namen
            -S  schaltet Fehlerbeeps ab

 - UDEC 1.1s (eingeschraenkte Version fuer nichtregistrierte Nutzer nach
             30 Tagen Testzeit.)
   Syntax : udec [-Optionen] lw:\pfad\file.ext
            Wildcards sind zulaessig !
            z.B. udec ..\*.* -can
  Optionen: -A  automatische Namensgebung bei unzulaessigen Filenamen
            -B  unterdrueckt Bildschirmausgabe bei Ausgabeumleitung
            -C  loescht dekodierte Quelldateien
            -E  sortiert die Quelldateien nach Namenserweiterungen
            -N  sortiert die Quelldateien nach Namen

 - UENC 1.2  (NEU, fuer registrierte Nutzer)
   Universalenkoder fuer UUENCODE,XXENCODE,MPACK(mime) und SHIP.
   Syntax : uenc [-Optionen] [lw:\pfad\file.ext]
            Wildcards sind zulaessig !
            z.B. uenc ..\*.zip ..\*.exe -xl64000c!
  Optionen: -M  MPACK Kodierung (Endung .MPK)
            -P  SHIP Kodierung  (Endung .SHP)
            -U  UUENCODE Kodierung (default, Endung .UUE)
            -X  XXENCODE Kodierung (Endung .XXE)
            -Lx  x<8000 : Zeilenzahl;  sonst max. Filelaenge
            -B  unterdrueckt Bildschirmausgabe bei Ausgabeumleitung
            -C  loescht kodierte Quelldateien (-C!  ohne Sicherheitsabfrage)
            -S  schaltet Fehlerbeeps ab




 - Der Dekoder wird unter DOS in der Kommandozeile aufgerufen:
   Mit "udec mail.txt" wird z.B. das File "mail.txt" dekodiert.
   Wird bei der Fileangabe die Ersatzzeichen "*" und "?" verwendet, koennen
   die gefundenen Files mit den Optionen -E oden -N vor der Dekodierung
   sortiert werden. Es ist also bei mehrteiligen Files nicht wichtig, ob die
   Reihenfolge im Verzeichnis stimmt. Es sollte nur auf eine korrekte
   Nummerierung geachtet  werden.
  Achtung: bei einer Nummerierung in der Erweiterung wird nach dem Zahlenwert
           sortiert.
           Z.B. "File.01","File.02"..."File.99","File.100"...

 - (NEU, nicht in v1.1s) Durch Angabe von mehreren Parameter in der
   Kommandozeile koennen Files aus mehreren Unterverzeichnisen durch einen
   Aufruf abgearbeitet werden. Die Parameter werden in der angegebenen
   Reihenfolge abgearbeitet.
   Die zu einem Parameter gehoerenden Quellfiles werden in der angegebenen Art
   sortiert.

 - (NEU, nicht in v1.1s) Quellfiles koennen auch durch Filelisten angegeben
   werden. Das ist sinnvoll wenn Files vorher anhand von "Subject"-Zeilen durch
   ein anderes Programm sortiert werden.
   So kann eine Sorierung mit anschliessender Dekodierung mittels Batchdatei
   ablaufen.
  Z.B. SORTDEC.BAT:        mailsort *.uue  >flst_uue.tmp
                           mailsort *.mpk  >flst_mpk.tmp
                           udec @flst_*.tmp -ac!s

   Die Filelisten werden durch den Parameter -c mitgeloescht.
   Die Listenparameter werden durch ein "@" gekennzeichnet, die Verwendung
   von Ersatzzeichen ("*","?") und die Sortierung der Listen ist moeglich.
   Die Quellfiles werden in der in den Listen festgelegten Reihenfolge
   abgearbeitet (keine Sortierung).

  Moeglich Listenformate:
   1. Angabe der Filenamen als "lw:\pfad\name.ext" durch "<space>,;<linefeed>"
      getrennt. Quellfilenamen ohne Pfadangabe muessen im Verzeichnis der
      Liste stehen.
      Achtung: Zeilen die mit Leerzeichen beginnen werden ignoriert.

   2. DIR Ausgebeformat:
      der Filename steht ohne "lw:\pfad\" am Zeilenanfang, ist 12 Zeichen lang
      und der Zeilenrest wird ignoriert. <DIR>-Zeilen werden ignoriert. Das
      Verzeichnis wird aus der vom DIR-Befehl erzeugten Kopfzeile entnommen.

      Moegliche Eingabe:     dir |sort  >filelist
                             udec @filelist

  ACHTUNG: SOLLTEN DIESBEZUEGLICHE PROGRAMME EXISTIEREN, DIE VON DIESEN
           FORMATEN ABWEICHEN, BITTE ICH UM EINE ZUSENDUNG EINER MUSTERDATEI.
           (per email)

   Ein Programm, das Inputfiles anhand ihrer "Subject"-Zeilen sortiert,
   eventuell teilt, anschlieend eine sortierte Fileliste erstellt und diese
   Files mittels UDEC dekodiert ist in Vorbereitung.

 - Enthaelt ein Textfile mehrere kodierte Binaries werden diese nacheinander
   dekodiert.

 - Die Quellfiles koennen DOS-Format (linefeed 0dh+0ah), UNIX-Format
   (linefeed 0ah) und auch (NEU) MAC-Format (linefeed 0dh) haben.

 - Der Dekoder entscheidet SELBSTSTAENDIG welches Dekodierverfahren er anwenden
   muss, der Anwender braucht sich also nicht darum zu kuemmern!

 - Header werden ignoriert.

 - Unzulaessige Linefeeds oder fehlende Leerzeichen am Zeilenende, die sich bei
   manchen Artikeln in uuencodete Zeilen befinden werden ignoriert.

 - Beginnt ein neues Binary ohne dass die Endmarke des vorhergehenden gefunden
   wurde, wird die vorangegangene Dekodierung (mit Fehlermeldung) abgebrochen
   und mit der neuen Dekodierung begonnen.

 - (NEU, in v1.1s kein Verify) Existiert beim Dekodieren schon ein gleichnam-
   iges File im Verzeichnis so wird das neue File dekodiert und mit dem alten,
   gleichnamigen File verglichen. Sind beide Dateien identisch wird eine Datei
   geloescht, ist eine Datei ein Fragment der anderen (d.h. die kuerzere Datei
   stimmt mit dem Beginn der laengeren Datei ueberein), wird das kuerzere File
   geloescht. Sind beide Dateien verschieden, wird der Anwender nach einen
   neuen Dateinamen gefragt, wobei ein neuer Name vorgeschlagen wird.
 - Besitzt eine Datei den eingegeben Namen, so hat der Anwender die Moeglich-
   keit die alte Datei zu ueberschreiben [J], die neue Datei zu verwerfen [N],
   die neue Datei noch einmal umbenennen [U] oder den gesammten Dekodiervorgang
   zu beenden [E].

 - Ist der Name des zu dekodierenden Files unzulaessig(z.B.mehr als 12 Zeichen)
   oder ist ein neues File umzubenennen, wird der Anwender nach der Dekodierung
   nach einen neuen Namen gefragt. (Die Dekodierung wird dabei nur angehalten)
   (NEU) Es wird ein unproblematischer Name vorgeschlagen, den der Anwender
   akzeptieren oder modifizieren kann.
   (NEU, nicht in v1.1s) Als Orientierungshilfe fuer die Namenseingabe bei
   fehlenden oder unzulaessigen Filenamen wird die "Subject:"-Zeile der E-Mail
   oder des Artikels ausgegeben.

 - Mit der Option -A werden fehlende,doppelte oder unzulaessige Filenamen
   automatisch durch andere unproblematische Namen ersetzt.
   (NEU, nicht in v1.1s) Falls bei fehlenden Filenamen in der "Subject" Zeile
   ein unproblematischer Filename steht, wird dieser verwendet.
   (NEU) Bekannte mehrfache oder laengere Erweiterungen werden ersetzt:
        .jpeg -> .jpg
        .tar.Z -> .taz  und
        .tar.gz -> .tgz
  FUER WEITERE VORSCHLAEGE BIN ICH DANKBAR (per email)
   Damit erspart sich der Anwender die (manchmal laestigen) Unterbrechungen
   durch Namensabfragen beim Dekodieren.

 - Beim Dekoderaufruf mit dem Ersatzzeichen "*" fuer die Namenserweiterung
   werden .ARJ .ARC .ASM .BAK .BAT .BMP .COM .DLL .EXE .GIF .FOR .JPG .LZH .OVL
   .PAS .PCX .PIF .SYS .TGA .WAV .ZIP .ZOO -Files nicht nach kodiertem Text
   durchsucht. (Programmlaeufe zeigten aber, dass solche Files kaum Einfluss
   auf die Dekodierung haben)

 - Der Anwender hat die Moeglichkeit mit der Option -C Quellfiles gleich nach
   dem dekodieren zu loeschen. (Sinnvoll bei voller Platte)
   Nichtdekodierte oder nicht zu dekodierende mit "???" gekennzeichnete Files
   werden nicht geloescht. Doch Vorsicht; Tritt ein Dekodierungsfehler auf
   (fehlt bei mehrteiligen Quellfiles ein Artikel oder sind zwei vertauscht)
   kann das unter Umstaenden nicht mehr behoben werden.

 - Kann bei UUENCODIERTEN Files eine Zeile nicht mehr korrigiert werden
   (z.B. bei einer zu langen Zeile), wird eine Warnung mit der Zeilennummer
   ausgegeben.
   (NEU) Sind mehr als zwei Zeilen beschaedigt, werden ab der dritten
   fehlerhaften Zeile keine weiteren Warnungen ausgegeben. Nach dem Dekodieren
   des Quellfiles wird dann eine Warnung mit der Anzahl der beschaedigten
   Zeilen ausgegeben.

 - (NEU, nicht in v1.1s) Nun ist es auch moeglich mittels der Option -S die
   Ausgabe der Fehlerbeeps zu unterdruecken.

 - (NEU) bei der Ausgabeumleitung mittels ">" (z.B. "udec *.* -acs >prot.txt")
   erscheint die Ausgabe zusaetzlich noch auf dem Schirm. Die Option -B
   unterdrueckt die Schirmausgabe (z.B. "udec *.* -abc >nul").

 - (NEU) bei UNSHIP wird der CRC ueberprueft und nach der Dekodierung "CRC ok"
   oder "CRC FAULT !!!" ausgegeben.

 - (NEU) UU/XXDECODE und MUNPACK-Routine in Assembler. Geschwindigkeitsgewinn
   ca.15 Prozent.


 Hinweise:

 - Es wird (ausgenommen bei UNSHIP) KEINE Ueberpruefung auf Korrektheit des
   Zielfiles (CRC,Checksum) vorgenommen !!!!!

 - Treten beim En- oder Dekodieren mit meinen Programmen Probleme auf,
   (Systemabsturz, keine Dekodierung wobei andere Dekoder funktionieren ...)
   bitte Ich um Zusendung der entsprechenden Quellfiles per Email oder
   auf einer 3.5" Diskette per Post mit einer kurzen Fehlerbeschreibung
   (Diskretion wird gewaehrleistet). Ist der Fehler behoben bekommt der
   Einsender die neue Version per Email zugeschickt. Sollte der Einsender
   registrierter Anwender ohne Email-Adresse sein, wird die neue Version per
   Post zugesand.


 Bedingungen:

 - Fuer eventuelle Schaeden an Hard- und Software, sowie fuer Verluste durch
   Produktionsausfall und fuer eventuell entgangene Gewinne, die durch den
   (vielleicht unsachgemaessen) Gebrauch meines Programms entstehen,
   uebernehme Ich keine Haftung.

 - Eine Modifikation der Programme ist untersagt.

 - Erklaert sich ein Anwender nicht mit diesen Bedingungen einverstanden,
   soll er meine Programme nicht benutzen!


 Zu alten Freewareversionen von UDEC: (unbegrenzt lauffaehig)
 - Private Weitergabe, sowie eine kostenlose Bereitstellung dieser Versionen
   in Mailboxen oder FTP-Servern uneingeschraenkt erlaubt.
 - Der Verbreitung von UDEC Freeware Versionen (<v1.2) auf Diskette oder CD-Rom
   schraenke ich insofern ein, als das Ich ein Freiexemplar verlange !!!
   Diesbezuegliche Anfragen bitte per Email unter Angabe von Artikelbezeichnung
   ,Auflage und Preis.


 Zu Testversionen: (gekennzeichnet durch ein "t" nach der Versionsnummer)
 - Private Weitergabe erlaubt, falls keine gegenteilige Meldung bei der
   Installation erscheint.
 - Keine Modifikation.
 - Keine kommerzielle Verbreitung.
 - Der Laufzeitraum ist beschraenkt !!!


 Zu Shareware Versionen:
 - Keinerlei Einschraenkung bezueglich Weitergabe und Veroeffentlichung.
 - Nach einer 30 Tage Testzeit verwandelt sich die Version in eine Freeware
   UDEC 1.1s Version, die nur den Leistungsumfang von Udec 1.1
   (ohne einige BUGs plus Neuerungen) bietet. Der Nutzer kann diese
   eingeschraenkte Version weiter benutzen.
   UENC kann nicht weiter benutzt werden.
 - Registriergebuehr 25.-DM oder 20.- $ US, genaue Anweisungen stehen im File
   REGISTER.TXT .


 Die aktuellste Version von UDEC gibt es ueber FTP auf
 sunshine.informatik.uni-wuerzburg.de (132.187.10.1) in /pub/peter .

 Falls Sie weitere Fragen oder Anregungen zu meinem Dekoder/Encoder haben
 wuerde Ich mich ueber eine Email freuen.

    Peter Liebel                       liebel@cip.informatik.uni-wuerzburg.de
    Friedhofstr.17                     liebel@informatik.uni-wuerzburg.de
    97526  Sennfeld  (Deutschland)
