FUUD
                                  ----
                      Copyright (c) 1994 Len Wilson
                       
                 A uudecoder for multi-part ftpmail files
           
                            * DOS Freeware *
                        
                                CONTENTS
                 
                        FUUD.COM   -   The decoder
                        FUUD.DOC   -   This file

        Internet mail servers usually break large uuencoded files into
 parts. It is then up to the recipient to clean up the parts and patch
 them together before decoding them.

        FUUD was born out of a need to process ftpmail files and Usenet
 binaries that arrive in parts. While it does this very well, it will also
 decode just about any uuencoded file.
 
 HOW TO USE FUUD:
 
        Put all the parts of your file in a work directory (preferably).
 Then enter "FUUD <filemask>".
 
                Example: fuud int23*.txt
                
        This would cause FUUD to round up all the ftpmail files that match
 that filemask (int23*.txt), strip the message headers off of them, put
 them in one big continuous file - in order - and decode it. All of this
 would happen very quickly, saving you the trouble of cutting and pasting.
 FUUD grabs the filename from the subject line of the first file it finds
 and compares it to the subject-line filenames on the other messages to 
 make sure each file is a valid part. So, even if you didn't do the filemask
 right, you might get the job done anyway. Also, FUUD looks for a "begin"
 statement but doesn't worry if it's not there. In this case, FUUD will
 give the file a generic name, "FUUD.TMP". It also does this for unix
 filenames.
 
 
 SWITCHES:
 
      /S causes FUUD to assume a single file that is already "clean".
         
      /D causes all the working files to be deleted, leaving only the
         original file (if FUUD thinks the operation was a success).
         
         
                Examples: FUUD myfile.txt /s /d
                          FUUD int2345?.txt /d


LIMITATIONS:

        - FUUD may reside anywhere in your path but the files to
          be processed must be in the current directory.
        
        - FUUD will process files that arrive in up to 100 parts.
        
        - FUUD has been tested with files produced by the Ftpmail
          server at decwrl.dec.com and with files from a LISTSERV.
          It has also been used to decode Usenet binaries. It must
          find the part # on the "Subject:" line.
          
        - FUUD does not like unix filenames. Makes them "fuud.tmp".
 
          Examples: Subject: Part 001 of somefile.zip
                    Subject: somefile.zip part 1/5 <other_stuff>
                    Subject: (fwd) somepic.gif part 1 of 6
                    Subject: [4/5] somefile.zip - my free program 

       ** To see a help page, enter "FUUD" with no parameters. **
      
      That's all there is to it. It takes a lot of the hassle out of
 ftpmail.
 
      Send comments, questions and bug reports to len.wilson@cougar.com.
      
      
 VERSION 1.1
 
      - Took care of a couple of things that prevented FUUD from doing
        Usenet binaries (properly posted).
 
      - Greatly improved subject-line parsing. This makes FUUD able to
        recognize and deal with a wider variety of files.
        
      - Improved ability to find the start of code in unusually formatted
        messages. Ignores junk at the start.

      - Added cleanup routine to take the junk off the ends of the parts.
        Some people and programs put comments and other crap there.
 
 
 
 LW