
                           TkZip  Release Notes
                           ====================



Changes in Release 0.9.18:
--------------------------

1.  None. This release was cut to force overlaying of a defective copy
of the distribution file uploaded to Sunsite.

Changes in Release 0.9.17:
--------------------------

1.  Added a couple more sanity checks to inhibit sending useless e-mail
to the author, like Bug Reports with no description of the problem.

Changes in Release 0.9.16:
--------------------------

1.  Removed the separate viewer invocation for each file when a list of
files with embedded spaces in their names was selected for viewing. The
whole list of names is now always passed to a single invocation of the
viewer.
2.  More Help cleanup, particularly options and command line flags that
had been overlooked.
3.  Corrected error handling in the file list widget when you attempt to
enter a directory for which you do not have the proper permissions.
4.  Added the --adm command line flag to access Sysadmin functions,
which currently consist of setting certain installation options normally
patched by package installers, and not for general use. (You must
actually *be* the Sysadmin - i.e., root - to use it, or the option will
be ignored.)
5.  Added the --ForceInstall command line flag. (See the "How to Install"
section of the README file.)

Changes in Release 0.9.15:
--------------------------

1.  Removed some stray debugging stdout writes.
2.  Removed the View Single restriction on archives containing files with 
embedded spaces in their names. However, for these types of archives,
TkZip spawns a separate invocation of the viewer for each file, rather
than passing the whole list of filenames to a single invocation. The other
way will require some significant rewriting, and may not make the cut for
1.0.
3.  Corrected a quirk that caused the MIME type information not to be
loaded at startup if both "Automatic Viewer Selection" and "Use MIME for
All Files" were set.


Changes in Release 0.9.14:
--------------------------

1.  Help navigation now remembers the window height and position within
a previously visited Help section.

Changes in Release 0.9.13:
--------------------------

1.  The print command is now saved after you print a Registration or
Bug Report form.

2.  Minor additions to Help text.


Changes in Release 0.9.12:
--------------------------

Changes:

1.  Install now displays the install log when it completes.
2.  Help menu now has a Read the Current README (this file) function.
3.  License Info function added to Help menu.
4.  Due to a rash of undecipherable e-mail from Linux newbies who didn't
read the directions, the Register/Bug Report functions will no longer fill
in the User and Host fields with the user and host hames of your machine:
you have to enter your e-mail address, and are encouraged to read the
directions in the window before hitting the Send button. (After you have
once done this, your e-mail address is saved, so you're not pestered
again.) Sorry, but as I've observed before, I get enough junk mail without
having my own program send it to me.
5.  The Help links have been changed from double-click to single-click.
6.  The Help links have been changed to a consistent red (except for
major categories in the Help Index).
7.  Options menu now has an option to suppress using the TkZip logo on
the main window, for those who find startup is slowed down too much by
the bitmap building.
8.  The Help windows are no longer destroyed and rebuilt when you 
navigate from one to another - much faster and smoother.
9.  Several changes to accommodate FreeBSD usage - these would actually
benefit any highly structured package installation scheme, such as Red
Hat's. The primary change is restructuring code so that a single line
near the beginning can be patched to inhibit the Autoinstall logic for
the benefit of package installers.
10. Added Print and Request License function to the Register and Bug
Report windows.

Bug Fixes:

