Copyright: Copyright 1999 Mike White   Tuesday, June 06, 2000 13:04:45
Citation: Wiz Help


What is Wiz
What Is Wiz?

Wiz is a Microsoft Windows application, which extracts, tests, and displays files archived in ZIP archive format, as well as creating archives in the same format. Wiz can show you the difference(s) between archives, either graphically in WizDiff, or by high-lighting the differences in the archive entries. Wiz can also find archives, find files in archives based on a pattern you provide, as well as decode many of the popular e-mail ASCII encoding schemes.

The unzip logic of Wiz is based on Info-ZIP's product unzip, which has been ported to a number of platforms. Likewise, the zip logic is based on Info-ZIP’s product zip.


Info-ZIP's License
Info-ZIP’s License

Copyright (c) 1990-1999 Info-ZIP.  All rights reserved.

For the purposes of this copyright and license, "Info-ZIP" is defined as the following set of individuals:

Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-loup Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler, Antoine Verheijen, Paul von Behren, Rich Wales, Mike White

This software is provided "as is," without warranty of any kind, express or implied.  In no event shall Info-ZIP or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising out of the use of or inability to use this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of conditions.

2. Redistributions in binary form must reproduce the above copyright notice, definition, disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution.

3. Altered versions--including, but not limited to, ports to new operating systems, existing ports with new graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and must not be misrepresented as being the original source.  Such altered versions also must not be misrepresented as being Info-ZIP releases--including, but not limited to, labeling of the altered versions with the names "Info-ZIP" (or any variation thereof, including, but not limited to, different capitalizations), "Pocket UnZip," "WiZ" or "MacZip" without the explicit permission of Info-ZIP.  Such altered versions are further prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s).


Wiz Main Menu

The Wiz Main Menu

The Wiz main menu has the following options:

File	Create/Update/Open archives. Delete archives. Set the Unzip directory. Launch Explorer, and WizDiff.

Edit	Toggle using an external editor when displaying RTF files instead of Wiz’s internal editor.

Archives	Select/deselect files in archive. Select files in an archive by pattern. Delete/update entries in an archive. Extract/display/test archive entries. Get complete, verbose, archive information. Show an archive comment. Grep (find a particular phrase in a file) current archive contents. Find the differences between archives, and display the differences between archives.

Search	Search archives for files of a particular pattern. Scan for archives. Rescan for archives. Search (Grep) all archives in a subdirectory for a pattern in a files contained in an archive.

Options	Sets the options for Wiz.

Window	Clear the message/scan/search windows. Select the MDI windows in the Wiz editor.

Help	Help for Wiz. Information about Wiz


Wiz File Menu

Create/Update Archive…

Open Archive…

Unzip Archive To…

Delete Archive…

Explorer…

ZTDiff…

Exit


Create Archive
File Menu Create Archive

This menu item allows you to create an archive, either a .zip file or a self-extracting archive. Using this option you may also add files to an existing archive, or freshen files already in the archive.

Explanations for each section of the create archive dialog box are below:

 Directories - This is where you choose the directories (folders) you will add files to the archive from.

 Drives - This is where you select the drive you wish to add files from.

 Set Ref/Deselect Ref - Normally the Wiz includes the complete path name for each file put into an archive. By selecting a reference directory, the paths for all files added to the archive are always done in reference to the reference directory.

For example: If you have selected directory c:\MyDirectory as the reference directory, and you add MyFile.txt files from each of the following directories c:\MyDirectory, c:\MyDirectory\MySubDirectory, and c:\MyOtherDirectory to an archive, you will find in your archive the following files:

MyFile.txt

MySubDirectory\MyFile.txt

\MyOtherDirectory\MyFile.txt

