
                           TkZip  README
                           =============


Current version:    1.0.6 
Author:             Bob Woodside <proteus@pcnet.com>
Prerequisites:      X Window System, Tcl/Tk 7.4/4.0 or higher (some
                    features are inoperative with Tcl/Tk releases
                    lower than 7.6/4.2, but this does not affect
                    the basic program functions).
More Info:          The official TkZip Web pages are at

                          http://www.pcnet.com/TkZip.TkZip.html

                    The latest version can be fetched from there, and 
                    a comprehensive set of release notes going back 
                    farther than you really want to know.



How to Install:     
---------------

	Just unpack the archive and exec the program TkZip in the 
directory where you unpacked it. It will automatically open the 
Install dialogue. Read the "Installing TkZip" directions in the 
Install window, and change any directory paths if you wish, then
click the Install button. An install log will be left in your home
directory explaining what was done. If you choose not to install,
TkZip will still run, but 1) any bitmaps it uses will be replaced
with boring text, and 2) it will pop up the install window every time
you start it. If you are running as root, you can also invoke TkZip
with the command line option --ForceInstall and it will just install
itself in the default locations without asking any questions.

	Shared Users:  If your SysAdmin has installed a shared copy
of TkZip, the Install dialogue will still pop up the first time you
run the program (or a new release). Do not try to run the install,
just make sure the Install Root field in the Install window points to
where the SysAdmin has placed the TkZip common directory, and click
"Close". This will update your private config file to point to the 
common directory where bitmaps and documentation files like this one 
live.

	Optionally, you can put TkZip01.xpm wherever you keep your 
pixmaps if you want to have your window manager or file manager 
associate it with TkZip. The TIFF version of it in the tarball is 
just there for testing the new MIME viewing feature (see the Changes 
section): you don't need it for anything.

	Once you've installed, you can delete everything you unpacked
(assuming you chose to let TkZip install the executable - otherwise...
better not throw it away).


Help:               
-----

	The Help Index selection under the Help menu gives you a
clickable index to the various Help sections.

	The Help selection pops up the whole long, boring Help file.

	Button-3 (right button) clicking on the buttons and menu 
items in the main window and the archive directory windows gives you a
more digestible context help window.


Warning About Running Older Releases:
-------------------------------------

	Running releases older than 0.9.6 after you have installed a
current release will cause your new-style config file directory
($HOME/.TkZip) to be deleted. Older versions, which had a single 
config file ($HOME/.TkZip.rc), will think this new directory is a 
stale cache directory that needs cleaning up on startup.

Known Bugs in This Release:
---------------------------

	None that I know of yet.

Packing List:
-------------

	This is what's in the distribution file.

        README                           This file.
        TkZip                            The program. This is really all
                                         you need.
        TkZip-1.0.6-Extras.tar           The extra components (mostly
                                         bitmaps) that will be installed
                                         (in /usr/local/share/TkZip by
                                         default, unless you change that
                                         in the Install dialogue). You can 
                                         delete this file after installing.
                                         It contains:
            README                       Another copy of this README file.
                                         It will be installed in the TkZip 
                                         directory.
            ReleaseNotes                 Release notes for older releases,
                                         that used to be in this README.
                                         They had become so copious over
                                         the last several betas that I 
                                         split them out into another file.
            License                      The License Information that pops
                                         up when you click "License Info"
                                         under the Help menu.
            TkzVer.rc                    Contains the release of the 
                                         currently installed version of 
                                         TkZip. If this version matches 
                                         that of the executable, TkZip
                                         will not prompt users to install
                                         when they run a new version.
            TkZip01.gif                  TkZip logo icon used in the Main 
                                         window of TkZip.
                                         (The icon artwork is courtesy of
                                         Pete Strader, slightly modified by
                                         me. Created with The GIMP,
                                         naturally.)
            lbutton                      Left arrow bitmap used in TkZip.
            rbutton                      Right arrow bitmap used in TkZip.
            TkZip01.xpm                  An optional xpm version of the 
                                         logo icon for use with your window
                                         manager or file manager.
            TkZip01.tif                  A tiff version of the logo - just 
                                         for testing MIME type viewing.



Changes in This Release:
------------------------

1.  Fixed an obscure parsing problem causing filenames containing a "$" to
be mishandled. (It is left as an exercise for the reader to determine why
such a thing might confuse the command interpreter.)
2.  Added some more debugging info, abillity to save debugging options.
3.  Added an extra sanity check to prevent deleting the current cache
directory when Clean Old Temp Files option is on. (I have two reports of
such a thing happening on file, but have never been able to reproduce it
on any system to which I have access.)
4.  Eliminated the attempt to capture the system's FQDN with "hostname -f".
On too many systems this causes the hostname to be set to "-f" if executed
as root.
5.  Removed a bit of Help verbiage that still identified the release as a
beta.

Changes in Release 1.0.5:
-------------------------

