Subversion Repositories Kolibri OS

Rev

Blame | Last modification | View Log | Download | RSS feed

  1. <html>
  2. <head>
  3. <title>Pocket UnZip</title>
  4. </head>
  5. <body>
  6.  
  7. <h2>Pocket UnZip</h2>
  8.  
  9. <hr>
  10. <h3>Table of Contents</h3>
  11.  
  12. <ul>
  13.     <li>Why use Pocket UnZip for Windows CE?</li>
  14.     <li>Key Features of Pocket UnZip</li>
  15.     <li>Installing Pocket UnZip</li>
  16.     <li>Opening a Zip File</li>
  17.     <li>Zip File Listing</li>
  18.     <li>Properties Dialog</li>
  19.     <li>File Comments</li>
  20.     <li>Extracting Files</li>
  21.     <li>Testing Files</li>
  22.     <li>Viewing Files</li>
  23.     <li>Encrypted Files</li>
  24.     <li>About Pocket UnZip</li>
  25. </ul>
  26.  
  27. <hr>
  28. <h3>Why use Pocket UnZip for Windows CE?</h3>
  29.  
  30. <ul>
  31.     <li>Your H/PC can now read the number one file format used
  32.         for Internet downloads.</li>
  33.     <li>Software venders can now distribute their Windows CE
  34.         applications in a single compressed Zip file. </li>
  35.     <li>Maximize your PCMCIA flash card ram storage by zipping up
  36.         files to take with you on the road.</li>
  37. </ul>
  38.  
  39. <hr>
  40. <h3>Key Features of Pocket UnZip</h3>
  41.  
  42. <ul>
  43.     <li>Handles all files created with a Zip compatible
  44.         compression utility. This includes utilities from PKWARE,
  45.         Info-ZIP, and many others. </li>
  46.     <li>Easy to use graphical interface that closely resembles
  47.         the Windows CE Explorer. </li>
  48.     <li>Displays a detailed list of Zip file contents, including
  49.         name, date, size, attributes, and compression statistics
  50.         of each file. </li>
  51.     <li>Displays comments for the each file within the Zip file,
  52.         as well as the main comment for the Zip file itself. </li>
  53.     <li>Supports the ability to test files, extract files, and
  54.         view files directly from the Zip file. </li>
  55.     <li>Supports decryption of password encrypted Zip files. </li>
  56.     <li>It's free!</li>
  57. </ul>
  58.  
  59. <hr>
  60. <h3>Installing Pocket UnZip</h3>
  61.  
  62. <p>Place <strong>PUNZIP.EXE</strong> and <strong>PUNZIP.HTP </strong>(optional
  63. help file) into your <strong>\Windows</strong> directory on your
  64. H/PC.</p>
  65.  
  66. <p>From your H/PC's <strong>Start Menu</strong>, choose <strong>Run...</strong>,
  67. enter &quot;<strong>punzip</strong>&quot;, and tap <strong>OK</strong>.</p>
  68.  
  69. <p>The first time you run Pocket UnZip, it will register itself
  70. as the application for handling Zip files. From then on, you can
  71. just double-tap on Zip files in Explorer or from your Desktop to
  72. open them in Pocket UnZip.</p>
  73.  
  74. <hr>
  75. <h3>Opening a Zip File</h3>
  76.  
  77. <p>There are several ways to open a Zip file.</p>
  78.  
  79. <ul>
  80.     <li>Double-tap on a Zip file in Windows CE Explorer or from
  81.         your Windows CE desktop. </li>
  82.     <li>From within Pocket UnZip, choose the <strong>Open...</strong>
  83.         command from the <strong>File</strong> menu. You may also
  84.         tap the <strong>Open</strong> toolbar button or press <strong>Ctrl+O</strong>.
  85.     </li>
  86.     <li>Pocket UnZip keeps track of the four most recently opened
  87.         Zip files. You may quickly open one of these recent files
  88.         by selecting the Zip file directly from Pocket UnZip's <strong>File</strong>
  89.         menu.</li>
  90. </ul>
  91.  
  92. <hr>
  93. <h3>Zip File Listing</h3>
  94.  
  95. <p>Pocket UnZip's main view displays a list of files,
  96. directories, and volume labels that are stored within the
  97. currently loaded Zip file. This list can be displayed in two
  98. modes, normal and expanded. The normal mode is sufficient for
  99. most users. It contains the following information for every item
  100. in the Zip file:</p>
  101.  
  102. <ul>
  103.     <li><strong>Name</strong>: Name and path of the compressed
  104.         file, directory, or volume label.</li>
  105.     <li><strong>Size</strong>: Size, in bytes, that the item
  106.         requires when uncompressed.</li>
  107.     <li><strong>Type</strong>: Type of item.</li>
  108.     <li><strong>Modified</strong>: Date and time that the item
  109.         was last modified.</li>
  110. </ul>
  111.  
  112. <p>Expanded mode contains all the above information, plus the
  113. following additional information:</p>
  114.  
  115. <ul>
  116.     <li><strong>Attributes</strong>: Attributes of the item.
  117.         <ul>
  118.             <li><font face="Courier New"><strong>V</strong></font>:
  119.                 Volume label</li>
  120.             <li><font face="Courier New"><strong>D</strong></font>:
  121.                 Directory</li>
  122.             <li><font face="Courier New"><strong>R</strong></font>:
  123.                 Read-only file</li>
  124.             <li><font face="Courier New"><strong>A</strong></font>:
  125.                 Archive file</li>
  126.             <li><font face="Courier New"><strong>H</strong></font>:
  127.                 Hidden file</li>
  128.             <li><font face="Courier New"><strong>S</strong></font>:
  129.                 System file</li>
  130.             <li><font face="Courier New"><strong>E</strong></font>:
  131.                 Encrypted (this file will require a password)</li>
  132.             <li><font face="Courier New"><strong>C</strong></font>:
  133.                 Comment (this item has a comment)</li>
  134.         </ul>
  135.     </li>
  136.     <li><strong>Compressed</strong>: Compressed size, in bytes,
  137.         of the item.</li>
  138.     <li><strong>Ratio</strong>: Compression ratio of the item.</li>
  139.     <li><strong>Method</strong>: Compression method used to
  140.         compress the item.</li>
  141.     <li><strong>CRC</strong>: 32 bit Cyclic Redundancy Check
  142.         signature of the item.</li>
  143.     <li><strong>Comment</strong>: Optional comment string that
  144.         was associated with the item when compressed.</li>
  145. </ul>
  146.  
  147. <p>You may toggle between the normal view and the expanded view
  148. by selecting the <strong>Extended View</strong> option from the <strong>View</strong>
  149. menu, or by tapping the associated toolbar button.</p>
  150.  
  151. <hr>
  152. <h3>Properties Dialog</h3>
  153.  
  154. <p>The properties dialog is useful for viewing detailed
  155. information for one or more files. It is invoked by selecting one
  156. or more files in the file list and then choosing <strong>Properties</strong>
  157. from the <strong>File</strong> menu. For convenience, you can
  158. also tap the toolbar button or press <strong>Alt+Enter</strong>.</p>
  159.  
  160. <p>If one file is selected, the properties dialog will show you
  161. detailed information about that one file and its comment.</p>
  162.  
  163. <p>If multiple files are selected, the dialog will show you
  164. combined results for all the files selected. Cumulative results
  165. will be given for the file count, byte counts, and compression
  166. ratio. Merged results will be given for the compression method,
  167. date, CRC, attributes, and comment. For the date, all values that
  168. are common between the selected files (such as year), will be
  169. shown with their common value. All values that differ between the
  170. selected files will be shown as question marks. For attributes, a
  171. black check means that all selected files have that particular
  172. attribute, a gray check mark means that some of the selected
  173. files have that attribute, and no check mark means that none of
  174. the selected files have that attribute.</p>
  175.  
  176. <p>By using the properties dialog with multiple files, you can
  177. determine things like... What is the total number of files or
  178. bytes in the Zip file? What is the total compression ratio for
  179. all selected files. Are all the selected files from the same
  180. year? Same month? How many files have comments?</p>
  181.  
  182. <hr>
  183. <h3>File Comments</h3>
  184.  
  185. <p>Zip files provide two levels of commenting. At compression
  186. time, users can add per-file comments, as well as one main
  187. comment for the entire Zip file. The per-file comments are
  188. usually used to give a short description of each file. The main
  189. comment is usually used for credits, copyright information,
  190. installation instructions, version numbers, etc. Pocket UnZip
  191. can display both types of comments. </p>
  192.  
  193. <p>Per-file comments can be viewed in Comments column of the main
  194. file list while in expanded mode (see the <strong>Zip File Listing</strong>
  195. section) and also in the properties dialog (see the <strong>Properties
  196. Dialog</strong> section).</p>
  197.  
  198. <p>The main Zip file comment can be viewed by selecting <strong>Zip
  199. File Comment</strong> from the <strong>View</strong> menu or by
  200. pressing the associated toolbar button. This option will be
  201. disabled if the Zip file does not contain a main comment.</p>
  202.  
  203. <hr>
  204. <h3>Extracting Files</h3>
  205.  
  206. <p>Once you have opened a Zip file into Pocket UnZip, you should
  207. see a list of the Zip file's contents. Select one or more files
  208. from the file list and then choose <strong>Extract Selected Files</strong>
  209. (<strong>Ctrl+E</strong>) or <strong>Extract All Files</strong> (<strong>Ctrl+A</strong>,
  210. <strong>Ctrl+E</strong>) from the <strong>Action</strong> menu. You may
  211. also use the noted shortcut keys or the associated toolbar
  212. buttons.</p>
  213.  
  214. <p>An extract options dialog will appear showing you some
  215. statistics about the files you are about to extract and prompting
  216. you for some information. There are three options available to
  217. you.</p>
  218.  
  219. <p>The <strong>Restore file paths</strong> option allows you to
  220. control whether the directory structure of the files you have
  221. selected to extract will be preserved. When this option is
  222. checked, any directory paths associated with the compressed files
  223. will be created, and the file will be extracted to the newly
  224. created directory. If this option is not checked, all files will
  225. be extracted to a single directory, regardless of any path
  226. information associated with the compressed files.</p>
  227.  
  228. <p>The <strong>Overwrite Options</strong> allow you to tell
  229. Pocket UnZip what to do if a file already exists on your file
  230. system with the same name of a file that is about to be
  231. extracted. The choices are:</p>
  232.  
  233. <ul>
  234.     <li><strong>Prompt to overwrite</strong>: Causes a dialog to
  235.         appear for every situation that involves possibly
  236.         overwriting a file. This allows you to decide what files
  237.         get overwritten on a file-by-file basis. </li>
  238.     <li><strong>Overwrite if newer</strong>: Causes Pocket UnZip
  239.         to automatically overwrite any files that have a date and
  240.         time that is earlier then the date and time of the file
  241.         being extracted. This option can be useful for updating
  242.         files. </li>
  243.     <li><strong>Always overwrite</strong>: Causes Pocket UnZip to
  244.         always automatically overwrite any files without
  245.         prompting or warning. Use with caution. </li>
  246.     <li><strong>Never overwrite</strong>: Causes Pocket UnZip to
  247.         automatically skip all files that already exist on the
  248.         file system.</li>
  249. </ul>
  250.  
  251. <p>The <strong>Extract To</strong> field specifies the root
  252. directory that should be used to extract files to. If you checked
  253. the <strong>Restore file paths</strong> option, then any
  254. directories associated with the files being extracted will be
  255. created under the directory specified in this field. The
  256. directory you enter must already exist. To create directories and
  257. browse for directories, use the <strong>Browse...</strong>
  258. button.</p>
  259.  
  260. <p>Once you have chosen the options you wish to use, press the <strong>Extract</strong>
  261. button. A progress dialog will appear and the extraction will
  262. begin. At any time during the extraction, you may tap the <strong>Abort</strong>
  263. button to abort the extraction operation.</p>
  264.  
  265. <p><strong>Note: Aborting the
  266. extraction operation while processing a file will likely cause a
  267. partial file to get extracted and saved.</strong></p>
  268.  
  269. <p>During the extraction, you may get interrupted for one of
  270. three reasons. First, if an error occurs, you will be notified
  271. with a message box. Second, if you have chosen the <strong>Prompt
  272. to overwrite</strong> option and you are trying to extract a file
  273. that already exists, you will be prompted on how to handle the
  274. situation. Third, if a file being extracted is encrypted, then
  275. you will be prompted for that file's password (see the <strong>Encrypted
  276. Files</strong> section).</p>
  277.  
  278. <p>Once the extraction is complete, the <strong>Abort</strong>
  279. button will change to a <strong>Close</strong> button and any
  280. errors or warnings will be displayed. Tap the <strong>Close</strong>
  281. button to return to Pocket UnZip's main screen.</p>
  282.  
  283. <hr>
  284. <h3>Testing Files</h3>
  285.  
  286. <p>Testing files is essentially the same as extracting files,
  287. except for that the actual extracted data is never written to
  288. your file system. Testing files is useful when you wish to verify
  289. the integrity of a Zip file without actually extracting the files
  290. within it.</p>
  291.  
  292. <p>Once you have opened a Zip file into Pocket UnZip, you should
  293. see a list of the Zip file's contents. Select one or more files
  294. from the file list and then choose <strong>Test Selected Files</strong>
  295. (<strong>Ctrl+T</strong>) or <strong>Test All Files</strong> (<strong>Ctrl+A</strong>,
  296. <strong>Ctrl+T</strong>) from the <strong>Action</strong> menu. You may
  297. also use the noted shortcut keys or the associated toolbar
  298. buttons.</p>
  299.  
  300. <p>A progress dialog will appear and the testing will begin. At
  301. any time during the testing, you may tap the <strong>Abort</strong>
  302. button to abort the testing operation.</p>
  303.  
  304. <p>During the testing, you may get interrupted for one of two
  305. reasons. First, if an error occurs, you will be notified with a
  306. message box. Second, if a file being tested is encrypted, then
  307. you will be prompted for that file's password (see the <strong>Encrypted
  308. Files</strong> section).</p>
  309.  
  310. <p>Once the testing is complete, the <strong>Abort</strong>
  311. button will change to a <strong>Close</strong> button and any
  312. errors or warnings will be displayed. Tap the <strong>Close</strong>
  313. button to return to Pocket UnZip's main screen.</p>
  314.  
  315. <hr>
  316. <h3>Viewing Files</h3>
  317.  
  318. <p>Pocket UnZip provides the ability to view, or even execute,
  319. files directly from a Zip file. This feature is a major
  320. convenience over having to extract and then manually open each
  321. file you wish to view. Internally, this is what Pocket UnZip is
  322. doing for you, but it takes care of all the work of extracting
  323. the file to a temporary directory, launching the associated
  324. viewer for that file type, and cleaning up when done.</p>
  325.  
  326. <p>To view a file, simply select a single file from Pocket
  327. UnZip's main file list and press <strong>Enter</strong>. You may also
  328. choose <strong>View Selected File</strong> from the <strong>Action</strong>
  329. menu, press the associated toolbar button, or just double-tap on
  330. the file you wish to view.</p>
  331.  
  332. <p>The file will be extracted to a directory called<strong>
  333. Temporary Pocket UnZip Files</strong> in the root of your file
  334. system. If the file you wish to view is encrypted, you will be
  335. prompted for a password. If the file has an associated viewer
  336. application installed (such as Pocket Word for .PWD files), then
  337. that viewer will automatically be launched with the newly
  338. extracted file as its command line. If there is no associated
  339. viewer application, then you will be prompted for the application
  340. you wish to use to view the file.</p>
  341.  
  342. <p>Pocket UnZip also provides minimal support for allowing you to
  343. use the view file action to run executable programs directly from
  344. the Zip file. If the file you choose to view is an executable
  345. (file extension is EXE), then the file will be executed after it
  346. is extracted. Pocket UnZip will only extract the file you select
  347. and none of its dependent files (like DLLs). If the executable
  348. you extract depends on other files in the Zip file, it will most
  349. likely fail to execute.</p>
  350.  
  351. <p>When Pocket UnZip exits, it will delete the <strong>Temporary
  352. Pocket UnZip Files</strong> directory and all the files in it. If
  353. you are running more than one instance of Pocket UnZip, then only
  354. the last instance of Pocket UnZip that you exit will perform this
  355. delete. Most applications, such as Pocket Word, lock files when
  356. viewing them. Any files being viewed by such an application when
  357. you exit Pocket UnZip will not be deleted.</p>
  358.  
  359. <hr>
  360. <h3>Encrypted Files</h3>
  361.  
  362. <p>If an encrypted file is encountered during an extract, test,
  363. or view operation, you will be prompted for a password. You can
  364. choose to skip the file, skip all encrypted files, or enter a
  365. password. You will be given three attempts at entering the
  366. correct password before the file will be skipped automatically.
  367. Once you have entered the correct password for a given file, that
  368. password will be remembered and automatically used for all other
  369. encrypted files that are encountered during that single extract,
  370. test, or view operation. If another encrypted file is found that
  371. uses a different password than the remembered password, then you
  372. will be prompted again for a new password.</p>
  373.  
  374. <p>This technique provides support for multi-password Zip files,
  375. while still providing users with single password Zip files the
  376. convenience of only having to enter their password once during
  377. the operation for all encrypted files. For security reasons,
  378. passwords are not remembered after the operation completes.</p>
  379.  
  380. <hr>
  381. <h3>About Pocket UnZip</h3>
  382.  
  383. <p>Thank you for using Version 2.0 of Pocket UnZip for Windows
  384. CE.</p>
  385.  
  386. <p>Pocket UnZip was developed by Steve P. Miller. Although I'd
  387. like to take full credit, I could not have done it without the
  388. public decompression source code provided by the Info-ZIP group.
  389. Pocket UnZip uses version 6.0 of Info-ZIP's core decompression
  390. code. Many thanks go to Greg Roelofs and all the fine folks at
  391. Info-ZIP.</p>
  392.  
  393. <p>Please send all comments, suggestions, and bug reports
  394. to <strong>stevemil@pobox.com</strong>.</p>
  395.  
  396. <p>Pocket UnZip is freeware - no shareware fees, no purchase
  397. fees. You can still send me an email or a box of cookies if you
  398. like it. If you would like to distribute Pocket UnZip, please
  399. look at the terms and conditions listed in the accompaning
  400. Info-ZIP LICENSE file.</p>
  401.  
  402. <p>For the latest news, binaries, source code, and more
  403. information about the Info-ZIP group, visit
  404. <strong>ftp://ftp.info-zip.org/pub/infozip/</strong>.</p>
  405.  
  406. <p>For more information about me, or to check out some of my
  407. other applications (mostly Windows 95 / NT / CE), stop by my
  408. personal web page at <strong>http://pobox.com/~stevemil/</strong>.</p>
  409.  
  410. <p>Copyright © 1997-2009 Info-Zip. All Rights Reserved.</p>
  411. </body>
  412. </html>
  413.