Note that the drive letters are never saved.

 Select All/Deselect All - Select/Deselect all files in the list box below.

 File Name - Type in the file pattern of the files you wish to see appear in the list box below, then press enter. Only files matching the pattern will appear in the list box. You may now select as many of the files as you wish, then press >>Add>> to include them in the archive.

 Recurse/Include Pattern - File pattern to search for when the Recurse or Include buttons are pressed.

 Options - Lets you set temporarily set the zip options for creating/updating an archive. Note that by pressing this button, you will also have access to the unzip/general and sound options. Any changes to these other options will have the same effect as if you had selected them from the main options menu item, in other words, those options will be remembered.

 Recurse - This causes Wiz to search for files matching the pattern put in the Recurse/Include Pattern box, not only in the current directory, but also in the sub-directories below that directory.

 Include - This causes Wiz to search for files matching the pattern put in the Recurse/Include Pattern box, only in the current directory. This is actually an alternative to putting the same pattern in the File Name box, pressing enter, Selecting All, then selecting >>Add>>.

 >>Add>> - Pressing this button causes all files selected in the file selection box to be transferred to the collection list box for adding to the archive when the OK button is pushed.

 <<Delete<< - Pressing this button causes all files selected in the collection list box to be deleted from the collection list box. This particular files will be now not be added to the archive.

 OK - If files have been placed into the collection list box, then pressing this button will cause the archive to be created. If nothing is in the collection list box, pressing this button has the same effect as pressing the cancel button.

 Cancel - Pressing this button cancels creating/updating the archive.


Open Archive
File Menu Open Archive

This menu item allows to you open an existing archive, either a .zip file, a self-extracting archive archive. Once the archive is open, you may extract, test, or display files in the archive, as well as view any archive comments.


Unzip Archive To
File Menu Unzip Archive To

This menu item allows you to determine what directory archives are to use to unzip files in. The title bar of the Wiz shows you at all times what the target unzip directory is.


Delete Archive
File Menu Delete Archive

This menu item allows you to delete the current archive. You will be asked to confirm that you want to delete the archive before actually doing so.


Explorer
File Menu Explorer

This menu item allows you to launch Microsoft’s Explorer. If, for some reason, Explorer is not present on your system, this menu item will not be available.


WizDiff
File Menu WizDiff

This menu item allows you to launch WizDiff. If, for some reason, WizDiff is not present on your system, this menu item will not be available.

WizDiff is based on WinDiff, an example program from Microsoft.

WizDiff by itself can display the differences between two files, or between two directories. In conjunction with Wiz, it can also display the differences between two archives.


Exit
File Menu Exit

This menu item allows you to exit the Wiz. Any files that are open in the Wiz editor will not be saved. If you have launched WizDiff through the Wiz, then will also be closed by the Wiz.


Wiz Edit Menu

Use external editor for RTF files.

The editor being used for the Wiz does not have the capability to interpret all rich text formatting commands. When rich text format (RTF) files have formatting that the Wiz editor does not understand, it simply discards them, unfortunately without warning. If you have RTF files that have such things as footers, you must use an external word processor to display them completely.

Selecting the “Use external editor for RTF files” option enables you to use whatever word processor is associated with the RTF file type to look at these files.


Wiz Archive Menu
Wiz Archives Menu

Select All Files

Deselect All Files

Select Files by Pattern…

Delete Entries in Archive

Update Entries in Archive…

Extract

Display

Test

Complete Archive Information.

Show Zip Comment

Grep Archive Contents

Find Difference between Archives…

Display Archive Differences


Select All Files
Archives Menu Select All Files

Selects all files in the current archive.


De-select All Files
Archives Menu Deselect All Files

De-selects all files in the current archive.


Select files by pattern
Archives Menu Select Files by Pattern

This menu item allows you to select (or deselect) files in the current archive by pattern. You are not limited to one pattern, but may continue (de-) selecting until you have achieved the desired result.


Delete Archive Entries
Archives Menu Delete Entries in Archive

This menu item allows you to remove the selected entries in the current archive. You will be asked to confirm this deletion before it takes effect.


Update Archive Entries
Archives Menu Update Entries in Archive

This menu item allows you to update the selected (highlighted) entries in the current archive.


Extract
Archives Menu Extract

This menu item extracts all selected files in the current archive to the directory shown on the title bar of Wiz.


Display
Archives Menu Display

This menu item will display the selected files in the current archive. If a file cannot be displayed by Wiz for some reason, it will attempt to open the file using the application that is associated with that particular file extension. If the file is an executable, then Wiz will execute it. If the file is another archive, then it will be shown as an additional archive.

