Release Notes to accompany !UU version 0.20

*********
!UUEncode
*********

1. Headers and Footers
======================

!UUEncode now provides file headers and footers. These are text
objects which are the first (in the header case) and last (in the
footer case) line(s) in a UUEncoded file. Where file sectioning
is in use, the header and footer appear in each section file.

To define the header and footer to be used, enter the text in the
boxes in the "Options" window. The current settings can be saved
together with the rest of the setup to make a default configuration.

Special sequences may be entered in the header and footer text. These
sequences all begin with a percent character (%).
At present, the exhaustive list of these special sequences is:
  %N  Insert newline (using the current definition of "end of line")
  %T  Insert the date and time (in BASIC's "TIME$" format)
  %F  Insert the embedded filename
  %P  Insert the file part number ("Part X of Y")
  %%  Insert a percent symbol
  %0  }
  ..  }Insert user defined string 0 - 9.
  %9  }

The user defined strings may be entered in the file

                <!UUEncode$Dir>.Choices

The strings should be entered as:

               userstring1=whatever you want as a user string

Whatever appears to the immediate right of the equals sign is taken
as the string- quotation marks are not required and should not be used
(unless they are specifically wanted).

The user defined strings may contain special sequences. For example,
you could define a string to be:

              73, Ethelred G9ZZZ @ GB9ZZZ (%t)

User defined strings can themselves include user defined strings.
Taken to the extreme, one could have:

               userstring0=have %1
               userstring1=%2 nice %3
               userstring2= a
               userstring3=day%n

However, there is a catch -

               userstring0=Hello %0

will cause the program to go potty, and earn you the "drongo of the
week" award.

The idea is that the "header" and "footer" defined in the Options window
should be setup for the overall format required, and then the user
defined strings used to allow an easy change of message recipient etc.

Note that the header and footer automatically have a newline appended
to them by the program.


Checksums
=========

This version of !UUEncode (and !UUDecode) allows the optional use of
non-cumulative file checksums.
The previous versions of the program provided only a cumulative file
checksum, i.e. the checksum of each section of a file included the
effects of the previous sections of that file, and was not reset at
the start of that section.
By selecting the "Section" checksum option in the usual Options
window, the checksum included in each section will apply ONLY to
that section.
This has been provided for compatibility with another program.

!UUDecode has been modified to cope with either cumulative
or non-cumulative checksums automatically.


=================================================================

      T e r m s   a n d   c o n d i t i o n s   o f   u s e

=================================================================

This software (!UUEncode and !UUDecode) is public domain.

It is a condition of its release that it MUST be copied and distributed
as widely as possible!

You may not charge more than a purely nominal sum (to cover the cost of
postage and packing, and/or the approximate cost of any floppy disc
supplied) to anyone to whom you supply this software.

You may examine and copy sections of this code as much as you wish.
(No sniggering at my code though!)


However, if you modify the program (excluding the "Choices" file,
which is intended for user modification) and you supply the modified
program to a third party (i.e. anyone else), then you must supply that
person with full details of the modifications you have made.
You are also requested to pass back details of the modifications so that
they can be considered for incorporation into later versions.

(There is a simple reason for this condition. I have been known to have
bugs in my programs. I don't mind fixing my bugs. What I can do without
is the aggro of being told that there is a problem with the program
because someone else has been modifying it and passing that version
around as if it was the original. OK, so you may well feel that you can
make a better version than I have. You may well be right. Just remember
that I'm only doing this for fun.
*SOAPBOX OFF)


If you feel that you simply _must_ pay something for the software, then I
would be pleased if you made a small contribution to any organisation
concerned with research into (or support for sufferers of) Asthma.
I would prefer that you found an organisation or group in your own area-
failing that please send any donations to:

        National Asthma Campaign
        300 Upper Street
        London N1 2XX

        Tel: 071-226 2260

================================================================

And, above all....

Share and enjoy!


Andrew Benham  G8FSL
22 September 1991