1.  Fixed a bug that prevented creation of a compressed tar with some 
non-GNU tars.
2. Fixed a parsing bug that caused a failure failure to open an archive
specified on the command line in the form "../My.tar.gz".
3. Removed the "Remember Symlinks" option under Windows. It had no 
meaning, and  caused occasional navigational quirks.
4. Forced non-GNU tar handling when extracting for viewing under Windows,
even with GNU tar. Extracting a member to stdout seems buggy with the 
Windows port of GNU tar that I have.
5. Modified the tar directory parsing once again. It was not properly
interpreting the filename on an IRIX 6.2 system.

Changes in Release 1.0.4:
-------------------------

1.  Added a *very* beta level of Windows support. If you wish to try it
under Windows, check the TkZip Web pages for the latest status or e-mail
me. I'm not going to document it till it's a little more polished.
2.  Fixed a bug that prevented creation of a new tar with non-GNU tars.
3.  Fixed a bug in handling compression options for compressed files: due
to a couple of transposed statements, if you specified a compression
option, you didn't get it, and if you specified one, you got Tcl squawking
about an uninitialized variable.

Changes in Release 1.0.3:
-------------------------

1.  Added a "Use GNU Tar Features" option (on by default) to provide a
work-around for a bug in GNU tar: when extracting a single directory
using the -T option (tar is passed the filelist in a file), GNU tar
will extract the entire archive. (The bug still exists in release 1.12.)
Turn off this option if you're using GNU tar and want to extract only a
single directory. Otherwise, leaving it on will result in the most
efficient processing.
2.  Added a work-around for some exception-catching problems reported on a
SunOS system.
3.  Bug fix:  the bottom scrollbar on the archive directory window did not
pick up customized colors when creating a new archive.
4.  Bug fix:  setting custom colors would get a Tk error trying to con-
figure a non-existent widget if the main window logo was being suppressed.

Changes in Release 1.0.2:
-------------------------

1.  Modified the tar handling routines to recognize the directory list
format change in release 1.12 of GNU tar (distributed with Red Hat 5.0
Linux systems, I believe). View and Extract would formerly fail with
this version of tar.

Changes in Release 1.0.1:
-------------------------

1.  Corrected a bug that sometimes left TkZip in its temporary cache 
directory when it tried to delete that directory on shutdown. (On some
systems this does not cause a problem; it does on others.)

2.  Corrected the routine that checks the current release level
against the user's config file - it could incorrectly conclude that
0.9.18b, for example, was a newer release than 1.0.0. (The bug was
introduced in 0.9.10.)

3.  Fixed several problems with tar handling for non-GNU tars.

Changes in Release 1.0.0:
-------------------------

1.  Corrected a bug in the file list widget that could cause a bogus
warning that you were trying to enter a TkZip internal directory.

2.  Corrected a bug in the Uninstall Test function that caused nonexistent
directories to be reported as files instead of directories.

3.  Corrected an old oversight: compression-vs-speed options were never
applied when adding members to zip files. They are now.

4.  The Install on Upgrade option now defaults to No for non-root users,
and the Install Options menu will now appear for all users (Install on
Upgrade is the only option that will appear unless you're the SysAdmin). 

    Pre-1.0 Beta users:  after installing this release, non-root users
(if they're using a shared copy of TkZip) should turn this option off and
save their  options. It was formerly on by default, and TkZip's policy
is not to alter your saved config options when upgrading to a new release
(unless an option has become obsolete, which is not the case here). 

5.  Fixed the buttons on the error/warning message windows to use the same
colors as the main window buttons. Previously, the buttons could become
illegible if you customized your color schemes.

6.  Corrected parsing of filenames with embedded spaces in the "Compress
File?" message box (the operation worked fine, but the message looked
pretty silly).

7.  Bound contextual Help to the buttons and option checkboxes in the
major windows where it was still missing.

8.  Added a check to prevent opening archives while a Change Cache
operation is in progress.

9.  The Add window now remains open after an Add completes, in case
you want to select more files to add. Also, the archive window is simply
refreshed, instead of being destroyed and recreated - much less visually
annoying (and faster).

10.  The Delete function is disabled for tars. I have yet to find a
version of tar with a reliable delete function, even GNU tar.

11.  Corrected a bug (introduced in 0.9.10) that could cause an unending
loop in the function that refreshes all open file/directory lists after
a new file is created or deleted.

12.  Cleaned up the clean-up of temp files in the cache directory, which
had gotten very sloppy in the 0.9 series of betas.

13.  Corrected a bug that prevented two archives with names beginning with
the same string, e.g. xyz.tar and xyz.tar.gz, from being opened at the
same time (if the longer name was opened first).

14.  Blocked the concurrent opening of two compressed tars containing tars
with the same name (the result would be files in the cache overwriting
each other).


Changes in Previous Releases:
-----------------------------

Due to the large number of bug fixes and feature changes in the last
several beta releases prior to 1.0, the older Release Notes have been
split out into a separate ReleaseNotes file. These notes go back to
release 0.9.6: for information on older releases check the TkZip Web
pages.





	- Bob Woodside
	4 May, 1998



