You are reading the documentation for the demo version of Tidbit
Software's GOOD Backup Utility for the Atari ST.

The demo kit contains five files:

GOODEMO.TXT - The GOOD DEMO documentation (this file). (Checksum 1829358)
GOODEMO.TOS - The demo of V1.8 of the GOOD Backup Utility. (Checksum 5407802)
CHECKSUM.TOS - The companion checksum utility. (Checksum 500347)
GOODEMO.LOG - Script of an example typical backup update. (Checksum 1135224)
GOODEMO.LG1 - Script of an extereme backup update. (Checksum 4310937)

	These files may have arrived in GOODEMO.ZOO or GOODEMO.ARC, or
	in the GOODEMO folder of somebody's GOOD Backup	Utility
	distribution disk.

Copyright and distribution permission:
--------------------------------------

GOODEMO.TOS, GOODEMO.TXT, GOODEMO.LOG, GOODEMO.LG1, and CHECKSUM.TOS
are all copyrighted works. Copyright  1989,1990 Tidbit Software
Engineering Co. All Rights Reserved, except as specified here.
 These files may not be modified or distributed in a modified form,
with the exception of reversible encodings, encryptions, or
compressions that may be employed in their transmission or storage. 
These three files, and these files only, may be freely distributed via
on-line services, various software libraries, or so-called "PD"
software collections so long as they remain together, with this notice
intact, and with no claims that would contradict the copyright
ownership of Tidbit Software.

The product version, "GOOD.TOS", is explicitly excluded from this
distribution permission.  GOOD.TOS may be copied by the owner for
backup purposes, but any transfer of ownership must either include all
backup copies, or the backup copies must be destroyed.  There is no
enforcement by "copy protection" applied to GOOD Backup Utility. 
Please help keep it that way. Copying software for the use of others,
or copying someone else's software for your own use, is a violation of
copyright, and is a crime.  Please don't do it.

	Pricing and Ordering Information
	--------------------------------

	The GOOD Backup Utility is a product of:
		Tidbit Software Engineering Company
		25 Wood Lane
		Maynard, MA 01754
		Attn. Jeffrey Lomicka, (508) 897-7429

	If your local dealer doesn't carry the GOOD Backup Utility,
	please have them contact me about getting it.  If you want
	to buy a copy, and your local dealer doesn't have it, you can
	get it from MY local dealer, as I'm not really set up to do
	retail sales:

		The Computer Bug
		113 Russel St.
		Hadley, MA 01035
		(413) 584-7722

	They'll take credit cards, etc. The suggested retail price for
	The GOOD Backup Utility is $29.95.  For delivery in
	Massachusetts please add sales tax.


GOOD Backup Overview
--------------------

The GOOD Backup Utility is a program that is primarily designed for
backing up your hard disk drive onto floppy disks.  The floppy disks are
ordinary TOS-readable floppies, so recovery of one or two files from the
backup is always as simple as finding the disk with the desired files on
it, and copying them back.  The utility is also good for keep a second
hard drive, such as a removable cartridge drive, as a "shadow" of your
active hard disk.

There are two overriding goals of the backup utility, and every feature
of the program is designed to enhance one of these goals.

	1. Performing backups should consume a minimum of your time.

	2. You should have confidence that your files can be restored.

Time saving features:
---------------------

1. In-place incremental updates:

First among the time saving features is the way the GOOD Backup Utility
updates your backup.  When you go to perform your backup at the end of
each work day, the GOOD Backup utility will go through the backup disks
and delete all of the obsolete files, and re-use that space to copy in
all the new files.  To figure out what is obsolete, the utility keeps a
"backup data file" where it stores the name, length, date, and checksum
value for every file in the backup.

Because this update is performed in place on the backup disks, you
never have to do a time consuming "full backup" more than once.  Once a
file is copied into the backup saveset, you don't have to wait through
copying it again unless it changes.  Each backup run takes only as much
time as it takes to copy over the files that changed since your last
backup.  At the end of the backup run, you have a stack of floppies that
contains all of the same files as your hard disk, none missing, and
equally as important, no extra obsolete copies!

2. Interruptable:

The second part of the time saving features is that the GOOD Backup
Utility can be interrupted at any time.  If you type any key on the
keyboard while it is copying files, it will stop between files and ask
if you want to "continue" or "quit".  If you "quit", it will write out
an updated copy of it's data file, and let you exit the program.