1.  Several bogus things could happen if extracting for viewing failed,
including a tcl error (variable rc was undefined), the Create Archive
window popping up mysteriously (don't ask), and double error messages.
All fixed.
2.  Certain file/directory list widgets wouldn't properly update the
directory list if you manually entered a directory name of "/" - you
had to hit Return a second time. Fixed.
3.  When extracting files that had an absolute pathname, you could get
an overwrite warning for the absolute pathname version of the file,
although what you were about to extract was a relative name (leading
"/" stripped off). Conversely, you might get no warning about the real
file you were about to overwrite. Fixed.
4.  LHarc options were wrong when overwriting a file, and LHarc would
hang waiting for nonexistent terminal input. Fixed.
5.  Prior to this release, extracting files with absolute pathnames
always stripped the leading "/" (the default behavior of tar). The
extract window now has Absolute Path Names and No Path Names options
for those archive programs that support such options. The options are,
obviously, mutually exclusive, and checking neither of them gives the
same behavior TkZip always used to exhibit.


Changes in Release 0.9.11:
--------------------------

1.  Added an Uninstall Package function (to uninstall a package from an
archive, not to uninstall TkZip itself).

2.  Added a Remember Symlinks option (the new default), to cause upward
filelist navigation to retrace the path via symlinks. Prior releases forgot
symlinks, so if you traversed a symlink downward through a path, you 
couldn't navigate back up via the same path.

3.  Added a Relative Pathnames option to the Add to Archive window. The old
handling was never quite satisfactory: if you unchecked "Absolute 
Pathnames", you got a sort-of relative pathname, i.e., relative to the root
directory. This is not what is usually wanted. "Relative Pathnames" (the
new default) produces the most generally useful result - pathnames relative
to the current directory.

Changes in Release 0.9.10:
--------------------------

1.  All windows are now refreshed immediately when you apply appearance
changes.

2.  Corrected a failure to recognize some of the saved appearance settings
on startup.

3.  Fixed a few inconsistencies in color scheme handling.

4.  Switched the order of the "Extract" and "Cancel" buttons on the Extract
window. It was the reverse of the Action-Cancel buttons on all the other
similar file list windows.

5.  Fixed an obscure list-handling bug that caused Change Cache to pop up
an error message telling you to close all open archive windows when, in
fact, they were all closed. 

6.  Corrected erroneous forcing of View Single for tar and lzh files
introduced with spacey filename support.

7.  Fixed broken viewing of a gzip, also introduced with spacey filename
support.

8.  Fixed several malfunctions with simple gzip, bzip2, and compressed
files with spacey filenames.


Changes in Release 0.9.9:
-------------------------

1.  Added buttons to the Scrollbar Appearance window for setting the
scroll-bars for all windows at once to a single color scheme. Previously,
you had to set the scrollbar colors for each window individually.

2.  Fixed a sporadic bug that caused a Tk error trying to refresh a 
directory list widget that had already been destroyed.

3.  More color scheme cleanup, mostly not noticeable, like excising a few
hundred lines of redundant old code. Most noticeable: eliminated the few
cases where the default scheme left listbox selections almost unreadable
because of a white foreground on too light a background.


Changes in Release 0.9.8:
-------------------------

1.  Finished spacey filename support (see 0.9.7 changes). It should now
work with all archive types (provided that your archiving utilities and
your filesystem support them), and the archive itself can also have 
embedded spaces in its filename.

2.  Improved Install procedure and instructions.

3.  Cleaned up several windows that used not to fit on a 640 x 480 screen.

4.  Split the Set Appearance window - scrollbar options now have a separate
window. Added new options, including a "Defaults" option to restore all of
TkZip's appearance defaults.

Changes in Release 0.9.7:
-------------------------

1.  Added some bitmaps to spiff up the appearance a little.

2.  Automated the install procedure, and added some extra files. TkZip now
    needs an install directory (by default, /usr/local/share/TkZip) to 
    store those new bitmaps in. 

3.  Added limited support for Win95 style filenames with embedded spaces.
    So far, this is limited to zip files containing spacey filenames (the
    archive itself can't have spaces in its filename.)

4.  Help is now forward and backward navigable, not just backward, and has
    clickable links between sections.


Changes in Release 0.9.6:
-------------------------

1.  Per user request, I've added this brief README to the distribution, for
    the benefit of those who download it from someplace other than its home
    site. [sigh] Gone is the simple, single file distribution.

2.  The config file has moved, and a new MIME types file has been added. 
    TkZip     now maintains its configuration files in a new directory, 
    $HOME/.TkZip. The two files currently used are TkZip.rc and 
    TkZip.mimetypes. If you had an earlier release, TkZip will copy your 
    existing config file to the new directory and upgrade it to 0.9.6 the
    first time you run it. Your old config file will not be removed, in 
    case you ever want to run an older version (though this is not recom-
    mended).

2.  This version implements MIME style viewing of files within an archive,
    automatically selecting a viewing program appropriate to the type of 
    file. This is much more convenient and flexible than the old style of
    viewer selection, but it results in a bit of a change to the default 
    behavior.

    MIME style viewing is triggered by the "Automatic Viewer Selection" 
    option, which is *on* by default. The old-style viewer selection is 
    only used as a fallback if TkZip can't determine the file type or a 
    program to associate with it. Now, if there is no MIME types file when
    TkZip starts up (and there won't be, if you're just upgrading to this 
    release), it will create a minimal one, just so you can see a couple of
    examples. This default file defines 3 types, image/x-pixmap, image/gif,
    and image/tiff, and associates them all with John Bradley's excellent 
    and ubiquitous xv (if you have it on your system - otherwise you won't
    get any types defined). So, any xpm, GIF, or TIFF files that you select
    for viewing will cause TkZip to try to invoke xv, regardless of what 
    viewer you *thought* was selected. 

    This may not be what you want to happen. If you prefer another program
    for viewing graphic images, select Options -> Edit MIME Types, and 
    change the association to the program you want. If you occasionally 
    want to force TkZip to use a different viewer from the usual one for 
    this type of file, turn off the "Automatic Viewer Selection" option. 
    This will force TkZip to use the old-style, manually-selected viewer.

    Try using the TkZip tarball itself to experiment with these options. 
    By the strangest of coincidences, it just happens to contain a little 
    TkZip icon in each of these 3 image formats.

    The examples in the default MIME types file are intended to illustrate
    the various ways of defining a file type. They are just that, 
    *examples* of what you can do, not models of style (a couple of them 
    are intentionally a bit silly, though they do work); it is intended 
    that you should edit them to suit your needs and taste.

4.  In releases prior to 0.9.6, the manual viewer selection menu had mouse
    button 3 bound to the Delete Viewer function. This was not a 
    particularly Good Thing, since button 3 is everywhere else used for 
    context Help. Delete Viewer is now bound to button 2 (middle button),
    and button 3 does nothing. However, if you have a misbehaving mouse, 
    or a 2-button mouse and an X-server that doesn't properly handle 
    3-button emulation, there is a "Button-3 Viewer Delete" option to 
    restore the old binding (button 2 still continues to delete as well).

5.  The clickable Help Index was added in this release. It's  now much 
    easier to find what you're looking for.

6.  All of the window titles have been changed so that they consistently 
    begin with "TkZip:". This is to simplify life for those who would 
    like to use window manager facilities to associate a particular icon 
    with all windows with titles like "TkZip*".

7.  For the full, historical set of release notes, check the TkZip Web 
    page. Perhaps for the next release I should package the web pages with
    the program.



A Few More Words on MIME Type Viewing:
--------------------------------------

	"MIME type" viewing is a bit of a misnomer: it should probably be
called pseudo-MIME viewing, since it does not involve parsing MIME headers.
However, I used the term to describe the way TkZip will automatically 
select and spawn an appropriate viewer for a file, the way your mail reader
would do. Instead of analyzinging e-mail headers, TkZip uses the file 
command to probe for a recognizable file type; failing this, it will 
optionally fall back on the old "file extension" technique. The file tag 
you supply in your MIME type definition must be a unique string that occurs
in the file command's identification of a particular type of file (leading
and trailing white space will be stripped from whatever you enter).

	You probably ought to use a valid MIME-type designation (like 
image/jpeg or audio/basic or text/html), where one exists, when you name 
your MIME types. But TkZip is not a mail reader, and it is not looking at 
MIME e-mail headers, so this field in the MIME types entry is purely 
documentary. You can call an image/gif a Giffy-pic and TkZip won't mind a 
bit. In fact, you can omit the field, as the program *currently* does 
nothing with it.

	The filename extension field does not currently support a list of
extensions. If you want to use this technique to catch "jpg", "JPG", 
"jpeg", and "JPEG", you'll have to make 4 separate entries. It's much 
better to use the file probe tags.

	To set up the tags properly is going to require a bit of thought 
and ex-perimentation. You need to try out the file command on a variety of
files and see what responses you get, then decide on unique strings to 
identify the types you're interested in. Let's say you try 
"file TkZip01.gif", and get back something like "GIF image data, 
blah-blah-blah". Then you try "file TkZip01.tif", and get back "TIFF 
image data, blah-blah-blah". It might occur to you that "image" would be a
neat way to catch all the graphics images with one entry. As sure as you 
do, you'll find that some joker's put an entry in your magic file for 
"compressed kernel image". Singular words or acronyms like "GIF" or "JPEG"
are probably fine for one-word entries (though I use "JPEG image", etc.), 
but very common words, like "data" or "text", are not. "binary" might just
squeak by, if you want to associate everything that gets this response with
a hex editor; but if you scan all the occurrences of "binary" in your magic
file, you'll probably decide against it.

	There is also an option (Options -> (More) -> Use MIME for All 
Files) to cause TkZip to spawn an external viewer for files selected from 
the main window.




	- Bob Woodside
	4 February, 1998