This process may result in temporary files in the Windows temp directory. These files will be deleted when the Wiz terminates.


Test
Archives Menu Test

This menu item will test the selected files in the current archive to insure they are not corrupted.


Information on Archive
Archive Menu Complete Archive Information

This menu item will give you information of the following type for each selected entry in the archive:

End-of-central-directory record:

  Actual offset of end-of-central-dir record:        1232 (000004D0h)

  Expected offset of end-of-central-dir record:      1232 (000004D0h)

  (based on the length of the central directory and its expected offset)

  This zipfile constitutes the sole disk of a single-part archive; its

  central directory contains 1 entry.  The central directory is 53

  (00000035h) bytes long, and its (expected) offset in bytes from the

  beginning of the zipfile is 1179 (0000049Bh).

  There is no zipfile comment.

Central directory entry #0:

  about.c

  offset of local header from start of archive:     0 (00000000h) bytes

  file system or operating system of origin:        NTFS

  version of encoding software:                     2.1

  minimum file system compatibility required:       MS-DOS, OS/2 or NT FAT

  minimum software version required to extract:     2.0

  compression method:                               deflated

  compression sub-type (deflation):                 normal

  file security status:                             not encrypted

  extended local header:                            no

  file last modified on (DOS date/time):            1997 Aug 29 10:48:00

  32-bit CRC value (hex):                           f6d5c3a7

  compressed size:                                  1142 bytes

  uncompressed size:                                3458 bytes

  length of filename:                               7 characters

  length of extra field:                            0 bytes

  length of file comment:                           0 characters

  disk number on which file begins:                 disk 1

  apparent file type:                               text

  non-MSDOS external file attributes:               81B600 hex

  MS-DOS file attributes (20 hex):                  arc

  There is no file comment.


Comment
Archive Menu Show Zip Comment

This menu item will display a zip file comment if there is one present. If a comment is not present, this menu item will be disabled.


Search (Grep) Archive Contents
Archive Menu Grep Archive Contents

This menu item allows you to search in files of a given pattern in the current archive for a particular pattern of characters. If the pattern is found in a particular file, that file will be highlighted.


Archive Differences
Archive Menu Find Differences Between Archives

This menu item allows you to compare two archives to find any differences between them. Any files that differ between the two archives will be highlighted. The two archive windows being compared will be tiled vertically, all other open archive windows will be minimized.


Archive Differences Displayed
Archive Menu Display Archive Differences

This menu item uses WizDiff to display the difference between two archives.

WizDiff is derived from sample source code provided by Microsoft Corporation.

There will be temporary directories created off the directory Wiz is located in. These directories will be removed upon exiting Wiz.


Wiz Search Menu

Search Archives…

Scan for Archives…

Search (Grep) Archives for Pattern…


Search in Archives
Search Menu Search Archives

Search archives in a given directory for files of a particular pattern. Optionally, you may search archives in subdirectories below the given directory.


Scan for Archives
Search Menu Scan For Archives

Find all archives (either .zip or self-extracting archives) in a given directory. Optionally, you may search for archives in subdirectories below the starting directory.


Search (Grep) Archive Contents
Search Menu Search (Grep) Archives for Pattern

Search all archives in a given directory for files of a particular pattern (i.e., *.c etc) – Look in each of those files for the given pattern. If the pattern is found, list the file and archive in the Search in Archives tab.


Wiz Options Menu

Wiz Options – Sets the options for sound, displaying, archiving and extracting.

Unzip Options

Zip Options

Sound Options


Unzip Options

File Extraction Section:

This section determines when to overwrite a file when extracting from an archive.

 Always Overwrite - Always overwrites the file without any notification to the user.

 Prompt to Overwrite - Always prompt the user to overwrite the file.

 Only when newer - Only prompt the user when the existing file is newer than the archived file.

