gviewzip README
---------------
	Since you are reading this file, you should have unzipped the gvzsrc.zip file.	Read the COPYING file before you proceed.

What is gviewzip?
	gviewzip is a GNOME application which acts as a graphical interface, for the unzip program by Info-ZIP. (I have got to do nothing with Info-ZIP. The bug reports, comments etc. about gviewzip should be sent to hansprog@yahoo.com and those about unzip should be sent to Info-ZIP.)

Should I compile gviewzip to get the binary?
	For those who have difficulty compiling the source, I have included the binary gviewzip along with the source files. The script checkmachine can be used to check if gviewzip would work on your system. 

How do I compile gviewzip?
	To compile the soruce, use the commands

	./configure
	make

You will end up with the binary, gviewzip. 

How do I install gviewzip?
	Double click user's Home icon on the desktop and browse to the directory containing the zip file you downloaded, right click and select Open With->An Application... A dialog box will be displayed. Click the OK button. Another dialog box will be displayed. (Or double click Start Here on the desktop->Programs->Settings->File Types and Programs.) Click the radio button "Open With Application" and then click "Edit List". Another dialog box will be displayed. Click the "Add Application..." button. Another dialog box will be displayed. Enter gviewzip in the "Application Name" text box. Enter the path of gviewzip binary in the "Application Command" text box. Click the "Can open multiple files" checkbox. Click the OK button in the three dialog boxes. (Otherwise, ask somebody to make gviewzip the default application to open .zip files.)

What is the advantage of using gviewzip?
	If you have a collection of zip files and you want to browse them, gviewzip can be really useful. Just double clicking a zip file will open a window showing the list of compressed files in the zip file. Double cliking a file in the list will open it in an editor you specify. There is no need to extract files or delete the extracted files. gviewzip will do that for you automatically.

gviewzip shows a dialog box during startup. What should I do?
	gviewzip is asking for the name of the editor with which you want to open compressed files. Enter the name of your favourite editor in the combo box and click OK. You have to specify the filename of the editor starting from /. You can change the editor using the Settings->Preferences... menu item.

I entered vi (or any command line editor) as the editor. When I double click on a compressed file nothing happens.
	You have to use a graphical editor like gedit.

gviewzip shows an error message saying "/tmp/ not found"
	gviewzip extracts the compressed files to /tmp/ directory. /tmp/ should exist and should be writeable.

gviewzip show an error message saying "Could not open the zip file"
	The zip file may be corrupted or encrypted or it may not be a zip file at all.

gviewzip shows an error message saying "Cannot view encrypted files"
	gviewzip does not support decryption.

gviewzip asks "Temporary file already exists. Overwrite?"
	The path to which the file is going to be extracted already exists. Maybe you have opened the same zip file in two seperate windows. Exit all instances of gviewzip and rename or remove the /tmp/gviewzip_files directory if necessary.

During startup, gviewzip shows an error message saying that "/usr/bin/unzip not found". But I can see the compressed files in the zip file in the background.
	gviewzip uses /usr/bin/unzip to extract compressed files. It directly parses the zip file to find out the compressed files, which is why you can see the compressed files in the zip file in the background.

When I click OK in the select editor dialog, gviewzip shows an error message that "You cannot execute the file"
	Check if you have execute permission for the editor you specified. 

I do not know the filename of any editor.
	In the GNOME menu, right click on the menu item in the main menu for the graphical editor you use. In the Command text box, you will find the filename of the executable. The executable is most likely in the /usr/bin or /usr/bin/X11 directory.

I have a zip file with an extension other than .zip. Can I open it using gviewzip?
	Yes. Run gviewzip from the command line with the name of the zip file as argument or run gviewzip without using any command line argument and use File->Open.

Should I close a zip file before opening another?
	No. When you open a new zip file, gviewzip automatically closes the currently open zip file.

What other features does gviewzip have?
	You can sort the compressed files in any order by clicking the column title. Clicking the same column title again would sort the column ascending or descending. You can see the number of compressed files and the total size of uncompressed files using Edit->Properties menu item. You can see more error messages if you run the program from the command line. So if the program does not seem to work, try running it from the command line.

How was gviewzip developed?
	gviewzip was developed using KDevelop 2.0 under Red Hat Linux 7.2. ddd and gdb were used at times for debugging.
