═══ 1. Introduction ═══ Dear User, PM Zipper is a multithreaded software to manage and arrange ZIP-Archives. Because of the included features, it is able to use it as a CD-ROM-Manager too. PM Zipper is only available for the fantastic OS/2-Platform. Preface On developement of PM Zipper there were yielded 2 main criteria which must performed: PM Zipper must work as a ZIP-Shell and support extraction and archiving with smallest expenditure. The use as CD-ROM-Manager for ZIP-archived files ought to be performed, because there are a lot of OS/2-CD-ROMs, whose any manager for the OS/2-Platform is missing. PM Zipper ought to be good integrated in the WPS, support extendet attributes and Drag&Drop. Features With PM Zipper you can: - read multiple archives at once. ->Compare archives. - archive and extract archives,directories,files with use of Drag&Drop - drop archives on PM Zipper (read) - copy archivecontents to other archives - view archivecontens without extraction of the full archive - view ascii files included in archives - view onlinedocuments included in archives - run programs included in archives (for testing) - arrange icons with files History 0.01 Limited alpha version 0.02 Beta version 1.00 First release Crossreferences Registration Support adresses Shareware restrictions ═══ 1.1. Registration ═══ Registration PM Zipper is not public domain nor freeware but shareware. All registered users of one of my developements can obtain PM Zipper for a discount of DM 10. You are allowed to test and use this program for 14 days. After this period you must register your copy, if you want to continue to use it. The price is 50,- DM. Only DM (german mark) is accepted. Pay via remittance or collection-only check to: Frank Ambacher Account: 34 00 35 17 00 Bank: Berliner Bank AG, Germany BLZ: 100 200 00 For registering your first-, lastname and adress is inevitable. Write this data at the remit or check. If you have an email-adress, then write it on the remit/check too. In this case, I can send you registrationcodes, updates via internet. If you use PM Zipper more than the period of 14 days without registration, you expel asserting copyright! If you give away your registration key, your registration is invalid. Exception is selling of the registration to another user. In this case you must give me the name and adress of the new owner, or support is canceled. Your registration key will obtain via email. If I can't reach you via email, you will obtain the key via letter. Because this, you must give me your name and full adress by registration. You're not allowed to give a registration key to third parties. Disclaimer The author does not guarantee for the correctness of the program. The author also may not be held responsible for any loss of data or other damages caused by the use of PM Zipper. The author does not guarantee that the program can be used for a specific purpose. Distribution, BBS's, CD-ROMs You may distribute the shareware version of PM Zipper, either through electronic media e.g. BBS's or on diskettes. You may charge for the distribution, but not more than $2. You may distribute only the complete and unaltered archive as supplied by the author. If you like to distribute the program in conjunction with commercial software or hardware (bundling), you must have a written permission of the author. If PM Zipper is to be included in a collection of other public domain or shareware programs on CD-ROM or diskette, written permission by the author is required. Networks, Multiusing You may install the registered version on more than one machine. However, you must make sure that it is only used on one machine at a time. As soon as one license is used on more than one machine at a time, you need additional licenses. Bugs, Wishlists, Suggestions You can report bugs, whishlists, design suggestions, or anything else to my support addresses. ═══ 1.2. Support adresses ═══ Support adresses Letter: Frank Ambacher Uferstr. 5 13357 Berlin Germany Mailboxes: ┌────────────────────────────┬────────────────────────┬───────────────────────────┐ │Stingbox, Berlin │Cyberia/2, Bamberg │BlaubДr BBS, MБnster │ │Tel.: 004930/775 80 44 │Tel.: 0049951/21554 │Tel.: 0049251/54188 │ │ /767 030 22 │Fidonet: 2:2490/3045.17 │Fidonet: 2:xxxx/xxxx.xx │ │ /767 030 32 │Magic PMZIPPER │ │ │ /767 030 33 │OS/2-Net: 81:449/9601.17│ │ │Internet: │Internet: │Internet: │ │anakor@stingbox.stingbox.de │frank.ambacher@c-edv.de │frank.ambacher@muenster.net│ └────────────────────────────┴────────────────────────┴───────────────────────────┘ ═══ 1.3. Shareware restrictions ═══ Restrictions of the unregistered shareware version The unregistered shareware version has no functional restrictions. After the 14 day testing period is gone, the info window will shown by some user actions. It can be closed manually. The closing of this window is not available until a short wait time is over. The longer the testing period is over, the longer is the wait time. ═══ 2. Work with archivecontents ═══ After the first start, PM Zipper uses its default settings. These can be edited via the menu Options. The most of the PM Zipper functions can be reached over the main program window. Crossreferences Create archive Open archive Change view Clear view Extract archive Extract file temporary View textfile Run programfile Drag&Drop ═══ 2.1. Create archive ═══ Create archive When you would create a new archive, you must use the menu Archive/New or the appropriate symbol in the toolbar. The name of the new archiveobject is NEW.ZIP for the present. With a click with your mouse on the object you can confirm the name. If you would rename the archive, then you must edit the name in the edit window on the right of the symbol. The edit window is the only chance to rename the name inside of PM Zipper. If you've confirmed the name, there is no chance to rename. When you will rename the file nevertheless, then you must clear the entyre view with clear view. After this you can repeat the procedure. But it is simply possible to create a new object with the right name. With create archive you only create objects inside of PM Zipper! The archivefile is only created, when packed a file. ═══ 2.2. Open archive ═══ Open archive You can read valid archives of your harddisc or a CD-ROM via open archive or the appropriate symbol of the toolbar. When you do so, you will reach the filedialog. There, you can select files for reading. Archives can be open via drag&drop too. ═══ 2.3. Change view ═══ Change view After you've started PM Zipper the view is switched to viewtype tree. This gives you information about the tree structure of the archive. That means, which files are in which directories of the archive. If you need more information (filelength, creation date and time), you can switch via change view. Details on files included in directories or archives are shown when you doubleclick on the appropriate object. ═══ 2.4. Clear view ═══ Clear view Clear view can be reached via the Menu clear view or the appropriate symbol of the toolbar. When you choose it, the main window is to be set to default condition. Only the visual output is going to be cleared, the files on disc will be preserved unchanged. ═══ 2.5. Extract archive ═══ Extract archive If you click on a to be extracted archive with your right mouse button, a context menu will be open. Choose extract if you want extracting a whole archive. In this case PM Zipper creates a subdirectory inside of the PM Zipper directory, where you can find the files after extracting. Proceed analogous, if you want extract single files or directories. Archives,directories and files can be extract via drag&drop too. ═══ 2.6. Extract files temporary ═══ Extract files temporary Temporary can be reached, when you click with the right mouse button on a fileobject. After selection the file would be extracted temporary. That means, that the file would be extracted to the temporary directory, that is in Options/PM Zipper/Directories. Directory structures don't take into consideration. The meaning of this function would be clearly when you've read the panel Run programfile. ═══ 2.7. View textfile ═══ View textfile Textfiles can be viewed with the program in program settings. Doubleclick on the symbol with the left mouse button will run the view program. Command- and batchfiles (*.CMD, *.BAT) can be viewed in a similar manner. The difference with not executable textfiles is the context menu that is shown, when a doubleclick on the symbol is happen. Choose view if you want read the file. The system editor from OS/2-Warp 3, whose is used as default viewer, contains a bug whose unfortunately take effect here. If it has started in a secondary process, then it don't come to the foreground, but it is in the background. It must be switched manually to the foreground by clicking on it with your mouse. Tip: Try the extended editor EPM.EXE for the view program in options. ═══ 2.8. Run programfile ═══ Run programfile Programfiles are files containing executuble programs; Recognize by the file extensions *.COM, *.EXE, *.BAT, *.CMD. PM Zipper can run these files, without extracting the whole archive. If you want to run binary programfiles (*.COM, *.EXE), it is solely necessary to doubleclick on an appropriate symbol with the left mouse button. The programtype (OS/2-PM, OS/2-Text, DOS, Win) is self-realized by PM Zipper. Text programfiles (*.CMD, *.BAT) can be executed in a similar manner. The difference with binary executable files is the context menu that is shown, when a doubleclick on the symbol is happen. Choose run to execute the file. Some applications need further files to run. E.g. DLL's or internal datafiles. In this case, the program possibly can't run and PM Zipper will show a error message in it's statusline. For being able to execute the progam nevertheless, you must first extract all required files temporary with extract files temporary ═══ 2.9. Drag&Drop ═══ PM Zipper complete supports Drag&Drop of objects. Extract file If you want extract a file or directory from an archive, then you can drag an object from PM Zipper to a drive folder. Insert file If you want insert a file or whole directory to an archive, then you can drag an appropriate object from a drive folder to an archive or an included directory inside of PM Zipper. Copy archivecontents Directories and files can be copied from one archive to another with Drag&Drop. For this you can open a source archive and a target archive. Drag the object that you wish to copy to the target. Read archive Archives can be opened via Drag&Drop too. For this you can drag a valid archive to PM Zipper. Valid archives are only files that has a supported file extension (e.g. *.ZIP) or a supported extended attribute (e.g. ZIP Archive). ═══ 3. Objects and symbols ═══ For representation of archives, directories and files PM Zipper uses 3 different objects. The objects are displayed with various symbols ═══ 3.1. Objects ═══ Archive object Archive objects represents archive files with an archive extension, e.g. *.ZIP or with extended attribute ZIP Archive. Archive objects can use directories and files and would be displayed with external symbols. At the moment only ZIP archives are useable. Directory object Directory objects represents directories. These can use other directories and files and would be displayed with internal symbols. File object File objects represents files with any file extension except *.ZIP or with any extended attribute except ZIP Archive. File objects don't use any other objects and would be displayed with external symbols. It can contain binary or ASCII data. ═══ 3.2. Symbols ═══ PM Zipper supports arrangement from datafiles with a special application, e.g. describe files will be displayed with a describe icon. The file extension will be used for recognize the application. The icons can be found in the directories ICON\ASC and ICON\BIN after installation. If you don't want to use this feature, you can delete all the icons in these directories. In this case all files are displayed with a default icon. New filetypes can be created with copy an icon to the icon directories. Example: create filetype XXX. 1. Find an icon and rename it to XXX.ICO 2. Copy the icon to an icon subdirectory. If the file has a text format, then use the directory ICON\ASC, if not use the directory ICON\BIN. A tilde '~' is used as wildcard. Example: All files with extension C* ought to be displayed with 1 icon. 1. Copy an icon C~.ICO to a appropriate directory (ASC or BIN). 2. Now files with the extensions C, CPP, CCC, CCP, ... will be shown with the new icon. ═══ 4. Basical defines ═══ Basical defines includes panels that informations are not immediate cohere with PM Zipper, but are necessary to understand the meaning of several panels. ═══ 4.1. Text files ═══ Text files are files that contents are editable ASCII signs. That are the signs 0 - 127 of the ASCII-table. ═══ 4.2. Binary files ═══ Binary files are files that can contain all ASCII signs. It can also include not editable ASCII signs. ═══ 4.3. Root directory ═══ A root directory is the main directory of a drive. It includes all other directories and files on a drive. Example: The root directory from drive C: is the directory C:\. ═══ 5. Filedialog ═══ If you have pressed the menu Archive/Open or the appropriate symbol at the toolbar a filedialog comes up. With this dialog you can open multiple files under consideration of drive, directory, filename, filter and extended attribute for reading. Moreover PM Zipper will perceive the last used directory. On the next call, that directory will used as the default. Filename At the entryfield filename there can be inserted a filemask for filtering. With the default *.ZIP only ZIP archives are displayed. Filetype In this list you can choose a filetype for filtering. With the default the filtering is disabled. Files This list shows founded files under consideration of filename and filetype. Drives The drives list shows the logical drives in your system. Directories The directories list shows the founded directories on the selected drive. ═══ 6. Program settings ═══ The notebook program settings contains all settings belonging to the main program. It can be reached over the menu Options/PM Zipper and consists of the 3 sides directories, external programs and save and help. Icon directory In this directory PM Zipper searches for the subdirectories ASC and BIN, whose contains the supported symbols. PM Zipper sets ICON as default. This is the subdirectory ICON under the current directory. The directory ASC contains the icons for text files, but the directory BIN contains icons for binary files. Temporary directory The temporary directory is used for intermediate save and required files. PM Zipper sets TMP as default. This is the subdirectory TMP under the current directory. Attention! Don't use a root directory as temporary directory. PM Zipper creates further directories and files under this directory and deletes them also too. The use of a root directory may have any loss of data on this drive! Text viewer The entryfield text viewer contains the view program for text files. The system editor E.EXE is the default, but you could use any other editor or viewer that can work with text files. If the viewing of a file fails, then presumable the directory of your viewer is not in the path statement in your CONFIG.SYS. In this case, enter the complete path- and filename to this field. Onlinedocument viewer This entryfield contains the view program for onlinedocuments. The system onlineviewer VIEW.EXE is the default. If PM Zipper for onlinedocuments shows only the default symbol, then it's necessary to complete this field with the path of the view program. Alternative you can create a symbol under \BIN. Registrationcode In this field you can input the registrationcode, that you obtain when you are a registered user. In this case PM Zipper don't molest you anymooooooooore with those sinewy info dialogs ;-). ═══ 7. Archiver settings ═══ The dialog archiver settings contains the archiver related settings. It can be reached with the menu Options/Archiver or with the toolbar. Archiver This entryfield contains the filename of the used archiver program. As default ZIP.EXE is used. Info-Zip's ZIP is freeware and is included in the PM Zipper archive. The archiver PkZip for OS/2 v. 1.xx is obsolete and not supported. If the archiver is not in the PM Zipper directory, then you must enter the complete path- and filename. Dearchiver Dearchiver is the filename of the program that unpack an archive. The default is UNZIP.EXE. Info-Zip's UNZIP is freeware and is included in the PM Zipper archive. The dearchiver PkUnzip for OS/2 v. 1.xx is obsolete and not supported. If the dearchiver is not in the PM Zipper directory, then you must enter the complete path- and filename. ═══ 8. Colours and Fonts ═══ The setting of colours and fonts with the OS/2 tools colour- and fontpalette are supported. To change it, simply drag a colour or font to a supported area at PM Zipper. Workarea Supports setting of fore-, backgroundcolour and font. Statusline Supports setting of fore-, backgroundcolour and font. ═══ 9. Comandline parameters ═══ PM Zipper at the moment supports followed parameters: pmzipper.exe <..> Automatic reading of archives at startuptime. It's possible to enter as much archives as you like. ═══ 10. Other products ═══ See my other products: MusicFrame MusicFrame is a 32-bit OS/2-PM-Application. Test it! With it you can: - catalogue record-, MC-, CD collections - make a music-encyclopedia - analize and manage crossreferences of bands and musicians - calculate worth of collections - query data from CD player Albatros by Norbert Heller - calculate length of MC's before recording it ═══ 11. Wanted ... ═══ a person, who can translate german help panels to english. Everybody who feels to be qualified may contact me. Write to anakor@stingbox.stingbox.de with subject translator.