Listbox Section:

 Extracts - A double mouse click, with one or more files selected in an archive list box, will extract the selected files to the extraction directory. Use the shift and control keys to control multiple selections.

 Displays - A double mouse click, with one or more files selected in an archive list box, will display the selected files in the Wiz editor. Use the shift and control keys to control multiple selections.

 Tests - A double mouse click, with one or more files selected in an archive list box, will test the selected files, and display the results in the messages window. Use the shift and control keys to control multiple selections.

General Section:

 Recreate Directories - If this option is checked, Wiz will create any directories required to retain the entire path of an archived file.

 Convert LF -> CR/LF - Some text files, particularly those created (or modified) on UNIX systems, do not have a CR/LF at the end of each line. In the DOS and Windows world it is much more normal to find a CR/LF in those types of files. Although in the vast majority of cases, this has little or no effect, in a very few it may. To get around this potential problem, you have the capability to automatically convert LFs to CR/LFs.

This is an extremely dangerous option, and should never be used with any file other than a plain text file, or you may very well corrupt the file to the point of being unusable.

 Space -> To Underscore - When a file has spaces in its file name, selecting this option will automatically convert those spaces to underscores. On 32 bit systems such as Windows 95 and Windows NT, there is not much need for this option.

 Restore ACLs - An access-control list (ACL) contains information that controls access to a file or controls auditing of attempts to access a file. This information may be stored in a zip archive, and if so, the ACLs may be restored if you are using Windows NT. If you are running on NT and don’t understand what the implications of using this are, don’t do it.

 Use privileges - This is related to the restoration of ACLs. As with that option, if you don’t understand what this means, don’t use it. In actual practice, to be able to use this option, you would probably have to have administrator’s rights. An administrator should understand what is happening here.

 Recurse on searches - If this option is selected, whenever Wiz searches for archives, it will not only search in the directory (folder) that you designate, it will also search in any sub-directories (folders) of the originally designated folder. This can result in significantly longer searches, depending on the number of files in those sub-directories.

For example, if you have this option selected, and you designate the root directory of your ‘C’ drive (C:\) as the starting directory, Wiz will examine every archive and every executable on your entire ‘C’ drive. Depending on the number of files on your ‘C’ drive, this could take a significant amount of time.

 Scan for archives when loading - Automatically give the user the option to look for archives and put them in the Scan for Archives list box every time Wiz is loaded.

Directories Section:

 Remember Unzip To Dir - Always save the last unzip to (unzip target) directory.

 Remember Unzip From Dir - Always save the last directory an archive was opened in.

 Remember Zip To Dir - Always save the last directory an archive was created in. This directory will be displayed on the Wiz main title bar.

 Unzip To Zip Dir - Extract files to the same directory the zip archive is in.


Zip Options

 Freshen changed files - Update an archive entry only if the file in the archive is older than the file on disk. If this option is checked, you do not need to have selected files to add to the archive, and in fact if you do attempt to add files to the archive, they will be ignored.

 Update changed files - This is virtually identical to freshening changed files above, with the exception that you must add files to the archive, or nothing will be done to the archive.

 Include system/hidden files - Include any system or hidden files that match the file patterns in the archive.

 Force MSDOS file names - When placing files in the archive, force using the old 8.3 file naming convention.

 Move file into archive - After successfully moving the file into an archive, delete the file.

 Zip file time to latest file - Change the file time of the zip archive to the time of the latest file in the archive.

 Convert LF -> CR/LF - Some text files, particularly those created (or modified) on UNIX systems, do not have a CR/LF at the end of each line. In the DOS and Windows world it is much more normal to find a CR/LF in those types of files. Although in the vast majority of cases, this has little or no effect, in a very few it may. To get around this potential problem, you have the capability to automatically convert LFs to CR/LFs.

This is an extremely dangerous option, and should never be used with any file other than a plain text file, or you may very well corrupt the file to the point of being unusable.

 Convert CR/LF -> LF - Some text files, particularly those created (or modified) on UNIX systems, do not have a CR/LF at the end of each line. In the DOS and Windows world it is much more normal to find a CR/LF in those types of files. Although in the vast majority of cases, this has little or no effect, in a very few it may. To get around this potential problem, you have the capability to automatically convert CR/LFs to LFs.

