WinJar 2.21 1. Introduction WinJar is a graphical shell for a compressor/archiver called jar from ARJ software. It is NOT meant for Java archives (extension .jar); but for a Jar archive (extension .j). This document describes the requirements and (un)installation steps of the program. Further information can be found in the WinJar help files. Read This: As of version 2.2 this program is Cardware. That means that you are free to use this program after you have sent me a nice postcard (Money is also welcome). You can send it to the following address: Rolf Janssen Boerhoorndreef 119 9403 KC Assen The Netherlands 2. Files: The following files should be installed: - WinJar.exe, the executable - html\* , html help files in subdirectory of WinJar installation. - Readme.txt, the file that you are reading now. - Licence.txt, the license for using WinJar, please read it. - Uninst.isu, installshield file, do NOT remove. 3. Requirements - PC with Window 95/98 or NT 4.0 (server/workstation) (currently no information about NT 5). - Minimum: Pentium Processor. - About 1 Mb for WinJar and 1 Mb for Jar itself. There is also some temporary harddisk space needed when you use WinJar (depending on the archive size this can be between 10 Kb and 1 Mb, but with those very low Hard-Disk prices, who cares about space ;-) ). - Jar 1.02, US or International, Registered or Unregistered. - 3D card optional, but not used ;-) - iiyama monitor is the preferred choice, but the program works on any monitor ;) - Netscape for reading the html help-files. 4. Test systems/configs This program has been tested on several systems and it works on them. Tested systems include: - Win98 (Fat16/Fat32), Windows NT 4.0 Server (SP3 and SP4). - Pentium II 266 Mhz, 128 MB SDRAM. - Pentium 233 MMX, 64 MB EDO RAM. 5. Installation 5.1 Manual Version - There is no manual installation version anymore. 5.2 Installation Version - As usual. 6. Uninstall - You can uninstall WinJar the folowing way: - Automatic: From the Control Panel, choose Add/Remove Programs and then choose WinJar 2.2 This will remove WinJar 2.2 completely. - Manual: - First remove the used registry entries, in case something went wrong with uninstalling and you want to manually uninstall: -HKEY_CLASSES_ROOT\.j -HKEY_CLASSES_ROOT\.jar -HKEY_CLASSES_USER\WinJar -HKEY_CURRENT_USER\Software\WinJar -HKEY_LOCAL_MACHINE\rj 1997 And some information is saved by the installation program, so uninstallation should go through the normal Windows 95/NT way. 7. History/Changes 7.1 Changes from '2.2' to '2.21' - Removed dockable toolbar, his reduces the executable about 100k in size. Toolbar now is a normal one. Flat buttons are still available. - Fixed the bug in Traffic light (with no registry entries for WinJar was in the wrong place) - Change default MainWindow size at first start. - Fixed error with "Parse None" and "Parse Dir". With nothing in the main ListView, WinJar wouldn't extract or delete files. - Fixed problem with large fonts. Add dialog now look normal when using large fonts. 7.2. Changed from '2.1' to '2.2': - No manual installation version anymore. - Helpfiles have been changed to HTML files. Use a browser to view it. Pressing F1 (or choosing help from the menu) will start your brower, this will only work from the MainWindow. - There is NO support for Winamp skins ;-) - Program was now made with C++Builder 3. Because of this matter, the executable has increased in size. - Because of Compiler upgrade, the Drive/Directory boxes have been downgraded to Win 3.x look-a-like. This is because some previously used components don't work with C++Builder 3. - Main Listview columns are no longer moveable. Too bad. - Configuration has changed. - Fixed the opening of files in directories with spaces in them, jar archives will now be associated with "s around the %1. - Large buttons settings are now saved, I forgot to include them. - Configuration inside program has changed significantly. - Dialogs are not created until they are actually needed, it saves some memory and resources. The two add dialogs (drag 'n drop and the normal one) are now also the same dialogs, but with just some things moved around and made (in)visible. - Jar32 execution priority added, option between NORMAL (default in previous WinJar) and HIGH (didn't work well on Windows NT). See section 12 for realtime. - Changed some things in the configuration dialog. All add/extract dialog options are in 1 page. Added Appearance and Jar pages. - Added Toolbars options: Allow drag, Limit to one row. - And some more, just try. 7.3. Changes from '2.0 Final' to 2.1 : - Registered Jar32 support added. Select in the Configuration which version you have. - Open Special added. Opens the archive in a special way. Speeds up opening of Jar archive with many files. - Parse Folders Only: Only show the folders in the archive;and no files are added to the main listview. - Parse None: Open the archive, but don't show the contents. Very fast if you want to open an archive with many files. These options where added after I waited more than 10 minutes for WinJar to open a Jar archive with Visual C++ 5.0 in it. That jar-file contained over 15.000 files. Being slow with that many files is also a fault of the standard listview from Windows 9x/NT. - Modifable size of the Recent entries added. - Generate Jar.cfg added. - Recover header added. - Copy with new options added. Not fully tested. - Order of switches and options has been changed. - Some add options have been added. - Now almost all Jar32 switches are implemented. - Wipe floppy implemented for multiple disk spanning to floppy's. A check for floppy's has been made, but be careful with this option. (I AM NOT RESPONSIBLE FOR ANY DATA LOSS). - Some other improvements have been made. Some changes are not represented in the Help-file, this needs to be done. 7.4. Changes from 1.x and 2.0 test to '2.0 Final': There are some changes to the program which are not covered in the help-file: - A progressbar was added to WinJar. It tracks the progress of parsing the Jar output file. The time it takes to parse the output is not depending on the size of the opened Jar archive, but on the number of files in that archive. (An archive of about 2300 files takes about 17 seconds on my computer to parse and about 10 seconds for executing Jar itself. So it takes about 30 seconds to open that archive. I think this an acceptable time. I plan to implement a option for not showing the archive contents, in case any-one want to open an archive with many files, this will save time in parsing). - You now can specify multiple files on the WinJar command-line and the drag 'n drop add dialog will start=up. Also specifying just one 'non-jar' file will also start that dialog. - Specifying 1 Jar archive on the command-line will result in opening that archive. - Dropping 1 Jar archive on WinJar will result in opening that archive. - Some options are disabled in the Delete and Extract dialogs, depending on wether or not "Show Dosbox" is (un)checked; and depending on the existance of more than 1 chapter. - In the add, extract and delete dialog I added the "Show Dosbox" (or "Dosbox" only because of the less space) option. Now you can change that more easily, without exiting the dialog and going to configuration and then going back to the dialog. If you change the setting in one of the dialog, this setting will be changed globally, so also in the configuration dialog. 8. Bugs: - There will be very likely more bugs, please mail me if you find one. - Had some problems with opening files in directories with spaces, I hope it's somewhat solved (it works on my computer). - There is a problem with WinJar if you don't have a c-drive in your system, I'm working on it. - On rare occasions there can be an error "list index out of bounds", I can't seem to find it and/or reproduce this error. Reopening the archive or restarting WinJar helps. - There where reports of problems on Windows NT. When your not "administrator", WinJar can't associated ".j" and/or ".jar" correctly. I'll test for myself, when I get NT working again. - In the add dialog I experienced some errors with the fileslistview when I set it to a floppy (empty one). Don't know about this, i'll try later. - Someone said there was a error with extracting multiple disk spanning archives. I tested and found nothing. The error he got was solved with using "Dos Box" and pressing 'a' when Jar32 asks a question. I'll sort it out later. - The copy with new parameters has not been tested completly, be careful, always backup your archives. 10. Comments: For any comments, bugs or future-to-be-added-features e-mail me. The makers of WinZip and Jar have nothing to do with program. 11. Disclaimer See License.txt Copyright (c) 1997, 1998, 1999 Rolf Janssen HTTP://fmf.fwn.rug.nl/~rjanssen E-Mail: rjanssen@fmf.fwn.rug.nl (no HTML e-mail please, just plain ascii text) Thanks to all who (e)mailed suggestions. Also thanks to the two persons who sent me X-mas cards. January 2, 1999 Pentium (II/Pro) are Registered Trademark of Intel Corp., WinZip is copyrighted to Nico Mak Computing Inc., Arj and Jar are copyrighted to Arj Software. Windows 95/98, Windows NT and MS Word are trademarks of Microsoft. ps. I you like WinJar then a small contribution is always welcome, mail it to the address in the top of this readme.txt ps2. Jar is not freeware, read their license for using Jar. 12. "Hidden" feature (not very very hidden). You can enable the REALTIME priority for jar32 execution by adding a DWORD entry to : HKEY_CURRENT_USER\Software\WinJar\Configuration called 'RealTimeAllowed' with values '1'. BE VERY CAREFUL WITH REALTIME PRIORITY SINCE IT WILL TAKE ALL OFF THE PROCESSOR AND YOUR OS WILL NOT RESPOND TO ANYTHING ELSE. IF JAR32 CRASHES AND WON'T RETURN YOU WILL HAVE A PROBLEM.