ucopy
=====

Description
-----------

ucopyw22.zip   Copy/move new/chngd files +macros +log [VB3]

A Visual Basic program which requires VBRUN300.DLL and which
runs under Windows 3.1, on any hardware which supports 
Windows 3.1. ucopy copies or moves new & updated files 
skipping unchanged ones, and ignoring those specified by you, 
(e.g. *.TMP and *.BAK, even when copying or moving all files 
*.*), thus backing up files that need it and still saving 
time by not copying files that are already up-to-date. 
Supports a simple macro language for automating your regular
backup task.

This is an upgrade of ucopy v2.0 with many enhancements, 
e.g. faster response to cancel command; logging and confirmation 
may be started and stopped at any time, including in the middle 
of copying, moving and script execution; new script 
commands; and minor bug fixes: e.g. script files no longer "grow" 
by one line each time they are saved; ucopy help closes when 
ucopy does. ucopy can now run a specified script automatically
when it loads, and optionally log the results and terminate.

Uses
----

ucopy is a program which helps you to copy or move groups of 
files between directories. Of course, File Manager can perform 
this task, so why waste disk space and learning time on ucopy? 
ucopy is designed to perform operations where File Manger is 
inadequate or unable, and is particularly useful for:

1) Transferring files back and forth between two machines, so 
   that always the most up-to-date files are used: i.e. 
   "equalising" a directory tree on each machine.
2) Backing up data and 'state' information (e.g. *.INI, *.REG,
   *.DOC, etc) without wasting time copying unchanged files:
   ucopy will only copy files which are new or changed, and
   will skip the others. (Additionally you can also specify 
   files, filetypes and directories to ignore regardless.)
3) "Mirroring" a directory (tree) to a (floppy) disk or another
   directory (tree): can work recursively down a directory tree,
   and construct/expand that tree under the target directory.
4) Merging directories of files keeping only the most up-to-
   date files, (e.g. merging all your clip-art by using ucopy
   to move all the files into a single directory, thus 
   eliminating any old or duplicate files.)
5) "Refreshing" or updating existing files only, i.e. skipping
   unchanged and new files.
6) Automation: you can write scripts to carry out regular backups 
   automatically, with prompts and checks to see that the right 
   disk is being written to. Thus you do not have to remember 
   exactly which file(s) you've created or changed because every 
   file that needs to be backed-up, i.e. new and changed files, 
   will be copied, whilst those which do not require backing-up 
   will be skipped.
7) Logging: ucopy can record each action, whether interactive 
   or in a script, to a log file.


Licence
-------

You are free to use ucopy for as long as you wish free of charge. You may 
copy ucopy freely and give the copies away.
You may not sell ucopy, nor include it with software which is sold without 
written permission of the author.
If you are a shareware vendor you may charge a small fee for media, copying 
and postage, but nothing for the software itself.
The software is not supported, but if you have any problems (or solutions!), 
the author would be glad to hear from you.
ucopy is copyright  Mark Summerfield 1995: all rights reserved.

Postal Address:	6 Pantygwydr Road, Uplands, Swansea, SA2 OJB, UK.
Email:	msummerf@fdgroup.co.uk

Installation
------------

(ucopy does not change WIN.INI or any other setup file.)

Files included in UCOPYW22.ZIP are:
	UCOPYW22.TXT, 
	UCOPYWIN.EXE, UCOPYWIN.HLP, UCOPYWIN.INI, 
	THREED.VBX.

To install ucopy do the following:

1.  Copy the following files:
	UCOPYWIN.EXE to any directory on your hard disk. 
	UCOPYWIN.HLP to the same directory as UCOPYWIN.EXE. 
	UCOPYWIN.INI to either your WINDOWS directory or 
	the same directory as UCOPYWIN.EXE.
	THREED.VBX to your WINDOWS\SYSTEM directory, if you 
	do not have it already.
	VBRUN300.DLL to your WINDOWS\SYSTEM directory, if 
	you do not have it already. (Note this file is not 
	supplied with the "zipped" copy of ucopy: you must 
	obtain it separately from wherever you obtained
	ucopy from.)
2.  Start Windows if it is not running.
3.  Start or switch to Program Manager.
4.  Make the group which you wish ucopy to be added to active. (Either choose 'Window' and then the group, or click in the group.)
5.  Choose 'File' from the menu bar.
6.  Choose 'New' from the menu.
7.  Choose 'Program Item' (the default).
8.  Choose 'Browse'.
9.  Search through your files until you find UCOPYWIN.EXE.
10. Select UCOPYWIN.EXE.
11. Choose it by pressing 'Okay'.
12. Press [ALT]+[D], then type "ucopy" (without the quotes).
13. Choose 'Okay': that's it!

Double click the ucopy icon to start it.

Press F1 for help: the help file contains all the information
you need.

You may wish to choose 'File' and 'Properties' from 
Program Manager to set ucopy's default working directory, 
and any Command Line Options that you require.