This is an extremely dangerous option, and should never be used with any file other than a plain text file, or you may very well corrupt the file to the point of being unusable.

 Add comment - Add a comment to the archive file.

 Include files before date - Include in the archive only those files whose file dates are prior to the given date.

 Exclude files after date - Do not put in the archive any files whose file date is later than the given date.

 Save ACLs - An access-control list (ACL) contains information that controls access to a file or controls auditing of attempts to access a file. This information may be stored in a zip archive, and if so, the ACLs may be restored if you are using Windows NT. If you are running on NT and don’t understand what the implications of using this are, don’t do it.

 Exclude extra attributes - Do not preserve any extra file attributes associated with the files. You will probably never need this option.

 No directory entries - Do not save directory entries. The default is to put directory entries into the zip archive in order to store their attributes.

 Ignore directory names - Do not save the full path and file name into the archive, but rather just save the file name.

 Include volume label - Include the volume label of the disk drive in the archive. There is rarely any need for this option.

 Verbose Operation - Much more wordy messages.

 Quiet Operation - Very little information in messages.

 Make 32 bit Self-Extracting Archive - Create a 32 bit self-extracting archive. This will add approximately 100K to the size of your archive and will run only on 32 bit Windows. This will preserve long file names upon extraction.

 Make DOS Self-Extracting Archive - Create a 16 bit self-extracting archive. This will add approximately 42K to the size of your archive and should run on any machine capable of executing DOS programs. Extraction of long files from an archive will result in the names being converted to the older DOS style 8.3 format.

 Adjust entries for SFX - Adjust the offsets of entries in an archive for the self extracting prefix.

 Repair archive - Try to fix an archive.

 Repair archive (desperate) - Try to fix an archive even harder.

 Compression - Select the compression level you want. 0 = no compression; 6 = default; and 9 = maximum compression.


Sound Options

 No Sound - No sounds are to be used while extracting files.

 Beep afterward - Beep on the computer’s internal speaker after extracting a file.

 Play Sound During - Not enabled unless your system has a sound card. Play a sound file while extracting files from an archive.

 Play Sound Afterward - Not enabled unless your system has a sound card. Play a sound file after extracting files from an archive.

 Sound name or file - Not enabled unless your system has a sound card. The name of the sound file to play.

 Play - Not enabled unless your system has a sound card. Test the sound of the sound file you have selected.

 Browse - Not enabled unless your system has a sound card. Look for sound files (*.wav)


Wiz Window Menu

Clear Message Window

Clear Scan Window

Clear Search Window

Tile Horizontal

Tile Vertical

Cascade

Arrange Icons

Close All


Clear Message Window
Window Menu Clear Message Window

Erase (clear) contents of message window.


Clear Scan Window
Window Menu Clear Scan Window

Clear contents of Scan for Archives tab.


Clear Search Window
Window Menu Clear Search Window

Clear contents of the Search for Archives tab.


Tile Horizontal
Window Menu Tile Horizontal

Tile all archive windows horizontally.


Tile Vertically
Window Menu Tile Vertically

Tile all archive windows vertically


Cascade
Window Menu Cascade

Cascade all archive windows.


Arrange Icons
Window Menu Arrange Icons

Arrange the archive window icons.


Close Archive Windows
Window Menu Close All

Close all archive windows.


Wiz Help Menu

Wiz Help

Using Windows Help

About Wiz…


Help
Help Menu Wiz Help

This help file.


Help with Windows Help
Help Menu Windows Help

Help on using Windows Help.


About Wiz
Help Menu About Wiz

Information concerning the current version of Wiz, acknowledgements, contacting the author, etc.


Wiz Editor

The Wiz Editor is shown below. It is very similar in operation to Microsoft Windows’s Notepad or WordPad, with the exception that it has a multiple document interface (MDI) that neither Notepad or WordPad have.

In addition to it’s Notepad and WordPad capabilities, the Wiz editor can also be used to display text and rich text format files contained within archives. Once these files are in the editor, they may be saved to disk, modified etc., just as you would in any editor. However, you may not automatically insert these files back into the archive.

The Wiz Editor is derived from sample source code provided by Microsoft Corporation.