home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / comm / news / DWdecode.readme < prev    next >
Text File  |  1997-03-02  |  5KB  |  127 lines
  1. Short:    Very SMART mass decoder of USENET binaries
  2. Author:   dwhiting@europa.com  (Dick Whiting)
  3. Uploader: dwhiting@europa.com  (Dick Whiting)
  4. Version:  V1.0 first public release
  5. Type:     comm/news
  6.  
  7.  
  8. REQUIREMENTS: 
  9. -------------
  10.  
  11. You will need several programs/libraries from Aminet:
  12.  
  13.    RexxArpLib by Willy Langeveld  - util/rexx/ral3p3.lha
  14.  
  15.    FlashFind  by Frank Würkner    - util/cli/FlashFind1.2.lha
  16.  
  17.    A UUdecoder
  18.      e.g. UUout by Nicolas Dade   - util/arc/uuOut114.lha
  19.      
  20.    A Base64 decoder 
  21.      e.g. Base64coders by Edmund Vermeulen - comm/mail/Base64coders.lha
  22.  
  23.    And, of course, some Use Net files with encoded binaries;)
  24.  
  25. FILES INCLUDED IN THIS ARCHIVE:
  26.  
  27.    DWdecode               - the REAL program.
  28.    DWdecode.Base64.Types  - means of identifying Base64 first lines
  29.    DWdecode.Binary.Types  - means of identifying filenames in subject
  30.    DWdecode.Defaults.doc  - documents ALL options & internal defaults
  31.    DWdecode.Encode.Types  - MIME encoding types
  32.    DWdecode.Prefs         - a starter preference file
  33.    DWdecode.ReadMe        - this file
  34.    DWdecode.Section.Types - describes Section lines of UUencoded files
  35.    DWdecode.Skip.Froms    - allows for filtering based on From: lines
  36.    DWdecode.Skip.Subjects - allows for filtering based on Subject: lines 
  37.    Samples/....           - subdirectory with a few example scripts, etc.
  38.  
  39.    arexxqsort.lha         - handles sorting of stem variables.
  40.        by Willy Langeveld   originally found on Aminet 
  41.  
  42.  
  43. BASICS: 
  44. -------
  45.  
  46. This program does MASS decoding of Use Net files. It decodes ALL binaries
  47. that it is able to recognize, which is most;) from the source directory
  48. and optionally from ALL subdirectories as well.
  49.  
  50.  
  51. WHAT IT DOES:
  52. -------------
  53.  
  54. It uses information from MIME content lines, section lines, begin lines
  55. and (if it must) the subject line to determine what kind of encoding is
  56. used and which parts go together. It reports on files that have missing
  57. parts and on ones that it is unable to obtain complete information for.   
  58.  
  59. It handles either single directories or can handle COMPLETE directory trees.
  60.  
  61. It handles files with SINGLE & MULTIPLE UUencoded OR Base64 binaries 
  62. within them and Multipart UUencoded or Base64 files.
  63.  
  64. It handles files with APPLE/DOUBLE format. My logic uses the LAST file 
  65. of a given name within a SINGLE input file. This forces the APPLE portion
  66. to be considered a duplicate and not processed.
  67.  
  68. It allows you to filenote the decoded binaries with a variety of
  69. substitution values as well as literals. 
  70.  
  71. It is quite 'smart' and generally can figure out most files.
  72.  
  73. It is highly configurable and using external files can 'learn'.
  74.  
  75. It should work with almost ANY Base64 and UU decoder.
  76.  
  77. It allows for filtering based on From: and/or Subject: lines.
  78.  
  79. It allows for deleting input files after decoding, deleting duplicates, 
  80. deleting input files based on From: &/or Subject: lines, deleting files
  81. that have ONLY text in them, and deleting files based on their age.    
  82.  
  83. Reporting can be tailored by setting/unsetting a variety of switches on the
  84. command line or in the prefs file.
  85.  
  86. ------------------------------------------------------------------
  87.  
  88. I homeschool my kids and they would love a postcard from where EVER you live. 
  89. Instant Geography Lesson;)      
  90.                                                                           
  91. POSTCARDS:    Dick Whiting                                                
  92.               28590 S. Beavercreek Rd.                                    
  93.               Mulino, Oregon 97042                                        
  94.               USA                                                         
  95.                                                                           
  96. Bug Reports, etc:                                                         
  97.                                                                           
  98. Dick Whiting <dwhiting@europa.com>                   
  99. 01 December 1996                            
  100.                                                                           
  101. ------------------------------------------------------------------
  102.  
  103.  
  104. ============================= Archive contents =============================
  105.  
  106. Original  Packed Ratio    Date     Time    Name
  107. -------- ------- ----- --------- --------  -------------
  108.     8234    8234  0.0% 01-Jan-97 18:13:20 +arexxqsort.lha
  109.   155495   29236 81.1% 02-Jan-97 14:25:42 +DWdecode
  110.     1776     260 85.3% 31-Dec-96 15:46:06 +DWdecode.Base64.Types
  111.     2830     612 78.3% 31-Dec-96 15:52:22 +DWdecode.Binary.Types
  112.    42621    7014 83.5% 02-Jan-97 17:10:18 +DWdecode.Defaults.Doc
  113.     2816     587 79.1% 31-Dec-96 15:55:10 +DWdecode.Encode.Types
  114.     3343     666 80.0% 02-Jan-97 16:50:52 +DWdecode.Prefs
  115.    11205    4338 61.2% 02-Jan-97 16:55:00 +DWdecode.ReadMe
  116.     5724    1308 77.1% 31-Dec-96 16:03:08 +DWdecode.Section.Types
  117.     1944     405 79.1% 02-Jan-97 17:01:02 +DWdecode.Skip.Froms
  118.     2916     537 81.5% 02-Jan-97 17:03:32 +DWdecode.Skip.Subjects
  119.        0       0  0.0% 02-Jan-97 17:04:32 +DWdecode.Trap.Sections
  120.     3415     938 72.5% 02-Jan-97 16:58:10 +DWdecode.Complete.Prefs
  121.      628     253 59.7% 02-Jan-97 17:14:38  DWdecode.info
  122.        0       0  0.0% 02-Jan-97 17:37:34 +DWdecode.Trap.Encodes
  123.      628     251 60.0% 02-Jan-97 16:56:26 +SAMPLES.info
  124.      828     313 62.1% 02-Jan-97 16:59:18 +DoArts
  125. -------- ------- ----- --------- --------
  126.   244403   54952 77.5% 04-Jan-97 18:55:26   17 files
  127.