home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OS9000 / CMDS / uuen_decode_69_ucc.lzh / uu.doc < prev    next >
Text File  |  1985-01-07  |  4KB  |  87 lines
  1. UUE/UUD                                                          11/16/93
  2.  
  3. Overview
  4.     UUE and UUD are enhanced versions of the UNIX uuencode/uudecode
  5. programs.  What sets them apart from the older version is the ability to
  6. specify a maximum number of lines which compose a uuencoded file.  UUE
  7. will automatically split the output into as many files as needed to
  8. accomodate the maximum line count.  This feature is helpful when needing
  9. to transport uuencoded files across networks which have file size
  10. restrictions.
  11.  
  12.     If output requires multiple files, they will carry the extension .uaa,
  13. .uab, .uac, etc.  By merging them together in alphabetical order, the entire
  14. uuencoded file can be reconstructed back to its pre-coded form.  UUD detects
  15. if multiple uuencoded files are present and automatically piece the files
  16. together to produce the pre-coded file.
  17.  
  18.  
  19. Usage of UUE
  20.     UUE's built-in help is:
  21.  
  22.        Syntax: uue <[opts]> <file>
  23.        Function: enhanced uuencode utility
  24.        Options:
  25.            -l[=]lines    maximum lines for each output file
  26.            -n[=]name     encoded header name
  27.                          (defaults to file if not specified)
  28.  
  29.     The -l option specifies the maximum number of lines that a encoded file
  30. can have.  You can compute the approximate length of a file by multiplying
  31. the number of lines by 64 (the maximum characters per uuencoded line).
  32.  
  33.     The -n option specifies the name which will become part of the uuencoded
  34. header.  If a filename is present on the command line without this option,
  35. that file's name will be used as the header name.  Otherwise, this option
  36. can be used to override that assumption.  If there is no filename present
  37. on the command line, the -n option MUST be used, since UUE has no way of
  38. knowing what the header name is.
  39.  
  40.     If a filename is not specified, UUE takes raw data from standard input
  41. and writes encoded data on standard output (which can be redirected to a
  42. file).  If a filename is specified, UUE writes the encoded data to a file
  43. with the same name as the filename with an added '.uue' extension.  There
  44. can only be one filename on the command line.
  45.  
  46.     If a maximum number of lines is specified, UUE will use the filename
  47. plus the extensions '.uaa', '.uab', '.uac', etc. until it has recieved an
  48. end-of-file character.  The -l option can only be used when a filename is
  49. present on the command line.
  50.  
  51.  
  52. Usage of UUD
  53.     UUD's built-in help is:
  54.  
  55.        Syntax: uud <[opts]> <file>
  56.        Function: enhanced uudecode utility
  57.        Options:
  58.            -n            no line sequence check
  59.            -d            debug/verbose mode
  60.            -s[=]dir      source directory for all files
  61.            -t[=]dir      target directory for all output files
  62.        If <file> is - then stdin is used as input
  63.  
  64.  
  65.  
  66.     The -d option, if used, gives helpful and verbose information while
  67. decoding files.
  68.  
  69.     Use the -s option to specify a directory in which to search for source
  70. files.  Likewise, the -t option can be used to specify a target directory
  71. where the un-encoded file will be created.
  72.  
  73.     When '-' is used alone, UUD takes input from standard input.
  74.  
  75.     If a filename is given on the command line (with .uue or .uaa extension),
  76. that file will be decoded.
  77.  
  78.  
  79. Acknowledgements
  80.    Created by MSD, RDR, JPHD & WLS for MS-DOS, Atari GEM-DOS, UNIX & others
  81.    OS-9 port by Carl Kreider
  82.    OS-9 option handling and help added by Boisy G. Pitre
  83.  
  84. Please report any problems to me via:
  85.         Delphi:  BOISY
  86.         Internet:  boisy@os9er.waukee.ia.us
  87.