home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / uucode.zip / README.DOC next >
Text File  |  1993-08-30  |  5KB  |  120 lines
  1.                 ----------------------------------------------
  2.                 README FILE FOR uuENCODE and uuDECODE FOR OS/2
  3.                 ----------------------------------------------
  4.  
  5. The programs UUENCODE and UUDECODE were ported to OS/2 by me, from
  6. some Public Domain Turbo Pascal (for DOS) source code. The DOS source
  7. had been hacked before I obtained it, and was totally un-commented.
  8. I have changed the user interface to make the programs a bit more
  9. user friendly, and I have also added UNIX file compatibility to both
  10. the encoder and the decoder. The UNIX compatibility may or may not have
  11. bugs. If you discover any bugs, please mail me, and I will try to fix it.
  12.  
  13. The programs were ported to OS/2 using Clarion's TopSpeed Pascal for OS/2.
  14. I think that the compiler produces 16 bit OS/2 applications, but the code
  15. has been optimized for the 80386 processor. Optimization for the 80486
  16. processor produced no noticeable performance boost, so I have decided to
  17. leave the programs optimized the '386 chip. The programs can run in a
  18. full screen, or windowed OS/2 session. Please see below for further
  19. information.
  20.  
  21. The encode and decode algorithms seem to be rather slow and in-efficient.
  22. But thanks to the excellent optimizations in the TopSpeed Pascal compiler
  23. for OS/2, the OS/2 versions run at least 1000% faster than the DOS versions
  24. produced by Turbo Pascal 6.0. They are however still slower than other
  25. implementations that I have seen. For those Pascal programmers out there,
  26. porting your DOS Pascal programs to (text mode) OS/2 is largely painless,
  27. using TopSpeed Pascal. Included in the TopSpeed language is a utility for
  28. "converting" Turbo Pascal code to TopSpeed syntax. In many cases, the
  29. converted code compiles without alteration.
  30.  
  31.  
  32. Please NOTE THIS DISCLAIMER
  33. ***************************
  34. THESE PROGRAMS WERE PORTED TO OS/2 AS A SERVICE TO THE OS/2 USER
  35. COMMUNITY. THEY ARE SUPPLIED "AS IS", AND WITHOUT ANY WARRANTIES
  36. WHATSOEVER. I DO NOT ACCEPT ANY RESPONSIBILITY FOR ANY LOSS OR
  37. DAMAGE, PHYSICAL, FINANCIAL, MENTAL, SOCIAL, MARITAL, OR OTHERWISE,
  38. THAT RESULTS FROM THE USE OR THE PURPORTED USE OF UUENCODE OR
  39. UUDECODE FOR OS/2.
  40.  
  41. If these terms are not acceptable to you, then please DELETE the program
  42. files from your disks IMMEDIATELY.
  43.  
  44.  
  45. ***********************************
  46. *  Dr. Abimbola Olowofoyeku       *
  47. *  School of Law                  *
  48. *  Keele Univeristy               *
  49. *  Keele, Staffs ST5 5BG          *
  50. *  England.                       *
  51. *                                 *
  52. *  Email: laa12@seq1.keele.ac.uk  *
  53. ***********************************
  54.  
  55. --------
  56. UUENCODE
  57. --------
  58.  
  59. This program is for the purpose of converting binary files into printable
  60. characters (this is useful for transmission by E-mail, etc.). The program
  61. defaults to producing encoded files in the DOS format. However, it can also
  62. produce encoded files in UNIX format. The difference between the DOS and
  63. UNIX file formats lies only in the way each line is terminated - everything
  64. else is the same.
  65.  
  66. The syntax is:
  67.  
  68.     UUENCODE [-U] <INPUT FILENAME> [<OUTPUT FILENAME>]
  69.  
  70. The "-U" switch is to cause the program to produce a UNIX format encoded
  71. file. It is optional, and if it is not used, then the program produces a
  72. DOS format encoded file by default.
  73.  
  74. If no output file name is supplied, the encoded file name is the name of
  75. the input file, with the extension ".UUE" added to it.
  76.  
  77. Examples:
  78.  
  79.      UUENCODE MYFILE.ZIP         (produces MYFILE.UUE in DOS file format)
  80.  
  81.      UUENCODE -U MYFILE.ZIP      (produces MYFILE.UUE in UNIX file format)
  82.  
  83.      UUENCODE MYFILE.ZIP ME.UUE  (produces ME.UUE in DOS file format)
  84.  
  85.  
  86.  
  87. --------
  88. UUDECODE
  89. --------
  90.  
  91. This program is for the purpose of converting UUencoded printable files
  92. back into their original format. The program assumes by default that the
  93. encoded files are in the DOS format. However, it can also decode files
  94. which have been encoded in UNIX format. The program can determine
  95. automatically whether a file is in UNIX or DOS format.
  96.  
  97. The syntax is:
  98.  
  99.     UUDECODE <INPUT FILENAME> [<OUTPUT FILENAME>]
  100.  
  101. The auto-checking mechanism for UNIX the file format is usually sufficient,
  102. but please note that this auto-checking is a recent development, so if you
  103. discover any bugs here, please e-mail me.
  104.  
  105. If no output file name is supplied, the name of the target file is
  106. extracted from input (encoded) file.
  107.  
  108. Examples:
  109.  
  110.      UUDECODE MYFILE.UUE
  111.      (decodes MYFILE.UUE to a filename obtained from inside MYFILE.UUE)
  112.  
  113.      UUDECODE MYFILE.UUE TEST.ZIP
  114.      (decodes MYFILE.UUE, to an output file named TEST.ZIP)
  115.  
  116.  
  117. ---------------------
  118. A.A.O. 30 August 1993
  119. ---------------------
  120.