Changes V1.03
-------------

Forgot to add the toggles for disabling automatic archive extraction - 
silly me!

Added ARC and ZOO support - dunno why, I just felt like it.

Added SDUU.KEY for keyboard shortcuts. This file is just a flag. If 
your system does not support keyboard shortcuts then delete it so the 
internal keyboard manager will be made operational.

Changes V1.02
-------------

Added support for automatic decompressing of ZIP and LZH types.

Changes V1.01
-------------

U-score removed. It didn't work.

Dialogues responsive during encoding and decoding. Limited to once 
every half second to reduce AES overhead on processing. This is enough 
to move the window or shove it to the back on large files.

Bugs
----

Can Dump text on screen with multipart encode. Can't duplicate this 
now I want to deal with it. Typical.

Report of corrupted pug.pos file with exotic screen resolution. 
Solution for now is to run it under a "normal rez" then write protect 
pug.pos so preventing the update for the exotic rez. Symptoms are a 
crash after working okay once.

                      SwampDog UU encoder / decoder
                      -----------------------------

                                "File"
                                ------

Select the file you want to encode or decode. The relevant "Encode" or 
"Decode" button will become available. Files may be dropped onto SDUU 
and it will automatically work out what to do with them. It's just 
ocurred to me that dropping a combination of encoded and decoded files 
onto it has never been tried - might work but I doubt it.

                              "Encode"
                              --------

UU-encodes the selected file. Only available if SDUU thinks the file 
is not alreadu encoded.

                              "Decode"
                              --------

UU-decodes the selected file. Only available if SDUU thinks the file 
is already encoded. It works this out very simply - it looks at the 
first character after the extender and if this is a 'u' it is encoded!

                           "Remove Source"
                           ---------------

Does just that. The original file(s) are deleted after encoding or 
decoding. The source is still deleted even if something goes wrong 
like disk full. This has never been a problem as the source can always 
be extracted from the offline reader again and if it's corrupted it 
wants removing anyway.

                            "Extract Arcs"
                            --------------

After extraction the directory is scanned. For each file which has one 
of extenders .ZIP .LZH .ARC .ZOO, a directory of the same name as the 
filename stem is created and the corresponding archive moved into it. 
This is irrespective of the fact SDUU may not have just decoded it. 
Having moved the archives into the subdirectories, SDUU attempts to 
invoke the relevent archiver. SDUU expects each archiver to be a TOS 
program, and it expects them to be predefined in the text file 
SDUU.COM, the format of must be similar to:

d:\gemsys\arc\zip_2v6\zipjr.ttp -xr % *.*
d:\gemsys\arc\lha310\lharceng.ttp %
d:\gemsys\arc\arc602\arc.ttp -xv %
d:\gemsys\arc\zoo21\zoo.ttp -restore %

i.e. <fullpath> {blah} % {blah} where SDUU replaces the 1st occurrence 
of % with the fully specified archive path. If SDUU.COM exists, it 
must contain valid data. The ZIP is 1st, LZH is 2nd, ARC 3rd, ZOO 4th 
- this order is fixed.

The creation and movement of each archive into a subdirectory attempts 
to ensure no extractions can cause filename clashes. This does not 
mean clashes are impossible, just that sensibly constructed archives 
will be ok.

Two methods of invoking the archivers are possible:

1)	Pexec(0,exe,cmd,NULL). The desktop gets scribbled on by the 
	Tos program. SDUU cleans it up again of course.

2)	shel_write(TRUE,FALSE,SHW_PARALLEL,exe,cmd) - ie MagiC users. 
	This is much more pleasing. The Tos programs run in the VT52 
	manager thus no messy screen. SDUU blocks itself until it 
	receives CH_EXIT before launching another archiver process on 
	the next archive. This saves all the memory getting gobbled up 
	by multiple archiver instances.

#d:\gemsys\arc\zip_2v6\zipjr.ttp -xr % *.*
d:\gemsys\arc\lha310\lharceng.ttp %
d:\gemsys\arc\arc602\arc.ttp -xv %
d:\gemsys\arc\zoo21\zoo.ttp -restore %

Insert a # in column 0 as above to cause shel_write() invocation.

                            "Delete Arcs"
                            -------------

After extracting the archive this option can be used to remove the 
archive.

                               "Lines"
                               -------

Leave this blank or zero to encode to a single file otherwise enter 
the number of lines each section is to take up. Remember, it's in 
lines _not_ in bytes.

                            "Multi Decode"
                            --------------

The selected filename is ignored but the directory it sits in is 
scanned for *all* encoded files. They are decoded in turn. In the 
unlikely event one or more of the encoded files specifies the same 
decoded filename on its BEGIN line as another then the 2nd overwrites 
the first without warning.

                          "Auto Terminate"
                          ----------------

The program quits after doing the encode / decode tasks. This is most 
useful for drag and drop situations. SDUU turns this option off if you 
execute it directly - ie the option only remains turned on if you use 
drag and drop.

                            Miscellaneous
                            -------------

UNDO closes the active window. SHIFT-UNDO where MagiC is present is 
the same as the BACKDROP button. CTRL-UNDO cycles the SDUU windows. 
The status of all windows for all resolutions is remembered in pug.pos 
- delete it if you want them re-centred. Similarly, sduu.dat is 
written each time SDUU terminates and holds the current options. 
Delete sduu.com to stop automatic extraction.

                                Warranty
                                --------

None at all, expressed or implied.

                               Copyright
                               ---------

G. F. Harrison
122 Stanley Road
Forest Fields
Nottingham
NG7 6HP

                              Registration
                              ------------

Registration is not required. I wrote this for my use own and will 
probably never update it. I know I just have updated it but that's me 
all over. An email would be nice though!
