home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / 1997 / 1015.ZIP / PSIZIP.TXT < prev   
Encoding:
Text File  |  1997-05-09  |  14.4 KB  |  428 lines
  1. PsiZip V1.2F
  2. ------------
  3. Release date: 08 May 1997
  4.  
  5.  
  6. Description
  7. -----------
  8. PsiZip is a compression and file packaging utility for the Psion Series
  9. 3a, 3c and Siena palmtop computers.
  10.  
  11. It is compatible with PKZIP v2.04g (PKWARE) for MS-DOS, Windows, UNIX,
  12. OS/2, and VMS systems, and also ZIP 2.0.1 (Info-ZIP) for MS-DOS and
  13. Windows.  It is the ONLY program to provide effective and fast zip
  14. compression AND de-compression on the Psion!
  15.  
  16. The PsiZip application includes many new and innovative features, of
  17. which these are just a few:
  18.  
  19. * Improved compression.  PsiZip makes use of the latest "Deflate"
  20.   compression algorithm.
  21.  
  22. * Unzip support. PsiZip also has the needed algorithms to support
  23.   the unzipping of zip files.
  24.  
  25. * Subdirectory storage. PsiZip can find and store subdirectory
  26.   pathnames within a zip file.  Files can then be restored to
  27.   their original subdirectories, or the subdirectories may be 
  28.   re-created.
  29.  
  30. * Password encryption. Sensitive data files can be scrambled
  31.   with password protection (Registered users only!)
  32.  
  33.  
  34. Installation
  35. ------------
  36. PsiZip is distributed as a single zip archive.  You will need an Unzip
  37. program which can cope with standard zip formats to unzip the archive.  
  38. Examples include WinZip (Windows) or the original PKUnzip (MS-DOS), 
  39. but there are programs available which run on almost every computer type.
  40. Then follow these 3 simple steps:
  41.   
  42. 1. Unpack PsizipXX.zip to an empty directory and check the contents.  
  43.    If they are not as follows, then the archive is either damaged or has 
  44.    been tampered with:
  45.  
  46.     Psizip.app    The PsiZip application
  47.     Readme.txt    This readme file
  48.  
  49. 2. Copy Psizip.app into an \APP\ directory on any of your Psion disks.
  50.    NOTE: Psizip.app is suitable for storage on Flash SSDs.
  51.  
  52. 3. Install PsiZip from the System screen with Psion-I. or use the menu 
  53.    and select Apps | Install (on English Psions).
  54.  
  55. Memory requirements
  56. -------------------
  57. PsiZip itself uses about 80k of memory when running, plus about 48k
  58. for archive actions (Add, Delete, Extract, View, Test, Comment) and
  59. 12k for every additional 100 files in an archive. This option can be set
  60. via 'Set preferences' (Psion-Q or Menu, Special | Set preferences | Total
  61. files).  This allows values from 100 to 500 for the maximum number of 
  62. files in an archive.
  63.  
  64. PsiZip also makes a temporary copy of each archive it works with in a
  65. disk/directory that the user specifies (again using 'Set preferences')
  66.  
  67. So, if the disk for the temporary files is set to the Internal disk, and 
  68. the archive is also on the internal disk, then the amount of memory 
  69. required for PsiZip to run will be this:
  70.  
  71.     Roughly 128k of internal memory for PsiZip program itself
  72.     + Space for a temporary copy of archive
  73.     + Space for the final archive file.
  74.  
  75. To make sure the actual program has enough System Memory from the internal
  76. disk, the disk for temporary files can be set to an SSD disk (via 'Set
  77. preferences').
  78.  
  79. If you do use an SSD then it MUST be a RAM SSD.  If you use a Flash SSD,
  80. then any temporary files created will be deleted, but space will not 
  81. be recovered until you re-format the disk (See the Psion User Manual for 
  82. details about Flash and RAM SSDs).
  83.  
  84. To give the user even more flexibility, PsiZip also allows you to use 
  85. a remote drive or the Cyclone floppy disk drive as a store for temporary 
  86. files (although this will slow down the compression process).
  87.  
  88. After the archive operations are completed, all temporary files are 
  89. deleted.
  90.  
  91. NOTE: If you set the path for temporary file to the same directory as 
  92.       the one which holds the final archive, the temporary copy of 
  93.       archive is not copied and then deleted, it is just renamed.
  94.  
  95. The amount of space needed for the temporary files and the final archive 
  96. and also the amount of compression obtained will depend on the files 
  97. you wish to compress:
  98.  
  99. Program files (.OPA, .APP, .OPO and .IMG) typically compress by 
  100. about 5% to 10%
  101.  
  102. Other files (such as .TXT, .SPR, .AGN,...) can be compressed by 
  103. up to 60%, and in some cases even more!
  104.  
  105. How many files can PsiZip allow in a zip archive?
  106. -------------------------------------------------
  107. A zip file may contain a maximum of 500 file entries under PsiZip.
  108. The actual maximum value depends on the length of the file names
  109. (including the full path if stored) and file comments.
  110.  
  111. PsiZip requires 12k system memory for every 100 files, thus 500 files
  112. requires 60k system memory.
  113.  
  114. Usage summary
  115. -------------
  116. The following options are available both on the menu and by using the
  117. relevant hotkeys.  PsiZip has been designed to be very easy to use and
  118. comes with an intuitive User Interface. As a result, you should be able
  119. to use PsiZip without even reading this file or the Help screens. 
  120. Full on-line help is also available within the program - just press 
  121. the 'Help' key.
  122.  
  123. Use:
  124.  
  125. * 'New archive' to create a new zip archive, then..
  126.  
  127. * 'Add file' to add files to the archive. Note the 'Options...' line in 
  128.    the resulting dialog.  The options allow you to:
  129.     1) Select whether PsiZip stores
  130.        the directory of the files that
  131.        you are adding
  132.     2) Select an option to add a comment
  133.        to each file.
  134.     3) Select whether each file will be
  135.        password protected (and therefore encrypted)
  136.     4) Allows you to select if files are
  137.        'Stored' or 'Compressed'
  138.  
  139. * 'Open archive' to open an existing zip archive
  140.  
  141. * 'Extract file' (or just press Enter over a file or selected files) 
  142.    to extract file(s) from the archive.
  143.  
  144. * 'Delete file' (or just press Delete over a file or selected files) 
  145.    to delete file(s) from the archive.
  146.  
  147. * Left, Right, Home and End to move around the displayed columns.
  148.  
  149. * Up and Down to move rows.
  150.  
  151. Menu...
  152. ----
  153.  
  154. Archive
  155. -------
  156. Archive | New Archive
  157. Create a new archive.
  158.  
  159. Archive | Open Archive
  160. Open an existing archive.
  161.  
  162. Archive | Close Archive
  163. Close the currently open archive.
  164.  
  165. Archive | Information
  166. Display information about the open archive
  167.  
  168. Archive | Move Archive
  169. Move archive to a different disk or directory
  170.  
  171. Archive | Copy Archive
  172. Copy archive to a different disk or directory
  173.  
  174. Archive | Rename Archive
  175. Change the name of the current archive
  176.  
  177. Archive | Delete Archive
  178. Delete an archive
  179.  
  180. Actions
  181. -------
  182. Actions | Add file
  183. Add files to the open archive
  184.  
  185. From the 'Add file' dialog, there are further settings which
  186. can be selected by pressing Tab on the 'Options...' line:
  187.  
  188. 'Select by'
  189. When this option is set to 'Directory' , PsiZip will search the source
  190. directory for subdirectories.  If any subdirectories are found, PsiZip
  191. searches them for files.  If a further level of subdirectories is found
  192. in a subdirectory, PsiZip will search these as well.
  193.  
  194. NOTE: Full paths are not stored when the 'Save dir info' is set to 'No'
  195.  
  196. 'Compression'
  197. PsiZip provides two different methods of compression.
  198. To output the smallest files possible, specify the 'Compress' method. Using
  199. 'Store' (no compression) is useful when archiving files which will either
  200. not compress or compress very little. This would generally be true when
  201. archiving ZIP, ARJ, GIF, JPG files as these are already compressed. 
  202. By specifying no compression PsiZip will store the files directly rather 
  203. than first attempting to compress them.
  204.  
  205. 'Save dir info'
  206. This option sets whether full path names are stored with each file.
  207.  
  208. 'File comment'
  209. This is pretty obvious, it allows you to write a comment onto each file
  210. as it is stored.  This can be useful if you want to write a small
  211. reminder about the contents of each file in case you forget.
  212.  
  213. 'Password' (Registered users only)
  214. By specifying this option you may encrypt data as it is compressed by 
  215. PsiZip. This feature of PsiZip causes the information contained within 
  216. a zip file to be 'scrambled'.  A file which has been scrambled will be 
  217. unreadable until extracted with the same encryption key (which is derived 
  218. from the password which you supply).
  219.  
  220.  
  221. Actions | Delete file
  222. Delete file(s) from the open archive
  223.  
  224. Actions | Extract file
  225. Extract file(s) from the open archive
  226.  
  227. Again, there is a sub-option from the Extract file dialog:
  228.  
  229. 'Restore dir info'
  230. This option uses the path names that have been stored in the zip
  231. file by PsiZip. If the stored paths do not exist in the destination
  232. directory, they will be created.
  233.  
  234. Actions | View file
  235. View files in the open archive using Word or Program editor (which
  236. is set via 'Set preferences')
  237.  
  238. Actions | Tag all/Untag all
  239. Select/Deselect all files in an archive
  240.  
  241. Actions | Test archive
  242. Test the integrity of an archive and check for errors.
  243.  
  244. Actions | Archive comment
  245. Add/Edit the archive comment.
  246.  
  247. Special
  248. -------
  249. Special | Set preferences
  250. Sets the preferences for PsiZip.  All settings are saved to the file
  251. \OPD\Psizip.ini on the default disk.
  252.  
  253. These are the options available:
  254.  
  255. 'Style'
  256. Set the font style (eg Swiss/Roman, Bold...)
  257.  
  258. 'Columns'
  259. Allows you to set which columns of information are shown on the 
  260. PsiZip screen.
  261.  
  262. 'Grid lines'
  263. Sets/reset the grid lines for the main screen (i.e. if they're shown 
  264. going up, down or both)
  265.  
  266. 'View file in'
  267. Select the file viewer to use (Word or Program Editor are the only 
  268. choices at present).
  269.  
  270. 'Total files'
  271. Defines the maximum number of files PsiZip will allow in the archive 
  272. (100-500). Every 100 files takes 12k system memory, thus setting 500 
  273. files takes 60k additional system memory. If you never use archives 
  274. with more than 100 files in them, then set 'Total files' to 100.
  275.  
  276. 'Temp dir'
  277. Sets the path for the temporary files.
  278.  
  279.  
  280. Special | Zoom in/Zoom out
  281. Change the screen's font size.
  282.  
  283.  
  284. Special | Register
  285. Allows you to enter a registration code for PsiZip. Once PsiZip is
  286. registered, this menu item will no longer be shown.
  287.       1) Enter your personal registration code EXACTLY as supplied using
  288.      upper or lower case as required.
  289.       2) Press Enter
  290.  
  291.  
  292. Special | About
  293. Display the About screen with version, copyright contact details and
  294. registration information.
  295.  
  296.  
  297. Special | Exit
  298. Exits PsiZip.
  299.  
  300.  
  301. Tips & Tricks
  302. -------------
  303. Creating the temporary files on alternate disk
  304. ----------------------------------------------
  305. Every time a zip file is updated, PsiZip creates a temporary work file. 
  306. When the modifications to the zip file are successfully completed, the 
  307. original zip file is replaced with the temporary work file.  
  308. This means you must have at least as much additional disk space available 
  309. as was used by the original zip file.
  310.  
  311. For Example: If you have an existing zip file of 50k, and you are adding
  312. another file to it that takes 10k compressed, you need additional 
  313. workspace of at least 60k during the update process.
  314.  
  315. The 'Set preferences', 'Temp dir' option allows you to create the temporary
  316. zip file on a disk different from the one on which the original zip file
  317. resides.  This allows you to update large zip files when space is limited,
  318. such as a large zip file on a internal disk.
  319.  
  320. If the temporary directory is on a RAM SSD, PsiZip's operation becomes
  321. slightly faster.
  322.  
  323. Add comments for new files
  324. --------------------------
  325. Each individual file contained within a zip file may have a comment 
  326. attached to it.  Comments are useful for identifying files, especially 
  327. if you need to go back months later to look at a file, or if you are 
  328. sending the file to someone else.  Each comment may be up to 128 
  329. characters long, including spaces and punctuation.
  330.  
  331. Add comments to a zip archive
  332. -----------------------------
  333. Each zip archive file may have a comment embedded into it. A comment 
  334. may be added to an existing archive, or added when an archive is first 
  335. created. It can be up to 1024 characters long.  PsiZip provides a built 
  336. in editor (with Bring, Copy and Paste functions) for you to create an 
  337. appropriate comment.
  338.  
  339.  
  340. Bug Reports / Comments
  341. ----------------------
  342. Please send all bug reports and comments to the author (Serge Shestopalov) 
  343. at the address shown in the Support section below.
  344.  
  345.  
  346. Registration
  347. ------------
  348. PsiZip is Shareware, which means you can try the program before deciding
  349. to purchase it, and you may give copies of the trial version to other
  350. Psion users to try. However, you cannot legally continue to use the
  351. program if you decide not to register it, nor may you give copies of the
  352. registered version or the registration code to others.  You may use the
  353. trial version for 30 days, and I will provide assistance to get the
  354. program to work with your Psion during that period, but further support
  355. is available only to registered users. 
  356.  
  357. The registration fee is UKP รบ15 or USD $25 for cash, if you use
  358. a registration service then the fee is as shown below.
  359.  
  360. Payment can be made by...
  361.  
  362.     * Cash only (no cheques please) sent to
  363.         Serge Shestopalov
  364.         Balvu 15-56
  365.         Riga, LV-1003
  366.         LATVIA
  367.         EUROPE
  368.  
  369.     * GO SWREG on CompuServe, using the ID number 13291 ($29.50)
  370.  
  371.     * Using the RegNet service on my World Wide Web page ($29.50)
  372.  
  373. *Important note*:  Please do not send cheques.  The local banks all 
  374.            charge an excessive amount to cash them.  The
  375.            easiest way to register is by sending cash in a
  376.            good STRONG envelope (between two pieces of paper
  377.              so you cannot see through the envelope).
  378.  
  379. Once registered, you will receive a personal code to free PsiZip from 
  380. the nag screen and limitations. There is no need to re-install.
  381.  
  382. Please include you full name and the version number of PsiZip.
  383.  
  384.  
  385. Support
  386. -------
  387. This product is supported via e-mail only.
  388. Please send all messages to:
  389.  
  390.         Internet: dustman@stoat.riga.lv
  391.         CompuServe: 100526,1317
  392.  
  393. The latest version will always be available from my Web page:
  394.  
  395.     http://ourworld.compuserve.com/homepages/Serge_S/
  396.  
  397. Disclaimer
  398. ----------
  399. Although the program has been tested extensively, there is no guarantee 
  400. that it is error free. Please make backup copies of all your important 
  401. data!
  402.  
  403. The author will not be liable for any damage or consequential loss caused
  404. by any error, defect or failure of the application.
  405.  
  406. History
  407. -------
  408.    11/10/96 - v1.0 PZip release, Zip only.
  409.  
  410.    01/12/96 - v1.1 alpha release: GUI added, still Zip only.
  411.  
  412.    24/02/97 - v1.2a beta release, Unzip added.
  413.  
  414.    08/05/97 - V1.2F final released
  415.  
  416.  
  417. Thanks
  418. ------
  419. To my beta testers....
  420.  
  421. - Jochen Siegenthaler (100127.3167@compuserve.com)
  422. - Phil Spencer (nicko@nildram.co.uk)
  423. - Steve Litchfield (slitchfield@cix.compulink.co.uk)
  424.  
  425. -----------------------
  426. PsiZip and this readme file are Copyright (C) Serge Shestopalov 1997.
  427. All Rights Reserved.
  428.