Home » Archimedes archive » Acorn User » AU 1995-07.adf » !Internet_StarterPak » !TTFN/Docs/uuexplode

!TTFN/Docs/uuexplode

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1995-07.adf » !Internet_StarterPak
Filename: !TTFN/Docs/uuexplode
Read OK:
File size: 0F6C bytes
Load address: 0000
Exec address: 0000
File contents
This is a NEWS uudecoder ported from Unix.

Basically it is a file buffered smart uudecoder: here's the blurb from
the header.

 * uuexplode-1.5.c (based on kiss 1.0)
 * Author kiss 1.0: Kevin Yang
 * Code cleanup and v1.5: Michael Bergman  (euambn@eua.ericsson.se)
 * Released to the Public Domain, no warranty whatsoever implied.
 * 
 * This C program (UNIX) takes an unlimited number of uuencoded files
 * and removes garbage lines. The uuencoded lines are decoded and written 
 * to specific output files. It is quite verbose as opposed to e.g.
 * uuconvert and tells you when things go well and when they don't.
 * It can also handle garbage between the `/SPC line and the end line and
 * warns if it suspects there is garbage between the last short data line
 * and the SPC-line.
 *
 * New in v 1.3:
 * Better format of warning messages, e.g. line numbers provided.
 * Bogus space lines in data and at end of a uucode block is handled.
 * See details below in ExplodeFile() if you're interested in exactly how
 * this is done.
 * New is v 1.4:
 * Secure option implemented.
 * New in v 1.5:
 * Changed string and I/O buffer size. 128 char string buffers
 * is not enough for long path names in news headers. This made
 * the line numbers in warning messages be wrong.
 *
 * WARNING:
 * If there is garbage between the short data line (if any) and the
 * SPC-line, the output file *might* be corrupted, but most likely not!
 *
 * The format of the uucode is assumed to be more or less as described
 * in uuencode(5) in the online UNIX manual with some exceptions:
 * An M-line can be longer than necessary. Some coders put an extra
 * checksum (character) after each line, this is ignored by uuexplode.
 * It is assumed though that all lines have the same number of checksum
 * chars after them.
 * The last data line before end-line can be either SPC\n or `\n
 * since SPC is equivalent to ` when decoding (both give 0).
 *
 * Any char in the range [a-~] is illegal uucode to this program
 * until someone has shown that there are COMMONLY used uuencode 
 * programs that produce correct uucode with small letters in it.
 * There are such uuencode, e.g. for the Macintosh(?), which use the
 * the range [>-}] by adding 96 to [0-29] and 32 to [30-63].
 * Note that this code is transparent to the standard uudecode.
 *
 * It is assumed that the end line of a uucode-block is in the
 * same input file as the corresponding begin and that the parts
 * are in correct order (of course).
 * 
 * Some diagnostics mean that the current output file is removed.
 * Others leave the output file, but check the input to be sure!
 *
 * To speed up the file handling, the file I/O buffers are re-set.
 * I chose 16 KB because it is 4 whole pages in a SunOS 4.x system.
 * The file I/O is by default buffered. If it is not in your system,
 * change to setvbuf() instead. This is also the appropriate action
 * to take if you don't have setbuffer().
 *
 
 It is very quick, and means that one can dump several uuencoded files, including
 comments news header comments, into one file and run it through the prog.
 
 
 To run it simply Filer_boot the app in a desktop file.
 
 All uuencoded files (set to type 7FE) will be then decoded when double-clicked.
 
 
 Modifications:
   
   Single-Tasking !Squeezed application.
   
   Log file and output automatically goto a rubbish bin, set with an environment variable 
   "Rubish$dir" 
 
 Warning:
   
    Alter uuencoded files
      
       begin 600 <filename>.<ext> to
       
       begin 600 <filename>
       
 ------------------------------------------------------------
 
 31st August 1993
  
  Martin Glanvill,
 
 mcg@waikato.ac.nz.
 
 
 ------------------------------------------------------------
 
 29 October 1994
 
 Modified code to generate RiscOS compatible filenames from the "begin"
 line.  Also changed it to use <Wimp$ScrapDir> for output files.
 
 Robert Orwin (rob@wong.demon.co.uk).
 
 
 
00000000  54 68 69 73 20 69 73 20  61 20 4e 45 57 53 20 75  |This is a NEWS u|
00000010  75 64 65 63 6f 64 65 72  20 70 6f 72 74 65 64 20  |udecoder ported |
00000020  66 72 6f 6d 20 55 6e 69  78 2e 0a 0a 42 61 73 69  |from Unix...Basi|
00000030  63 61 6c 6c 79 20 69 74  20 69 73 20 61 20 66 69  |cally it is a fi|
00000040  6c 65 20 62 75 66 66 65  72 65 64 20 73 6d 61 72  |le buffered smar|
00000050  74 20 75 75 64 65 63 6f  64 65 72 3a 20 68 65 72  |t uudecoder: her|
00000060  65 27 73 20 74 68 65 20  62 6c 75 72 62 20 66 72  |e's the blurb fr|
00000070  6f 6d 0a 74 68 65 20 68  65 61 64 65 72 2e 0a 0a  |om.the header...|
00000080  20 2a 20 75 75 65 78 70  6c 6f 64 65 2d 31 2e 35  | * uuexplode-1.5|
00000090  2e 63 20 28 62 61 73 65  64 20 6f 6e 20 6b 69 73  |.c (based on kis|
000000a0  73 20 31 2e 30 29 0a 20  2a 20 41 75 74 68 6f 72  |s 1.0). * Author|
000000b0  20 6b 69 73 73 20 31 2e  30 3a 20 4b 65 76 69 6e  | kiss 1.0: Kevin|
000000c0  20 59 61 6e 67 0a 20 2a  20 43 6f 64 65 20 63 6c  | Yang. * Code cl|
000000d0  65 61 6e 75 70 20 61 6e  64 20 76 31 2e 35 3a 20  |eanup and v1.5: |
000000e0  4d 69 63 68 61 65 6c 20  42 65 72 67 6d 61 6e 20  |Michael Bergman |
000000f0  20 28 65 75 61 6d 62 6e  40 65 75 61 2e 65 72 69  | (euambn@eua.eri|
00000100  63 73 73 6f 6e 2e 73 65  29 0a 20 2a 20 52 65 6c  |csson.se). * Rel|
00000110  65 61 73 65 64 20 74 6f  20 74 68 65 20 50 75 62  |eased to the Pub|
00000120  6c 69 63 20 44 6f 6d 61  69 6e 2c 20 6e 6f 20 77  |lic Domain, no w|
00000130  61 72 72 61 6e 74 79 20  77 68 61 74 73 6f 65 76  |arranty whatsoev|
00000140  65 72 20 69 6d 70 6c 69  65 64 2e 0a 20 2a 20 0a  |er implied.. * .|
00000150  20 2a 20 54 68 69 73 20  43 20 70 72 6f 67 72 61  | * This C progra|
00000160  6d 20 28 55 4e 49 58 29  20 74 61 6b 65 73 20 61  |m (UNIX) takes a|
00000170  6e 20 75 6e 6c 69 6d 69  74 65 64 20 6e 75 6d 62  |n unlimited numb|
00000180  65 72 20 6f 66 20 75 75  65 6e 63 6f 64 65 64 20  |er of uuencoded |
00000190  66 69 6c 65 73 0a 20 2a  20 61 6e 64 20 72 65 6d  |files. * and rem|
000001a0  6f 76 65 73 20 67 61 72  62 61 67 65 20 6c 69 6e  |oves garbage lin|
000001b0  65 73 2e 20 54 68 65 20  75 75 65 6e 63 6f 64 65  |es. The uuencode|
000001c0  64 20 6c 69 6e 65 73 20  61 72 65 20 64 65 63 6f  |d lines are deco|
000001d0  64 65 64 20 61 6e 64 20  77 72 69 74 74 65 6e 20  |ded and written |
000001e0  0a 20 2a 20 74 6f 20 73  70 65 63 69 66 69 63 20  |. * to specific |
000001f0  6f 75 74 70 75 74 20 66  69 6c 65 73 2e 20 49 74  |output files. It|
00000200  20 69 73 20 71 75 69 74  65 20 76 65 72 62 6f 73  | is quite verbos|
00000210  65 20 61 73 20 6f 70 70  6f 73 65 64 20 74 6f 20  |e as opposed to |
00000220  65 2e 67 2e 0a 20 2a 20  75 75 63 6f 6e 76 65 72  |e.g.. * uuconver|
00000230  74 20 61 6e 64 20 74 65  6c 6c 73 20 79 6f 75 20  |t and tells you |
00000240  77 68 65 6e 20 74 68 69  6e 67 73 20 67 6f 20 77  |when things go w|
00000250  65 6c 6c 20 61 6e 64 20  77 68 65 6e 20 74 68 65  |ell and when the|
00000260  79 20 64 6f 6e 27 74 2e  0a 20 2a 20 49 74 20 63  |y don't.. * It c|
00000270  61 6e 20 61 6c 73 6f 20  68 61 6e 64 6c 65 20 67  |an also handle g|
00000280  61 72 62 61 67 65 20 62  65 74 77 65 65 6e 20 74  |arbage between t|
00000290  68 65 20 60 2f 53 50 43  20 6c 69 6e 65 20 61 6e  |he `/SPC line an|
000002a0  64 20 74 68 65 20 65 6e  64 20 6c 69 6e 65 20 61  |d the end line a|
000002b0  6e 64 0a 20 2a 20 77 61  72 6e 73 20 69 66 20 69  |nd. * warns if i|
000002c0  74 20 73 75 73 70 65 63  74 73 20 74 68 65 72 65  |t suspects there|
000002d0  20 69 73 20 67 61 72 62  61 67 65 20 62 65 74 77  | is garbage betw|
000002e0  65 65 6e 20 74 68 65 20  6c 61 73 74 20 73 68 6f  |een the last sho|
000002f0  72 74 20 64 61 74 61 20  6c 69 6e 65 0a 20 2a 20  |rt data line. * |
00000300  61 6e 64 20 74 68 65 20  53 50 43 2d 6c 69 6e 65  |and the SPC-line|
00000310  2e 0a 20 2a 0a 20 2a 20  4e 65 77 20 69 6e 20 76  |.. *. * New in v|
00000320  20 31 2e 33 3a 0a 20 2a  20 42 65 74 74 65 72 20  | 1.3:. * Better |
00000330  66 6f 72 6d 61 74 20 6f  66 20 77 61 72 6e 69 6e  |format of warnin|
00000340  67 20 6d 65 73 73 61 67  65 73 2c 20 65 2e 67 2e  |g messages, e.g.|
00000350  20 6c 69 6e 65 20 6e 75  6d 62 65 72 73 20 70 72  | line numbers pr|
00000360  6f 76 69 64 65 64 2e 0a  20 2a 20 42 6f 67 75 73  |ovided.. * Bogus|
00000370  20 73 70 61 63 65 20 6c  69 6e 65 73 20 69 6e 20  | space lines in |
00000380  64 61 74 61 20 61 6e 64  20 61 74 20 65 6e 64 20  |data and at end |
00000390  6f 66 20 61 20 75 75 63  6f 64 65 20 62 6c 6f 63  |of a uucode bloc|
000003a0  6b 20 69 73 20 68 61 6e  64 6c 65 64 2e 0a 20 2a  |k is handled.. *|
000003b0  20 53 65 65 20 64 65 74  61 69 6c 73 20 62 65 6c  | See details bel|
000003c0  6f 77 20 69 6e 20 45 78  70 6c 6f 64 65 46 69 6c  |ow in ExplodeFil|
000003d0  65 28 29 20 69 66 20 79  6f 75 27 72 65 20 69 6e  |e() if you're in|
000003e0  74 65 72 65 73 74 65 64  20 69 6e 20 65 78 61 63  |terested in exac|
000003f0  74 6c 79 20 68 6f 77 0a  20 2a 20 74 68 69 73 20  |tly how. * this |
00000400  69 73 20 64 6f 6e 65 2e  0a 20 2a 20 4e 65 77 20  |is done.. * New |
00000410  69 73 20 76 20 31 2e 34  3a 0a 20 2a 20 53 65 63  |is v 1.4:. * Sec|
00000420  75 72 65 20 6f 70 74 69  6f 6e 20 69 6d 70 6c 65  |ure option imple|
00000430  6d 65 6e 74 65 64 2e 0a  20 2a 20 4e 65 77 20 69  |mented.. * New i|
00000440  6e 20 76 20 31 2e 35 3a  0a 20 2a 20 43 68 61 6e  |n v 1.5:. * Chan|
00000450  67 65 64 20 73 74 72 69  6e 67 20 61 6e 64 20 49  |ged string and I|
00000460  2f 4f 20 62 75 66 66 65  72 20 73 69 7a 65 2e 20  |/O buffer size. |
00000470  31 32 38 20 63 68 61 72  20 73 74 72 69 6e 67 20  |128 char string |
00000480  62 75 66 66 65 72 73 0a  20 2a 20 69 73 20 6e 6f  |buffers. * is no|
00000490  74 20 65 6e 6f 75 67 68  20 66 6f 72 20 6c 6f 6e  |t enough for lon|
000004a0  67 20 70 61 74 68 20 6e  61 6d 65 73 20 69 6e 20  |g path names in |
000004b0  6e 65 77 73 20 68 65 61  64 65 72 73 2e 20 54 68  |news headers. Th|
000004c0  69 73 20 6d 61 64 65 0a  20 2a 20 74 68 65 20 6c  |is made. * the l|
000004d0  69 6e 65 20 6e 75 6d 62  65 72 73 20 69 6e 20 77  |ine numbers in w|
000004e0  61 72 6e 69 6e 67 20 6d  65 73 73 61 67 65 73 20  |arning messages |
000004f0  62 65 20 77 72 6f 6e 67  2e 0a 20 2a 0a 20 2a 20  |be wrong.. *. * |
00000500  57 41 52 4e 49 4e 47 3a  0a 20 2a 20 49 66 20 74  |WARNING:. * If t|
00000510  68 65 72 65 20 69 73 20  67 61 72 62 61 67 65 20  |here is garbage |
00000520  62 65 74 77 65 65 6e 20  74 68 65 20 73 68 6f 72  |between the shor|
00000530  74 20 64 61 74 61 20 6c  69 6e 65 20 28 69 66 20  |t data line (if |
00000540  61 6e 79 29 20 61 6e 64  20 74 68 65 0a 20 2a 20  |any) and the. * |
00000550  53 50 43 2d 6c 69 6e 65  2c 20 74 68 65 20 6f 75  |SPC-line, the ou|
00000560  74 70 75 74 20 66 69 6c  65 20 2a 6d 69 67 68 74  |tput file *might|
00000570  2a 20 62 65 20 63 6f 72  72 75 70 74 65 64 2c 20  |* be corrupted, |
00000580  62 75 74 20 6d 6f 73 74  20 6c 69 6b 65 6c 79 20  |but most likely |
00000590  6e 6f 74 21 0a 20 2a 0a  20 2a 20 54 68 65 20 66  |not!. *. * The f|
000005a0  6f 72 6d 61 74 20 6f 66  20 74 68 65 20 75 75 63  |ormat of the uuc|
000005b0  6f 64 65 20 69 73 20 61  73 73 75 6d 65 64 20 74  |ode is assumed t|
000005c0  6f 20 62 65 20 6d 6f 72  65 20 6f 72 20 6c 65 73  |o be more or les|
000005d0  73 20 61 73 20 64 65 73  63 72 69 62 65 64 0a 20  |s as described. |
000005e0  2a 20 69 6e 20 75 75 65  6e 63 6f 64 65 28 35 29  |* in uuencode(5)|
000005f0  20 69 6e 20 74 68 65 20  6f 6e 6c 69 6e 65 20 55  | in the online U|
00000600  4e 49 58 20 6d 61 6e 75  61 6c 20 77 69 74 68 20  |NIX manual with |
00000610  73 6f 6d 65 20 65 78 63  65 70 74 69 6f 6e 73 3a  |some exceptions:|
00000620  0a 20 2a 20 41 6e 20 4d  2d 6c 69 6e 65 20 63 61  |. * An M-line ca|
00000630  6e 20 62 65 20 6c 6f 6e  67 65 72 20 74 68 61 6e  |n be longer than|
00000640  20 6e 65 63 65 73 73 61  72 79 2e 20 53 6f 6d 65  | necessary. Some|
00000650  20 63 6f 64 65 72 73 20  70 75 74 20 61 6e 20 65  | coders put an e|
00000660  78 74 72 61 0a 20 2a 20  63 68 65 63 6b 73 75 6d  |xtra. * checksum|
00000670  20 28 63 68 61 72 61 63  74 65 72 29 20 61 66 74  | (character) aft|
00000680  65 72 20 65 61 63 68 20  6c 69 6e 65 2c 20 74 68  |er each line, th|
00000690  69 73 20 69 73 20 69 67  6e 6f 72 65 64 20 62 79  |is is ignored by|
000006a0  20 75 75 65 78 70 6c 6f  64 65 2e 0a 20 2a 20 49  | uuexplode.. * I|
000006b0  74 20 69 73 20 61 73 73  75 6d 65 64 20 74 68 6f  |t is assumed tho|
000006c0  75 67 68 20 74 68 61 74  20 61 6c 6c 20 6c 69 6e  |ugh that all lin|
000006d0  65 73 20 68 61 76 65 20  74 68 65 20 73 61 6d 65  |es have the same|
000006e0  20 6e 75 6d 62 65 72 20  6f 66 20 63 68 65 63 6b  | number of check|
000006f0  73 75 6d 0a 20 2a 20 63  68 61 72 73 20 61 66 74  |sum. * chars aft|
00000700  65 72 20 74 68 65 6d 2e  0a 20 2a 20 54 68 65 20  |er them.. * The |
00000710  6c 61 73 74 20 64 61 74  61 20 6c 69 6e 65 20 62  |last data line b|
00000720  65 66 6f 72 65 20 65 6e  64 2d 6c 69 6e 65 20 63  |efore end-line c|
00000730  61 6e 20 62 65 20 65 69  74 68 65 72 20 53 50 43  |an be either SPC|
00000740  5c 6e 20 6f 72 20 60 5c  6e 0a 20 2a 20 73 69 6e  |\n or `\n. * sin|
00000750  63 65 20 53 50 43 20 69  73 20 65 71 75 69 76 61  |ce SPC is equiva|
00000760  6c 65 6e 74 20 74 6f 20  60 20 77 68 65 6e 20 64  |lent to ` when d|
00000770  65 63 6f 64 69 6e 67 20  28 62 6f 74 68 20 67 69  |ecoding (both gi|
00000780  76 65 20 30 29 2e 0a 20  2a 0a 20 2a 20 41 6e 79  |ve 0).. *. * Any|
00000790  20 63 68 61 72 20 69 6e  20 74 68 65 20 72 61 6e  | char in the ran|
000007a0  67 65 20 5b 61 2d 7e 5d  20 69 73 20 69 6c 6c 65  |ge [a-~] is ille|
000007b0  67 61 6c 20 75 75 63 6f  64 65 20 74 6f 20 74 68  |gal uucode to th|
000007c0  69 73 20 70 72 6f 67 72  61 6d 0a 20 2a 20 75 6e  |is program. * un|
000007d0  74 69 6c 20 73 6f 6d 65  6f 6e 65 20 68 61 73 20  |til someone has |
000007e0  73 68 6f 77 6e 20 74 68  61 74 20 74 68 65 72 65  |shown that there|
000007f0  20 61 72 65 20 43 4f 4d  4d 4f 4e 4c 59 20 75 73  | are COMMONLY us|
00000800  65 64 20 75 75 65 6e 63  6f 64 65 20 0a 20 2a 20  |ed uuencode . * |
00000810  70 72 6f 67 72 61 6d 73  20 74 68 61 74 20 70 72  |programs that pr|
00000820  6f 64 75 63 65 20 63 6f  72 72 65 63 74 20 75 75  |oduce correct uu|
00000830  63 6f 64 65 20 77 69 74  68 20 73 6d 61 6c 6c 20  |code with small |
00000840  6c 65 74 74 65 72 73 20  69 6e 20 69 74 2e 0a 20  |letters in it.. |
00000850  2a 20 54 68 65 72 65 20  61 72 65 20 73 75 63 68  |* There are such|
00000860  20 75 75 65 6e 63 6f 64  65 2c 20 65 2e 67 2e 20  | uuencode, e.g. |
00000870  66 6f 72 20 74 68 65 20  4d 61 63 69 6e 74 6f 73  |for the Macintos|
00000880  68 28 3f 29 2c 20 77 68  69 63 68 20 75 73 65 20  |h(?), which use |
00000890  74 68 65 0a 20 2a 20 74  68 65 20 72 61 6e 67 65  |the. * the range|
000008a0  20 5b 3e 2d 7d 5d 20 62  79 20 61 64 64 69 6e 67  | [>-}] by adding|
000008b0  20 39 36 20 74 6f 20 5b  30 2d 32 39 5d 20 61 6e  | 96 to [0-29] an|
000008c0  64 20 33 32 20 74 6f 20  5b 33 30 2d 36 33 5d 2e  |d 32 to [30-63].|
000008d0  0a 20 2a 20 4e 6f 74 65  20 74 68 61 74 20 74 68  |. * Note that th|
000008e0  69 73 20 63 6f 64 65 20  69 73 20 74 72 61 6e 73  |is code is trans|
000008f0  70 61 72 65 6e 74 20 74  6f 20 74 68 65 20 73 74  |parent to the st|
00000900  61 6e 64 61 72 64 20 75  75 64 65 63 6f 64 65 2e  |andard uudecode.|
00000910  0a 20 2a 0a 20 2a 20 49  74 20 69 73 20 61 73 73  |. *. * It is ass|
00000920  75 6d 65 64 20 74 68 61  74 20 74 68 65 20 65 6e  |umed that the en|
00000930  64 20 6c 69 6e 65 20 6f  66 20 61 20 75 75 63 6f  |d line of a uuco|
00000940  64 65 2d 62 6c 6f 63 6b  20 69 73 20 69 6e 20 74  |de-block is in t|
00000950  68 65 0a 20 2a 20 73 61  6d 65 20 69 6e 70 75 74  |he. * same input|
00000960  20 66 69 6c 65 20 61 73  20 74 68 65 20 63 6f 72  | file as the cor|
00000970  72 65 73 70 6f 6e 64 69  6e 67 20 62 65 67 69 6e  |responding begin|
00000980  20 61 6e 64 20 74 68 61  74 20 74 68 65 20 70 61  | and that the pa|
00000990  72 74 73 0a 20 2a 20 61  72 65 20 69 6e 20 63 6f  |rts. * are in co|
000009a0  72 72 65 63 74 20 6f 72  64 65 72 20 28 6f 66 20  |rrect order (of |
000009b0  63 6f 75 72 73 65 29 2e  0a 20 2a 20 0a 20 2a 20  |course).. * . * |
000009c0  53 6f 6d 65 20 64 69 61  67 6e 6f 73 74 69 63 73  |Some diagnostics|
000009d0  20 6d 65 61 6e 20 74 68  61 74 20 74 68 65 20 63  | mean that the c|
000009e0  75 72 72 65 6e 74 20 6f  75 74 70 75 74 20 66 69  |urrent output fi|
000009f0  6c 65 20 69 73 20 72 65  6d 6f 76 65 64 2e 0a 20  |le is removed.. |
00000a00  2a 20 4f 74 68 65 72 73  20 6c 65 61 76 65 20 74  |* Others leave t|
00000a10  68 65 20 6f 75 74 70 75  74 20 66 69 6c 65 2c 20  |he output file, |
00000a20  62 75 74 20 63 68 65 63  6b 20 74 68 65 20 69 6e  |but check the in|
00000a30  70 75 74 20 74 6f 20 62  65 20 73 75 72 65 21 0a  |put to be sure!.|
00000a40  20 2a 0a 20 2a 20 54 6f  20 73 70 65 65 64 20 75  | *. * To speed u|
00000a50  70 20 74 68 65 20 66 69  6c 65 20 68 61 6e 64 6c  |p the file handl|
00000a60  69 6e 67 2c 20 74 68 65  20 66 69 6c 65 20 49 2f  |ing, the file I/|
00000a70  4f 20 62 75 66 66 65 72  73 20 61 72 65 20 72 65  |O buffers are re|
00000a80  2d 73 65 74 2e 0a 20 2a  20 49 20 63 68 6f 73 65  |-set.. * I chose|
00000a90  20 31 36 20 4b 42 20 62  65 63 61 75 73 65 20 69  | 16 KB because i|
00000aa0  74 20 69 73 20 34 20 77  68 6f 6c 65 20 70 61 67  |t is 4 whole pag|
00000ab0  65 73 20 69 6e 20 61 20  53 75 6e 4f 53 20 34 2e  |es in a SunOS 4.|
00000ac0  78 20 73 79 73 74 65 6d  2e 0a 20 2a 20 54 68 65  |x system.. * The|
00000ad0  20 66 69 6c 65 20 49 2f  4f 20 69 73 20 62 79 20  | file I/O is by |
00000ae0  64 65 66 61 75 6c 74 20  62 75 66 66 65 72 65 64  |default buffered|
00000af0  2e 20 49 66 20 69 74 20  69 73 20 6e 6f 74 20 69  |. If it is not i|
00000b00  6e 20 79 6f 75 72 20 73  79 73 74 65 6d 2c 0a 20  |n your system,. |
00000b10  2a 20 63 68 61 6e 67 65  20 74 6f 20 73 65 74 76  |* change to setv|
00000b20  62 75 66 28 29 20 69 6e  73 74 65 61 64 2e 20 54  |buf() instead. T|
00000b30  68 69 73 20 69 73 20 61  6c 73 6f 20 74 68 65 20  |his is also the |
00000b40  61 70 70 72 6f 70 72 69  61 74 65 20 61 63 74 69  |appropriate acti|
00000b50  6f 6e 0a 20 2a 20 74 6f  20 74 61 6b 65 20 69 66  |on. * to take if|
00000b60  20 79 6f 75 20 64 6f 6e  27 74 20 68 61 76 65 20  | you don't have |
00000b70  73 65 74 62 75 66 66 65  72 28 29 2e 0a 20 2a 0a  |setbuffer().. *.|
00000b80  20 0a 20 49 74 20 69 73  20 76 65 72 79 20 71 75  | . It is very qu|
00000b90  69 63 6b 2c 20 61 6e 64  20 6d 65 61 6e 73 20 74  |ick, and means t|
00000ba0  68 61 74 20 6f 6e 65 20  63 61 6e 20 64 75 6d 70  |hat one can dump|
00000bb0  20 73 65 76 65 72 61 6c  20 75 75 65 6e 63 6f 64  | several uuencod|
00000bc0  65 64 20 66 69 6c 65 73  2c 20 69 6e 63 6c 75 64  |ed files, includ|
00000bd0  69 6e 67 0a 20 63 6f 6d  6d 65 6e 74 73 20 6e 65  |ing. comments ne|
00000be0  77 73 20 68 65 61 64 65  72 20 63 6f 6d 6d 65 6e  |ws header commen|
00000bf0  74 73 2c 20 69 6e 74 6f  20 6f 6e 65 20 66 69 6c  |ts, into one fil|
00000c00  65 20 61 6e 64 20 72 75  6e 20 69 74 20 74 68 72  |e and run it thr|
00000c10  6f 75 67 68 20 74 68 65  20 70 72 6f 67 2e 0a 20  |ough the prog.. |
00000c20  0a 20 0a 20 54 6f 20 72  75 6e 20 69 74 20 73 69  |. . To run it si|
00000c30  6d 70 6c 79 20 46 69 6c  65 72 5f 62 6f 6f 74 20  |mply Filer_boot |
00000c40  74 68 65 20 61 70 70 20  69 6e 20 61 20 64 65 73  |the app in a des|
00000c50  6b 74 6f 70 20 66 69 6c  65 2e 0a 20 0a 20 41 6c  |ktop file.. . Al|
00000c60  6c 20 75 75 65 6e 63 6f  64 65 64 20 66 69 6c 65  |l uuencoded file|
00000c70  73 20 28 73 65 74 20 74  6f 20 74 79 70 65 20 37  |s (set to type 7|
00000c80  46 45 29 20 77 69 6c 6c  20 62 65 20 74 68 65 6e  |FE) will be then|
00000c90  20 64 65 63 6f 64 65 64  20 77 68 65 6e 20 64 6f  | decoded when do|
00000ca0  75 62 6c 65 2d 63 6c 69  63 6b 65 64 2e 0a 20 0a  |uble-clicked.. .|
00000cb0  20 0a 20 4d 6f 64 69 66  69 63 61 74 69 6f 6e 73  | . Modifications|
00000cc0  3a 0a 20 20 20 0a 20 20  20 53 69 6e 67 6c 65 2d  |:.   .   Single-|
00000cd0  54 61 73 6b 69 6e 67 20  21 53 71 75 65 65 7a 65  |Tasking !Squeeze|
00000ce0  64 20 61 70 70 6c 69 63  61 74 69 6f 6e 2e 0a 20  |d application.. |
00000cf0  20 20 0a 20 20 20 4c 6f  67 20 66 69 6c 65 20 61  |  .   Log file a|
00000d00  6e 64 20 6f 75 74 70 75  74 20 61 75 74 6f 6d 61  |nd output automa|
00000d10  74 69 63 61 6c 6c 79 20  67 6f 74 6f 20 61 20 72  |tically goto a r|
00000d20  75 62 62 69 73 68 20 62  69 6e 2c 20 73 65 74 20  |ubbish bin, set |
00000d30  77 69 74 68 20 61 6e 20  65 6e 76 69 72 6f 6e 6d  |with an environm|
00000d40  65 6e 74 20 76 61 72 69  61 62 6c 65 20 0a 20 20  |ent variable .  |
00000d50  20 22 52 75 62 69 73 68  24 64 69 72 22 20 0a 20  | "Rubish$dir" . |
00000d60  0a 20 57 61 72 6e 69 6e  67 3a 0a 20 20 20 0a 20  |. Warning:.   . |
00000d70  20 20 20 41 6c 74 65 72  20 75 75 65 6e 63 6f 64  |   Alter uuencod|
00000d80  65 64 20 66 69 6c 65 73  0a 20 20 20 20 20 20 0a  |ed files.      .|
00000d90  20 20 20 20 20 20 20 62  65 67 69 6e 20 36 30 30  |       begin 600|
00000da0  20 3c 66 69 6c 65 6e 61  6d 65 3e 2e 3c 65 78 74  | <filename>.<ext|
00000db0  3e 20 74 6f 0a 20 20 20  20 20 20 20 0a 20 20 20  |> to.       .   |
00000dc0  20 20 20 20 62 65 67 69  6e 20 36 30 30 20 3c 66  |    begin 600 <f|
00000dd0  69 6c 65 6e 61 6d 65 3e  0a 20 20 20 20 20 20 20  |ilename>.       |
00000de0  0a 20 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |. --------------|
00000df0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000e10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 20  |--------------. |
00000e20  0a 20 33 31 73 74 20 41  75 67 75 73 74 20 31 39  |. 31st August 19|
00000e30  39 33 0a 20 20 0a 20 20  4d 61 72 74 69 6e 20 47  |93.  .  Martin G|
00000e40  6c 61 6e 76 69 6c 6c 2c  0a 20 0a 20 6d 63 67 40  |lanvill,. . mcg@|
00000e50  77 61 69 6b 61 74 6f 2e  61 63 2e 6e 7a 2e 0a 20  |waikato.ac.nz.. |
00000e60  0a 20 0a 20 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |. . ------------|
00000e70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000ea0  0a 20 0a 20 32 39 20 4f  63 74 6f 62 65 72 20 31  |. . 29 October 1|
00000eb0  39 39 34 0a 20 0a 20 4d  6f 64 69 66 69 65 64 20  |994. . Modified |
00000ec0  63 6f 64 65 20 74 6f 20  67 65 6e 65 72 61 74 65  |code to generate|
00000ed0  20 52 69 73 63 4f 53 20  63 6f 6d 70 61 74 69 62  | RiscOS compatib|
00000ee0  6c 65 20 66 69 6c 65 6e  61 6d 65 73 20 66 72 6f  |le filenames fro|
00000ef0  6d 20 74 68 65 20 22 62  65 67 69 6e 22 0a 20 6c  |m the "begin". l|
00000f00  69 6e 65 2e 20 20 41 6c  73 6f 20 63 68 61 6e 67  |ine.  Also chang|
00000f10  65 64 20 69 74 20 74 6f  20 75 73 65 20 3c 57 69  |ed it to use <Wi|
00000f20  6d 70 24 53 63 72 61 70  44 69 72 3e 20 66 6f 72  |mp$ScrapDir> for|
00000f30  20 6f 75 74 70 75 74 20  66 69 6c 65 73 2e 0a 20  | output files.. |
00000f40  0a 20 52 6f 62 65 72 74  20 4f 72 77 69 6e 20 28  |. Robert Orwin (|
00000f50  72 6f 62 40 77 6f 6e 67  2e 64 65 6d 6f 6e 2e 63  |rob@wong.demon.c|
00000f60  6f 2e 75 6b 29 2e 0a 20  0a 20 0a 20              |o.uk).. . . |
00000f6c