This way, you don't have to do your first backup all at once.  If you
have about ten minutes a day to devote to backups, you can probably
have your hard disks fully backed up in a week.  Thereafter, you can use
those minutes to do in-place updates.

Both backup and restore are interruptable.  The "Restore entire
partition" feature will only restore those files that are not already on
the hard drive, so you can restore an entire hard drive in several short
sessions, rather than one long one.

3. Built-in disk cache:

The third time saving feature is the built-in disk cache.  This is a
"write back look ahead" style of cache, which is a fancy way of saying
that the program keeps in-memory buffers of data it is reading or
writing to the disk, so that it can minimize the amount of disk head
motion and eliminate re-reading data it has read before.  The amount of
memory used by the disk cache is completely user configurable, and if
you have enough memory, you can make this cache as big as a floppy disk
and run the backup at near ram-disk speeds.

4. Lost disks can be replaced:

Lost backup disks can be replaced without having to do a whole new backup.

If you lose or damage a backup disk, the GOOD Backup Utility can be told
about it.  The Backup Utility will refer to it's backup data file to
identify all of the files that were on that disk, and back up fresh
copies of them onto a new disk.

If you lose the disk with the backup data file on it, the GOOD Backup
Utility can scan all of the backup disks and reconstruct the data file. 
This feature can also be used to convert backups from many other backup
utilities for use with GOOD.

5. No all files have to be backed up:

The GOOD Backup Utility allows you to enter a list of up to 16 wildcard
file specifications for files that you don't want to back up.  A single
wildcard specification can specify an entire class of files, or an
entire folder.

You can easily omit temporary files (*.TMP, in all folders), files that
are easily replaced from other sources, or files that you are required
by copyright or license agreement to not make backup copies.

NOTE:  This list defaults to a list of files NOT to back up, that is, a
list of files to EXCLUDE.  Many first time users expect this to be a
list of files to be backed up.  This is available as an option, but the
default is EXCLUDE, as in, everything else get's backed up!

Confidence features:
--------------------

1. Checksums of your hard disk:

This feature alerts you to possible disk errors on your hard disk.

The GOOD Backup Utility computes a "file checksum" each time it backs
up a file, and stores this value in the backup data file.  This file
checksum is simply a sum of all the bytes in the file.  If something
bad happens to the data, such as a disk error, or an errant program
writing to random spots on the disk, it will mess up this sum.

The checksum feature is closely related to the incremental backup
feature. Because you do backups frequently, the backup of a file, and
therefore the checksum computation, will be done soon after the file is
created, while you are sure that the file is still good.  Each time
thereafter when you do a backup update, you have the option of having
the program recompute the checksum of all the files on your hard disk,
and comparing them to the previously stored value.  If there is ever a
change in the checksum value, you know that something has modified that
file.

Because hard disk I/O is fast by itself, and the cache speeds things up
even further, this process takes a surprisingly short time, even on
fairly large disk partitions.

If there is any difference between the new checksum and the originally
stored checksum, you will be alerted to that fact, and can take a
corrective action, such as recovering the file from the backup.  (Note
that some programs, such as PHA$AR V3, will modify their data file
without changing the length or creation date.  These changes may show
up in GOOD as checksum errors, but do not indicate a real problem.)

The included utility CHECKSUM.TOS can be used to check a single file's
checksum against the backup listing any time you suspect that a file
may be damaged.

2. Checksums of your backup disks:

The GOOD Backup Utility can also use the checksum information to verify
that the files on the backup disks are all there, and all intact.  Be
realistic.  Floppy disks are not the world's most reliable way of
storing data.  If you are going to reformat, repartition, or replace
your hard disk, you want to be SURE, before you start, that you can
restore your backup saveset.  On demand, the GOOD Backup Utility can
recompute all the file checksums of all the files in the backup, and
alert you to any differences between the computed values, and the
previously stored checksum values.  If there are any differences, you
can take corrective action, such as backing up the file again or
replacing a bad backup disk, before you commit to erasing your hard disk.

3.  The backup disks are regular TOS disks:

If you have any doubt that your files are saved, you can simply insert
the disk and look at them.

4.  No "40 folder limit":

The GOOD Backup Utility bypasses the GEMDOS file system, so none of the
GEMDOS folder limit problems will affect the GOOD Backup Utility.

The GOOD Backup Utility V1.8 is compatible with every hard disk driver
that I've tried, including the ones that use of large (over 32MB)
partitions by using an enlarged sector sizes (Atari HDX V3, and ICD
4.1.8), and Rainbow TOS partitions with the standard 512 byte sector
size, but greater than 16 megabytes.  (GOOD is NOT compatible with the
CD-ROM drivers.  GOOD runs okay with the drivers loaded, but you can't
back up a CD-ROM with it, as CD-ROM disks don't use the standard TOS
file system.)

