home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 July / PCO_07_97.ISO / filesbbs / DOS / UDEC1_23.ARJ / UDEC_E.TXT < prev    next >
Encoding:
Text File  |  1997-05-07  |  10.9 KB  |  240 lines
  1.  
  2.                       +-----------------------------+
  3.                       |                             |
  4.                       |  ***  UDEC/UENC 1.239  ***  |
  5.                       |                             |
  6.                       +-----------------------------+
  7.  
  8.  
  9.   Universal DOS decoding program for UUENCODE,XXENCODE,MPACK(mime),SHIP and
  10.   BINHEX (Mac+Intel) files.
  11.  
  12.  - UDEC 1.239
  13.    Syntax: udec [-options] [drive:\path\file.ext] [@drive:\path\list.txt]
  14.            wildcards allowed !
  15.            e.g. udec ..\*.uue ..\*.mpk @filelist.txt -c!ans
  16.   Options: -A  gives automatically a filename if given name is not permissible
  17.            -B  surpresses video output while redirecting standard output
  18.            -C  deletes decoded source files (-C!  without confirmation)
  19.            -E  sorts source files by extensions
  20.            -N  sorts by name
  21.            -S  switch off error beeps
  22.  
  23.  - UDEC 1.1s (limited version for not registered users, after 30-day testing
  24.              period)
  25.    Syntax: udec [-options] drive:\path\file.ext
  26.            wildcards allowed !
  27.            e.g. udec ..\*.* -can
  28.   Options: -A  gives automatically a filename if given name is not permissible
  29.            -B  surpresses video output while redirecting standard output
  30.            -C  deletes decoded source files
  31.            -E  sorts source files by extensions
  32.            -N  sorts by name
  33.  
  34.  - UENC 1.239 (For registered users only)
  35.   Universal encoder for UUENCODE,XXENCODE,MPACK(mime),SHIP and BINHEX.
  36.    Syntax: uenc [-options] [drive:\path\file.ext]
  37.            wildcards allowed !
  38.            e.g. uenc ..\*.zip ..\*.exe -xl64000c!
  39.   Options: -H  BinHex coding (extension .HEX)
  40.            -M  MPACK coding  (extension .MPK)
  41.            -P  SHIP coding   (extension .SHP)
  42.            -U  UUENCODE coding (default, extension .UUE)
  43.            -X  XXENCODE coding (extension .XXE)
  44.            -Lx  x<8000 : number of rows, otherwise filelength of target file
  45.            -B  surpresses video output while redirecting standard output
  46.            -C  deletes decoded source files (-C!  without confirmation)
  47.            -S  switch off error beeps
  48.  
  49.  
  50.   Usage:
  51.  
  52.   - To decode the file named "mail.txt" simply type > udec mail.txt < at the
  53.     command prompt.
  54.     If wildcards ("*", "?") are used it's possible to sort the files before
  55.     decoding them by using the parameters -E or -N; therefore it is not
  56.     necessary that multiple files are listed in correct order - just make
  57.     sure that they are correctly numbered.
  58.     (Note: if you want to decode more then 10 files at a time by using
  59.     wildcards, the numbering should start with a "0", e. g.
  60.     "file00, file01, ..." rather than "file0, file1, ...")
  61.     2nd note: if a numbering in the file-extension is used, the files will get
  62.     sorted by this value, e.g. "file.01", "file.02",...,"file.99", file.100"..)
  63.  
  64.  - If a textfile contains more than one binary file, these will be
  65.    successively decoded.
  66.  
  67.  - The source files may have DOS format (0dh+0ah), UNIX format (0ah) or MAC
  68.    format (0dh).
  69.  
  70.  - The decoder automatically decides what decoding method is appropriate
  71.     - no need to worry about this!
  72.  
  73.  - Headers are ignored.
  74.  
  75.  - (Not available in 1.1s)
  76.    Giving more than 1 parameter when invoking UDEC at the command line allows
  77.    you to decode files in different subdirectories in a single pass. UDEC
  78.    handles the files in the order you specify the parameters.
  79.  
  80.  - (Not available in 1.1s)
  81.    It's now possible to decode files using a textfile containing the file
  82.    names. This is useful if you already use a program that sorts files by
  83.    their subject lines (e.g. USORT).
  84.  
  85.    Note the "@" character preceding the name of the textfile.
  86.    Usage of wildcards and sorting for these textfiles are possible.
  87.    The option -c deletes the textfile. The source files are handled in the
  88.    order they occur in the textfile, sorting is not possible.
  89.  
  90.    Make sure that the textfiles have one of the following two formats:
  91.     1. Complete filename with path: "drive:\path\name.ext",
  92.        all separated through "<space>,;<linefeed>".
  93.        If you don't specify drive and path for the files, the files must
  94.        reside in the same directory as the textfile.
  95.        Note: lines starting with a blank are ignored.
  96.  
  97.     2. DOS "dir" format:
  98.        Filename without "drive:\path" at the beginning of the line,
  99.        12 characters long (rest of the line is ignored). <DIR>-lines
  100.        are ignored. The directory the <DIR>-command is displaying in
  101.        the headerlines is used for looking for files.
  102.         Example: dir | sort > filelist
  103.                  udec @filelist
  104.  
  105.       NOTE: If you're using a "command.com" replacement like, say, 4dos (tm),
  106.             make sure that the "dir" command you're using actually is
  107.             working like the plain MS-DOS "dir". This holds true, obviously,
  108.             if you're working with a MS-DOS emulator on whatever platform...
  109.  
  110.    USORT sorts input files by "SUBJECT", "BEGIN", "CONTENT", "SECTION" and
  111.    "SHIP" lines. Input files belonging to more than one binary will be split,
  112.    a file list named "USORT.LOG" will be created and UDEC will be invoked for
  113.    decoding. UDEC options (e.g. -a, -s) have to be given at the command line.
  114.    UDEC options start with "-", USORT options with "+".
  115.  
  116.     Syntax: usort [+options] [-UDEC options] [drive:\path\file.ext]
  117.     Options: +A  decoding all source files  (incomplete files included)
  118.              +I  ignore different "Subject"-lines in multipart-files
  119.              +D  prevents deleting source files after splitting
  120.              +C  deletes "USORT.LOG" file after decoding
  121.              +L  creates "USORT.LOG" file without decoding
  122.  
  123.    Option +i makes sense if the "subject"-lines of multipart-files doesn't
  124.    exactly match (part numbers excepted). In that case UDEC uses only the
  125.    file name to attach the files.
  126.  
  127.  
  128.  - Invalid linefeeds or missing spaces at the end of a file are ignored.
  129.  
  130.  - If a new binary starts and the decoder hasn't found the end-of-file
  131.    mark of the previous file, decoding of the previous file is stopped
  132.    (you'll get an error message) and decoding of the new file starts.
  133.  
  134.  - (Not available in 1.1s)
  135.    If UDEC finds, during decoding, a file with an already existing name,
  136.    it will compare these two files. if both files are identical, one gets
  137.    deleted. if one file is part of the other (that is, if the complete shorter
  138.    file is identical with the beginning of the longer file), the shorter file
  139.    gets deleted. if the files are different, UDEC asks you for a new name,
  140.    giving a default new name.
  141.  - If there's already a file with the name you have chosen, you have following
  142.    options:  * overwrite the old file [Y]
  143.              * delete the new file [N]
  144.              * rename the new file [R]
  145.              * quit decoding [Q]
  146.  
  147.  - If the decoder finds an invalid filename (e.g. more than 12 characters)
  148.    or you have to rename a new file, you'll get prompted for a new name.
  149.    (Decoding gets interrupted, not stopped).
  150.    UDEC will suggest a unique filename that you may accept or modify
  151.    (Not available in 1.1s) As some kind of assistance to find a new name
  152.    for the file, UDEC will display the "subject"-line of the article or the
  153.    e-mail.
  154.  
  155.  - If you invoke the decoder with the option -A, missing, double or invalid
  156.    filenames automagically are replaced.
  157.    (Not available in 1.1s) If a filename is missing, UDEC uses a given name in
  158.    the subject line.
  159.    UDEC replaces extensions
  160.      .jpeg   with .jpg
  161.      .tar.Z  with .taz
  162.      .tar.gz with .tgz
  163.    Feel free to e-mail me if you have other suggestions...
  164.  
  165.  - If you're using an asterisk ("*") for the filename extension (e. g.
  166.    "udec file.*") .ARJ .ARC .ASM .BAK .BAT .BMP .COM .DLL .EXE .GIF .FOR
  167.    .JPG .LZH .OVL .PAS .PCX .PIF .SYS .TGA .WAV .ZIP .ZOO files aren't
  168.    scanned for coded text.
  169.  
  170.  - If you're doing a lot of decoding on an already rather full HDD -
  171.    don't worry about running out of disk space: use the switch -C to delete
  172.    files immediately after they are decoded.
  173.    Beware, though: if an error occurs during decoding (e. g. you're
  174.    decoding a file consisting of multiple articles and one is missing)
  175.    this error may be unrecoverable.
  176.  
  177.  - If UDEC can't repair a line (e.g. a line is too long), you'll get an
  178.    error message with the corresponding linenumber.
  179.    If more than 2 lines are damaged, UDEC stops displaying error messages
  180.    but gives you a total of the damaged lines after decoding.
  181.  
  182.  - (Not available in 1.1s) Option -S suppresses error beeps.
  183.  
  184.  - When redirecting output (e.g.> udec *.* -abc > nul <), the output is
  185.    additionally shown on the screen. Option -B suppresses this.
  186.  
  187.  - UDEC checks decoded UNSHIP and (NEW) BinHex files for correct CRC and gives
  188.    either a "CRC ok" or a "CRC FAULT !!!"
  189.  
  190.  - Decoding mime-sourcefiles without BASE64-header is possible, if the first
  191.    bytes of the targetfile contain a .jpg, .gif, .zip, .zoo, .mpg or .exe mark.
  192.  
  193.  
  194. Notes:
  195.  
  196.  - With the exception of UNSHIP and BinHex, UDEC doesn't check (CRC, checksum)
  197.    if the decoded files are correct or not.
  198.  
  199.  - If you have troubles during encoding/decoding , like system crashes or
  200.    no or faulty decoding, while other decoders seem to work flawless,
  201.    please send me the offending file(s) via e-mail or on a 3.5" disk via
  202.    mail and a short description of the errors you're getting.
  203.    You'll get a new version via e-mail as soon as I have eliminated
  204.    the bug(s); if you're a registered user without an e-mail address,
  205.    you'll receive a new version via mail.
  206.  
  207.  
  208. Warranty:
  209.  
  210.   - This program is provided as is with no written or implied warranty.
  211.  
  212.   - The author shall in no event be held liable to you or anyone else
  213.     for any damage of any kind, incidental or consequential, arising
  214.     from the use or the inability to use this program.
  215.  
  216.  Old freeware versions of UDEC:
  217.  - Any private distribution of these versions, be it in mailboxes or on
  218.    ftp servers, is not restricted in any way.
  219.  - Distribution with PD/Freeware/Shareware packages on disk or CD-ROM
  220.    is resctricted in so far as you have to send me a free copy.
  221.    Please contact me via e-mail!
  222.  
  223.  Shareware versions:
  224.  - Unrestricted distribution and publication
  225.  - After a testing period of 30 days these versions will transform themselves
  226.    into UDEC 1.1s (minus a couple of bugs, plus a few new features),
  227.    which you can use without restrictions.
  228.  - Registration fee is 25.- DM or 20 $ US. See the file REGISTER.TXT .
  229.  
  230.  
  231.  You'll find the latest version of UDEC on the anonymous ftp-server
  232.  sunshine.informatik.uni-wuerzburg.de (132.187.10.1) in /pub/peter
  233.  
  234.  
  235.  Bug reports, suggestions and comments are appreciated. Feel free to e-mail to
  236.  
  237.     Peter Liebel                       liebel@cip.informatik.uni-wuerzburg.de
  238.     Friedhofstr.17                     liebel@informatik.uni-wuerzburg.de
  239.     97526  Sennfeld  (Germany)
  240.