First version: 17 January 2003
Last updated for version 2.00 on: 12 September
2003
1.0 What is jZip?
jZip is a small freeware zip utility written
in Personal Java. It will allow you to zip or unzip files directly
on your P800, Nokia 9210/9290 or Psion 5mx, 7, netBook. The latest
version of the program will always be available from http://www.freepoc.org.
1.1 Why use jZip?
Zip files are a popular and efficient way of distributing information, particularly over the Internet. With jZip on your Symbian machine, you are able to unzip attachments which have been sent to you via email or or zip files which have been downloaded from the Web. You can also create new zip files and update them.
Like all FreEPOC's software, jZip is free
:-)
1.2 Installing Java and jZip
In order to run jZip, your computer has to have a Java runtime which conforms to or exceeds the Personal Java standard. Brief details are as follows:
PCs running MS Windows: some PCs may already have Java installed. To check, try double-clicking the file jZip.jar in Windows Explorer. If jZip does not run then go to the Java homepage (http://java.sun.com) and download the Java Standard Edition (J2SE). You only need the JRE runtime environment, not the full SDK. It is free.
P800 / Nokia 9210: the Java runtime is already installed.
Other computers: (to be added later)
Once you have a Java runtime on your machine, you can install jZip as follows:
PCs running MS Windows: copy the file jZip.jar to any directory. Double-clicking on this file in Windows Explorer will launch jZip. You can set up a Windows shortcut to launch the program from the main screen.
P800 / Nokia 9210 / Psion: connect your P800/9210 to your PC and double-click on the relevant SIS file.
Other computers: (to be added later)
1.3 Using jZip to unzip files
Open a zip file using the Open Zip menu option. The contents of the archive will be displayed on the screen. If you wish to extract all the files in the archive then choose Extract All. Otherwise select specific files by tapping on them and then choose Extract Selected. When you have finished, choose Close.
By default, files are extracted to the
directory c:\jZip\. You can change this using the Preferences option.
Make sure you specify a valid directory which ends with a backslash character.
1.4 Using jZip to zip files
Go to the menu and select the New Zip option.
You will be asked to specify a name for the zip. Now you can use
the Add File, Add Directory and Delete Selected options to update your
zip file. Note: when using the Add Directory menu option,
select a filename in the file selector dialog and all the files in the
same directory will be added to the zip.
1.5 Using directories in your zip file
In the Preferences menu option, you will see a Extract To dialog. The choices are the default directory (as shown in the next dialog) or the current directory (where the zip file resides). Files that you extract are placed in these directories (or subdirectories thereof).
There is also a Directories dialog. This option controls the way that directories are added to, or extracted from, a zip as follows:
(a) None. No directories will
be used.
(b) Absolute. The full pathname
will be included when adding files to the zip. Similarly, the full
pathname will be added to the default or current directory when extracting
files.
(c) Relative. The files will be
added with pathnames that take account of the relative location of the
zip file. The same applies to files that are extracted from the zip.
Example
Option (a) will add the file myfile
with no pathname. Option (b) will add the file as \dir1\dir2\myfile.
Option (c) will add the file as \dir2\myfile, since it takes account of
the zip file being in directory c:\dir1\. A similar logic is applied
when files are being extracted.
1.6 Note for Nokia 9210/9290 users
Since jZip is a Java program, you will
need to ensure there is enough available memory. Consider closing
down other applications before running jZip. If you wish to extract
all the files in the zip, just press CTRL+X. In order to select particular
files to extract, you will need to enable the pointer (CTRL+Menu).
Then select the files you wish to extract by moving the pointer to them
and pressing Enter, followed by CTRL+Y.
Note: jZip uses standard Java classes
to create zip files. Some older zip programs have difficulty reading
these files. If your PC zip program cannot read jZip's files, please
consider upgrading to a later version.
Enjoy the program :-)
Malcolm Bryant
malcolm@freepoc.org