Note that prior to GOOD V1.8, there were several small but potentially
serious problems with the use of partitions greater than 16 megabytes. 
If you use large partitions, and don't have V1.8, you should send your
serial numbered disk back to TidBit Software for an immediate free
upgrade to V1.8.

The GOOD Backup Utility may be incompatible with various third party
disk cache programs and virus protection programs.  The GOOD Backup
Utility does low level disk operations, including reading and writing
the disk boot blocks (that's where it writes the disk labels), and has
been known to fail when these programs are improperly implemented or
otherwise get in the way.  If you have trouble, clear your auto folder
of this type of program and try again.  (The ICD and Atari disk caches
are known to work fine.  I've seen shareware and PD caches that don't
really work at all, let alone in combination with the GOOD Backup
Utility.)

Running the demo version:
-------------------------

The demo version of the GOOD Backup Utility is identical to the real
thing, but has been disabled in the following ways:

- The only files that the demo will back up are *.TOS, *.TTP, and *.PRG
files.  The idea here is that these files are almost always replaceable
by other means, so a backup of only these files is unlikely to be of any
value, and therefore you will be motivated to go out and buy the real thing.

- The demo version can only operate on drive letters A:, B:, and C:. 
The real thing, of course, can use any drive letter as either the source
or the destination.

The demo version also adds a title page that gives you price and
ordering information, and includes a script replay facility that will
replay a transcript of an actual backup update.  The transcript is
played back in real-time, all of the original pauses for disk I/O, disk
swapping, and user input are preserved.  The time taken to replay the
transcript is the same as that taken to perform the actual backup.

To get a good idea of what using the GOOD Backup Utility is like,
follow these step-by-step instructions:

1.  Get at least three or four blank floppy disks.  The demo will go
much faster if you have already formatted them, but if you wish, you
can have the GOOD Backup Utility format them for you.  I am assuming
that you have a hard drive running on partition C, and that there are
some .TOS, .TTP, and/or .PRG files on it.

2.  Run GOODEMO.TOS.  (The transcript file GOODEMO.LOG must be in the
same folder.)  When the title screen appears, select the option
"SCRIPT" by typing the letter "S", and hit RETURN.  The script included
in this demo is a transcript of an actual backup update of a 20
megabyte partition, which is half full.  This represents a backup after
a typical day or two of work on the computer, since the previous backup
update.  That is, there already exists a backup for this disk
partition, but it is now out of date, and is going to be updated.  You
will see how deleted files are deleted from the backup, modified files
are deleted, and the new ones copied over to replace them, and new
files are copied into the backup.  You will also notice that the backup
update goes fast enough that you can easily run it every day that you
do substantial work on your computer, so that you always have an
up-to-date backup should you need it!

[A second demonstration transcript is included as file GOODEMO.LG1.  If
you rename this to GOODEMO.LOG and run the GOOD Backup demo script, you
will get a demo of a much more extereme backup update.  This second
transcript runs under 15 minutes, but still includes a complete
checksum test of every file on partition C (and shows what happens when
it detects an error), formatting of a floppy disk, the addition of two
disks worth of new files to the backup, plus update of several days
worth of work on this partition.]

3.  After the demo, press RETURN to accept the default option of DEMO,
which starts the GOOD Backup Utility demo version.  Don't be
intimidated by the number of options on the first screen.  For most
people, the default values are fine, and you can ignore what you don't
yet understand.

4. You can move around the form with the arrow keys, where right/left
select different options on the multiple choice questions, and up/down
move from one question to the next.  You can also use the first letter
("Y" or "N", or disk letter) to change an answer.  Experiment now with
changing some things.  Note that sometimes changing one answer will
affect others.   Hit the HELP key on each question.  You will get more
detail.  The HELP key will always give you more details, no matter where
you are in the program.  Don't hit ENTER or UNDO yet!

5. Now, hit ENTER or UNDO.  (These two keys are always treated the
same. RETURN is more like down arrow.  Using UNDO is easier on standard
ST's, because it keeps nearly all interaction with the program on the
same key pad as the arrow keys.  On the Stacy, the UNDO key is somewhat
more difficult to reach, and ENTER is preferred.)

6.  When the GOOD Backup Utility asks for the backup saveset data file
disk, or whatever it asks, depending on what you changed on the title
screen, type ^C (Hold down  the CONTROL key, type "C").  The program
should ask "Perform another backup?".  Change the answer to "Y" and hit
return.  This reset all the questions back to their default values.

7.  Without changing any of the answers this time, hit UNDO again. GOOD
will ask for the disk containing the backup saveset data file.  Label
the first of your blank disks as "data file disk", and insert it into
drive A:.  If the disk is not formatted, select FORMAT, otherwise
select READY (the default), and hit either RETURN or UNDO.  (For the
most part, you can just keep hitting UNDO to get through this demo.)

If you selected FORMAT, choose SINGLE or EXTENDED, depending on if you
have a single sided or double sided disk drive, and hit RETURN.

8.  GOOD will indicate that it is performing a new backup (as opposed to
an update).  When requested, hit RETURN or UNDO to proceed.

9.  You will now see all the options for verifying files, and for
customizing file processing.  Ignore these, and hit UNDO.

10.  The GOOD Backup Utility will now figure out how many files it has
to copy.  Recall that only .TOS, .TTP, and .PRG are included in the
demo.  Label the next blank disk "C1-1" and insert into into drive A:. 
Select either READY or FORMAT, as is appropriate. 

GOOD will now proceed to copy files from C: to the floppy disk.  Files
will be copied from largest to smallest, which gives big files the
first shot at using an empty disk.  (Files bigger than a floppy are
split onto as many disks as they need.)  Continually smaller files will
be copied until the disk is so full that there are no files small
enough to fit.  There will typically be between 1K and 3K left on each
disk.  (This head room is required because it takes 1K to create an
empty folder.)

After three or four files have been copied, hit the space bar.  At the
end of the current file, you will be asked "CONTINUE or QUIT"?  Select
"QUIT" and hit return.

11. Wait for the "stopping disk cache" to complete, and re-insert the
previously labelled data disk.  Hit RETURN or UNDO, and GOOD will write
out the data file.

You can stop now if you want to.  You've completed a partial backup. 
Come back later to step 12, or change the answer to YES and you'll see
more now.  Hit return.

12.  Back to the first backup screen, take all the defaults again, and
hit UNDO.

13.  If it's not already in there, reinsert the disk that contains the
data file, and hit return.  Note it remembered that you used one disk so
far.  Hit UNDO or RETURN to proceed.

14.  Ignore the verify options again, and hit UNDO.

Note how the programs goes through all the files it had previously
backed up, and confirms their checksum.  You shouldn't get any errors. 
If you had, you would have been offered the option to IGNORE, BACKUP, or
RESTORE the file that has the error.

15.  Insert the C1-1 disk again, and let it fill the disk up.

16.  When it asks for C1-2, just hit RETURN without inserting a new
disk, and notice how the GOOD Backup Utility protects you from "insert
disk" errors.  It knows which disk is which, and complained when you
inserted "C1-1" instead of a new disk.

17.  Give it your next empty disk, labelled C1-2, and let it fill that
one up too.

The demo comes configured for a 520st, so the default cache sizes are
pretty small.  By using the additional memory on a 1040 or larger
machine, you can double or triple the speed of the disk I/O by changing
the cache parameters.  I've found on a 2MB or larger machine, that "40
segments of 40 sectors" is good, particularly for floppy drives.  On a
1040, "20 segments of 40 sectors" is pretty good.  Turning write verify
off is good for a little extra speed also.  You change these numbers by
saying "YES" to the question on the title screen about setting cache
parameters.  These numbers are stored as part of the saveset data file,
so once you have set them, the remain in effect for every backup
update. You usually only need to change cache parameters for the floppy
disk.  The hard drive is fast enough with the default of 4 segments of
32 sectors.

18.  At this point, you are probably bored with following the script,
so I will turn you loose to play with the demo.  Some things you might
want to try:

	- Adjust the cache for faster I/O.
	- "lose" C1-1, and watch GOOD replace it.
	- Delete or modify one of the .PRG files, watch GOOD update the
	backup accordingly.
	- Set the exclusion data to exclude some of your files, and
	watch GOOD remove them from the backup disks.
	- If you have one, use a disk sector editor to corrupt one of
	the floppies, and use the "verify files in backup saveset"
	option to find out which file you trashed, and watch the GOOD
	Backup Utility replace it.

When you are all done, go out and get the real thing.  Thanks for trying
the GOOD Backup Utility!

		*	End of GOODEMO.TXT	*V*
