view release on metacpan or  search on metacpan

unzip-6.0/wince/punzip.htp  view on Meta::CPAN

<p>The <strong>Overwrite Options</strong> allow you to tell
Pocket UnZip what to do if a file already exists on your file
system with the same name of a file that is about to be
extracted. The choices are:</p>

<ul>
    <li><strong>Prompt to overwrite</strong>: Causes a dialog to
        appear for every situation that involves possibly
        overwriting a file. This allows you to decide what files
        get overwritten on a file-by-file basis. </li>
    <li><strong>Overwrite if newer</strong>: Causes Pocket UnZip
        to automatically overwrite any files that have a date and
        time that is earlier then the date and time of the file
        being extracted. This option can be useful for updating
        files. </li>
    <li><strong>Always overwrite</strong>: Causes Pocket UnZip to
        always automatically overwrite any files without
        prompting or warning. Use with caution. </li>
    <li><strong>Never overwrite</strong>: Causes Pocket UnZip to
        automatically skip all files that already exist on the
        file system.</li>
</ul>

<p>The <strong>Extract To</strong> field specifies the root
directory that should be used to extract files to. If you checked
the <strong>Restore file paths</strong> option, then any
directories associated with the files being extracted will be
created under the directory specified in this field. The
directory you enter must already exist. To create directories and
browse for directories, use the <strong>Browse...</strong>
button.</p>

<p>Once you have chosen the options you wish to use, press the <strong>Extract</strong>
button. A progress dialog will appear and the extraction will
begin. At any time during the extraction, you may tap the <strong>Abort</strong>
button to abort the extraction operation.</p>

<p><strong>Note: Aborting the
extraction operation while processing a file will likely cause a
partial file to get extracted and saved.</strong></p>

<p>During the extraction, you may get interrupted for one of
three reasons. First, if an error occurs, you will be notified
with a message box. Second, if you have chosen the <strong>Prompt
to overwrite</strong> option and you are trying to extract a file
that already exists, you will be prompted on how to handle the
situation. Third, if a file being extracted is encrypted, then
you will be prompted for that file's password (see the <strong>Encrypted
Files</strong> section).</p>

<p>Once the extraction is complete, the <strong>Abort</strong>
button will change to a <strong>Close</strong> button and any
errors or warnings will be displayed. Tap the <strong>Close</strong>
button to return to Pocket UnZip's main screen.</p>

<hr>
<h3>Testing Files</h3>

<p>Testing files is essentially the same as extracting files,
except for that the actual extracted data is never written to
your file system. Testing files is useful when you wish to verify
the integrity of a Zip file without actually extracting the files
within it.</p>

<p>Once you have opened a Zip file into Pocket UnZip, you should
see a list of the Zip file's contents. Select one or more files
from the file list and then choose <strong>Test Selected Files</strong>
(<strong>Ctrl+T</strong>) or <strong>Test All Files</strong> (<strong>Ctrl+A</strong>,
<strong>Ctrl+T</strong>) from the <strong>Action</strong> menu. You may
also use the noted shortcut keys or the associated toolbar
buttons.</p>

<p>A progress dialog will appear and the testing will begin. At
any time during the testing, you may tap the <strong>Abort</strong>
button to abort the testing operation.</p>

<p>During the testing, you may get interrupted for one of two
reasons. First, if an error occurs, you will be notified with a
message box. Second, if a file being tested is encrypted, then
you will be prompted for that file's password (see the <strong>Encrypted
Files</strong> section).</p>

<p>Once the testing is complete, the <strong>Abort</strong>
button will change to a <strong>Close</strong> button and any
errors or warnings will be displayed. Tap the <strong>Close</strong>
button to return to Pocket UnZip's main screen.</p>

<hr>
<h3>Viewing Files</h3>

<p>Pocket UnZip provides the ability to view, or even execute,
files directly from a Zip file. This feature is a major
convenience over having to extract and then manually open each
file you wish to view. Internally, this is what Pocket UnZip is
doing for you, but it takes care of all the work of extracting
the file to a temporary directory, launching the associated
viewer for that file type, and cleaning up when done.</p>

<p>To view a file, simply select a single file from Pocket
UnZip's main file list and press <strong>Enter</strong>. You may also
choose <strong>View Selected File</strong> from the <strong>Action</strong>
menu, press the associated toolbar button, or just double-tap on
the file you wish to view.</p>

<p>The file will be extracted to a directory called<strong>
Temporary Pocket UnZip Files</strong> in the root of your file
system. If the file you wish to view is encrypted, you will be
prompted for a password. If the file has an associated viewer
application installed (such as Pocket Word for .PWD files), then
that viewer will automatically be launched with the newly
extracted file as its command line. If there is no associated
viewer application, then you will be prompted for the application
you wish to use to view the file.</p>

<p>Pocket UnZip also provides minimal support for allowing you to
use the view file action to run executable programs directly from
the Zip file. If the file you choose to view is an executable
(file extension is EXE), then the file will be executed after it
is extracted. Pocket UnZip will only extract the file you select
and none of its dependent files (like DLLs). If the executable
you extract depends on other files in the Zip file, it will most