home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09964.iso / unix / uudv-04.win95.v1.zip / README < prev    next >
Text File  |  1995-02-14  |  7KB  |  171 lines
  1. UUdeview Readme
  2. ***************
  3.  
  4. The Problem
  5. ===========
  6.  
  7. You can't post (or email) binary files to newsgroups as binary files,
  8. since binary files contain lots of unprintable characters. Therefore,
  9. files must be coded into printable characters. There are a couple of
  10. methods available, like the macintosh binhex. The most popular
  11. encoding method is uuencoding, which first became standard in the
  12. unix world.
  13.  
  14. Unfortunately, there is another limitation to mailing or
  15. news-posting coded programs, since many mail or news gateways
  16. have an upper file size limit. Therefore, files must also be split into
  17. multiple parts to allow these gateways to handle them.
  18.  
  19. But the standard decoder programs aren't built to handle this. They
  20. can only work unsplit files. Concatenating the individual
  21. mails/postings does not help, since they contain lots of headers that
  22. confuse the decoder. The only help is to manually delete the headers
  23. from the mails/postings with a text editor. And, some of the bigger
  24. files come in more than 50 parts. You don't want to sit down and
  25. edit 50 files only to see a single animation, do you?
  26.  
  27. And still we're not through yet. Although the files are usually 
  28. posted in the right order, they don't necessarily arrive correctly
  29. ordered. So you must also manually put them in order.
  30.  
  31. I hope I have you convinced by now that you do not want to have to
  32. do this stuff. By now, you should think "Well, there must be 
  33. something to simplify decoding". And you're right. This is where 
  34. UUdeview steps in. 
  35.  
  36. The Idea
  37. ========
  38.  
  39. The Idea was to create a program that does all the work for you.
  40. You should not have to manually strip headers, and you shouldn't be
  41. troubled by the order of the files. And, the program should be able
  42. to process multiple files at once.
  43.  
  44. Now combine all this with a simple and friendly user-interface, and
  45. you have UUdeview! 
  46.  
  47. Featuring ...
  48. =============
  49.  
  50. Some of the highlights include: 
  51.  
  52.  o Shoot'em'up interface. You fire up the program will all
  53.    input files on the command line, and uudeview will then
  54.    present you all decodeable files. 
  55.  o Basically is a smart multi-file multi-part decoder, but also
  56.    feels at home dumbly with single-file single-part input. 
  57.  o Features the encoding schemes "UUencode", "XXencode"
  58.    and "Base64" (aka MIME); these schemes are auto-detected
  59.    for each email/article. 
  60.  o Ports exist for Unix, DOS and Windows, so if you
  61.    frequently change your operating system, UUdeview will
  62.    migrate with you. 
  63.  o The unique SPMS(r) technology sometimes allows to
  64.    recover from errors in the original postings' subject line. If
  65.    you have parts 1,2 and 4 of 'test' and part 3 of 'toast', the
  66.    program will try to guess these parts belong together. 
  67.  o The Unix and DOS versions allow file previews without
  68.    decoding the file (well, in fact it is decoded, but you won't
  69.    notice) 
  70.  o Usually asks before decoding each file, but can as well be
  71.    configured for batch-decoding. 
  72.  o The Windows version includes the UUdeview Launcher,
  73.    allowing for drag-and-drop decoding, and selection of
  74.    options by mouseclick 
  75.  
  76. The Philosophy
  77. ==============
  78.  
  79. UUdeview's philosophy is "to work". Thus it is programmed for to
  80. be smart and will decode files that other programs don't, or decode
  81. incorrectly. On the other hand, it is not designed for maximum
  82. fanciness; compared to other decoders it may look anachronistic.
  83. But you can decide on your own whether you want maximum
  84. operatability or maximum fanciness. And then there is another
  85. feature in favour of UUdeview, distinguishing it from other,
  86. similar utilities: It is free. I have found that most other decoders fit
  87. into one of two categories. Either they are not too bright (most get
  88. confused by parts that are not ordered), or they are not free. 
  89.  
  90. Behind the Frontend
  91. ===================
  92.  
  93. UUdeview evaluates the 'subject:' line. From the subject line, it tries
  94. to derive the name of the file and the part number. It looks for a
  95. filename of the kind string.suffix (also accepting more than one
  96. suffix). This file name must then appear on all subject lines
  97. containing other parts from this file (if it doesn't, hope for SPMS).
  98. If there's nothing on the subject that looks like a file name, don't
  99. worry, then UUdeview will find something else. And this
  100. subject-line file name isn't used for anything else than subject-line
  101. matching, anyway. For the actual file, the filename from the 'begin'
  102. line is used.
  103.  
  104. The program is also quite tolerant with part numbers. First, it looks
  105. for numbers in brackets (16/22) or (16 of 22) or simply (16).
  106. Secondly, it looks for the same kind of information in square
  107. brackets. Then it looks for the string "Part 16" or "Part #16" or
  108. something similar. As long as there actually is a part number,
  109. chances are that it will be found. 
  110.  
  111. Will there ever be a version 1.0?
  112. =================================
  113.  
  114. UUdeview was originally developed for Unix only, and it was
  115. planned to feature a full-screen curses menu-driven interface. Then
  116. I thought about it some more, discovered the above philosophy and
  117. found it not necessary for a program such simple to have a
  118. bombastic interface -- which would only make it more
  119. incompatible. Because this interface was planned for 1.0, and I have
  120. now decided not to include such an interface, it is unlikely that there
  121. will ever be version 1.0. But hey, the version is only a number that
  122. really doesn't tell anything. 
  123.  
  124. Known Bugs
  125. ==========
  126.  
  127.  o UUdeview only accepts Base64 (MIME) data that has a line
  128.    length of a multiple of four. The MIME standard does not
  129.    enforce a particular length. So far, no file with a
  130.    non-multiple-of-four line length has been found. 
  131.  o In its desperate attempts to merge file parts, SPMS might
  132.    infrequently produce a junk file (consisting partially of an
  133.    AU file and partially of an MPEG, for example). Again, this
  134.    has yet to happen to me. 
  135.  
  136. File_id.diz
  137. ===========
  138.  
  139. Personally, I do hate these files. They are always the first one to
  140. suffer from a massive del attack after unpacking any archive. But
  141. upon request, here's mine: 
  142.  
  143. ----
  144. (version 0.4) powerful multi-file  multi-part
  145. decoder  for uuencoded, xxencoded, and Base64
  146. (MIME) encoded data. Works with news postings
  147. as well as emailed data. Free but copyrighted
  148. (GPL).
  149. WWW home at  http://www.uni-frankfurt.de/~fp/
  150. Frank Pilhofer fp@informatik.uni-frankfurt.de
  151. ----
  152.  
  153. Famous last words
  154. =================
  155.  
  156. Although the program is free, donations are always gladly accepted
  157. <grin>, be it postcards, email, hardware or anything else. I will
  158. conquer the last step in the evolution of UUdeview, the Macintosh
  159. port, as soon as someone donates me a Mac. 
  160.  
  161. For you lawyers out there:
  162. Unix is a registered trademark of AT&T.
  163. Windows is a registered trademark of Microsoft.
  164. Macintosh is a registered trademark of Apple.
  165. UUdeview and SPMS are unregistered trademarks of Frank Pilhofer
  166. Projects (FPP)
  167.  
  168. Frank Pilhofer <fp@informatik.uni-frankfurt.de> Back to the
  169. Homepage
  170. Last modified: Tue Feb 14 09:18:28 1995 
  171.