WinTAR - TAR (Tape ARchive) for Windows 1.4
===========================================

Written by William Cheung (wcheung@ee.ubc.ca)
Copyright (c) 1994 Cheung-Smith Ltd.
All Rights Reserved.

********** System Requirement **********

+ IBM-PC compatible 386 or better with at least 4MB RAM
+ Windows 3.1 or Windows for Workgroup
+ Windows Sockets pre-installed
+ Rexec daemon (using port 512) or Rsh daemon (using port 514) on 
  workstations running UNIX

********** File List **********

After unzipping this archive, you should receive the following files:

ctl3dv2.dll
licence.txt
readme.txt
wintar.exe
wintar.hlp
wintar.ini

********** Installation **********

Follow the instructions below for software installation:

1) Copy wintar.ini to your Windows installation directory, e.g. c:\windows
2) Move ctl3dv2.dll to your Windows installation directory under system\,
   e.g. c:\windows\system (Remember to remove ctl3dv2.dll from your WinTAR
   installation directory.)
3) Copy wintar.exe to a destination directory, e.g., c:\wintar
4) Make sure "winsock.dll" is in your DOS search path.
5) In your config.sys, add a line "install=c:\dos\share.exe" if it is not
   already in your config.sys.
6) In your autoexec.bat, add the following line:
   set rshhost_dir=c:\etc
   set temp=c:\tmp     <== if it is not already in your autoexec.bat
   where c:\etc can be replaced by a directory containing a host database
   file "hosts".  For MS TCP/IP, you must copy the file "hosts.sam" in the
   windows directory to "hosts" in the same directory, and replace "c:\etc"
   by "c:\windows".
7) Add wintar.exe to an existing program group.
8) Exit Windows and reboot your machine (Ctrl-Alt-Del) if you need to carry
   out instruction # 5.  Otherwise, go to #9.
9) Double click on the WinTAR icon and run the program.

********** Change Log **********
WinTAR 1.4:

1.  For remote commands, you can now use %s or %d more than once in a command
    line.  For instance, some version of Unix does not have the rewoffl command
    in "mt" so to achieve the same result, you can use 
    mt -f %s rewind; mt -f %s offline

For registered copies only...

2.  All files in an archive can now be shown in the files/directories list
    box.  This provides a nice temporary solution to the final hierarchical
    display of the archive.  Please note that for this feature to work, you
    must install "share.exe" in your DOS system.  Also add "set temp=c:\tmp"
    in your autoexec.bat.  Please see installation instruction #5 and #6 for 
    more information.

WinTAR 1.3:

1.  Eliminated the "sharing violation" system error when trying to back 
    up files that are open for updating by other applications.

2.  Modified the definition of "Relative to Sub-directory" so that it
    is equivalent to "tar cvf - .".

3.  Added a "Force Disconnection" check box in the "Advanced" Remote
    setup.  Only check this box if your Windows socket does not disconnect
    gracefully upon exiting.  (PC-NFS 5.0 or below users must check this
    box.)

4.  When adding files/directories to the list to be archived, any duplicated
    entries are eliminated.

5.  The TAR archive uses the standard TAR tag for normal files instead of
    the old Unix-compatible tag.  The old Unix-compatible tag is used only
    if the "Use old V7 format" option is checked in the preference menu.  The
    user name is defaulted to "root" and the group is "wheel".

6.  The backup path options are now saved as part of the directory template.

7.  The log file now contains start and finish date/time for the archive
    and other information.

For registered copy only...

8.  Added "Full Path" backup option - drive letters are now included in the 
    archive so that a multi-partition hard disk or a PC containing several 
    hard disks can be backed up into one archive.  When restoring the archive, 
    the files/directories are restored to their original location in the hard 
    disk(s).  If an expected drive is not found, an alternative drive is 
    allowed.

9.  The user is allowed to "flatten" a directory structure, i.e. remove the
    directory associated with a file, when restoring a file.
    

WinTAR 1.22:

1.  The blocking factor for a remote device is now properly set in the remote
    command for the first time.

2.  More warning messages are given, especially when an invalid value is
    entered.

3.  When you select a different log file and try to view it, WinTAR will
    open the currently selected log file as opposed to the original one
    during startup.

WinTAR 1.21:
1.  The blocking factor for a remote device is now properly set in the remote
    command.
2.  When double clicking a file in the Create Archive Dialog, the file is
    now displayed properly in the archive list.
3.  Fixed the "write xxx bytes short" error when FTP Software's PC/TCP
    winsock is used.
4.  Fixed various bugs in the toolbar buttons.
5.  Fixed a GPF bug when the message bar tries to display very long file
    names.

WinTAR 1.2: 
First public release

********** Bugs report **********

If you find any bugs in WinTAR, please email me at wcheung@ee.ubc.ca
and provide detailed information about the bug.  In addition, please 
specify the version of WinTAR that you are using.  A suggested bug 
report form is shown below:

Machine Type: (CPU, memory)
Windows Socket Vendor:
Windowing System:
Settings/Parameters in WinTAR you have used: 
(include the remote command if you are using a remote device)

Detailed description of the bug(s):

********** Some known bugs **********

+ The maximum size of a file name is 100 characters, including the
  slashes separating out the drive letter, the directory, and the file.

+ The unregistered version can only display the first 1000 files in the
  archive.

********** TODO List (For registered version) **********

+ Add hierarchical display of the archive.
+ Add an option to allow the user to save the "table of contents" of the
  archive locally so that opening an archive would be fast.
+ Add the capability of appending files/directories to an archive.
+ Add multi-volume support that is compatiable with GNU tar.
+ Add a simple scheduler to schedule hard-disk backup time.
+ Add drag-and-drop support.
+ Add long file-name (> 100 characters) support.
+ Allow the user to backup files selectively (archive bits, date range, etc.)

