home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 April / PCWorld_1999-04_cd.bin / Software / Servis / WinJar22 / data1.cab / Help_Files / Readme.txt < prev    next >
Text File  |  1999-01-03  |  11KB  |  228 lines
  1. WinJar 2.21
  2.  
  3. 1. Introduction
  4.  
  5.  WinJar is a graphical shell for a compressor/archiver called jar from ARJ software.
  6.  It is NOT meant for Java archives (extension .jar); but for a Jar archive (extension .j).
  7.  This document describes the requirements and (un)installation steps of the 
  8.  program. Further information can be found in the WinJar help files.
  9.  
  10.  Read This:
  11.  As of version 2.2 this program is Cardware. 
  12.  That means that you are free to use this program after you have sent me
  13.  a nice postcard (Money is also welcome).
  14.  You can send it to the following address:
  15.  
  16.      Rolf Janssen
  17.      Boerhoorndreef 119
  18.      9403 KC Assen
  19.      The Netherlands
  20.  
  21. 2. Files:
  22.  
  23.  The following files should be installed:
  24.  
  25.   - WinJar.exe,  the executable
  26.   - html\*    ,  html help files in subdirectory of WinJar installation.
  27.   - Readme.txt,  the file that you are reading now.
  28.   - Licence.txt, the license for using WinJar, please read it.
  29.   - Uninst.isu,  installshield file, do NOT remove.
  30.  
  31. 3. Requirements 
  32.  
  33.  - PC with Window 95/98 or NT 4.0 (server/workstation) (currently no information about NT 5). 
  34.  - Minimum: Pentium Processor. 
  35.  - About 1 Mb for WinJar and 1 Mb for Jar itself. There is also some temporary harddisk 
  36.    space needed when you use WinJar (depending on the archive size this can be between 
  37.    10 Kb and 1 Mb, but with those very low Hard-Disk prices, who cares about space ;-) ).
  38.  - Jar 1.02, US or International, Registered or Unregistered.
  39.  - 3D card optional, but not used ;-)
  40.  - iiyama monitor is the preferred choice, but the program works on any monitor ;)
  41.  - Netscape for reading the html help-files.
  42.  
  43. 4. Test systems/configs
  44.  
  45.  This program has been tested on several systems and it works on them.
  46.  Tested systems include:
  47.   - Win98 (Fat16/Fat32), Windows NT 4.0 Server (SP3 and SP4).
  48.   - Pentium II 266 Mhz, 128 MB SDRAM.
  49.   - Pentium 233 MMX, 64 MB EDO RAM.
  50.  
  51. 5. Installation
  52.  
  53. 5.1 Manual Version
  54.  
  55.   - There is no manual installation version anymore.
  56.  
  57. 5.2 Installation Version
  58.   
  59.   - As usual.
  60.  
  61. 6. Uninstall
  62.  
  63.   - You can uninstall WinJar the folowing way: 
  64.     - Automatic:
  65.        From the Control Panel, choose Add/Remove Programs and then choose WinJar 2.2
  66.        This will remove WinJar 2.2 completely.
  67.     - Manual:
  68.       - First remove the used registry entries, in case something went wrong with 
  69.         uninstalling and you want to manually uninstall:
  70.         -HKEY_CLASSES_ROOT\.j
  71.         -HKEY_CLASSES_ROOT\.jar
  72.         -HKEY_CLASSES_USER\WinJar
  73.         -HKEY_CURRENT_USER\Software\WinJar
  74.         -HKEY_LOCAL_MACHINE\rj 1997
  75.  
  76.         And some information is saved by the installation program, so uninstallation should
  77.         go through the normal Windows 95/NT way.
  78.  
  79. 7. History/Changes
  80.  
  81. 7.1 Changes from '2.2' to '2.21'
  82.  
  83.  - Removed dockable toolbar, his reduces the executable about 100k in size. Toolbar now is a normal
  84.    one. Flat buttons are still available.
  85.  - Fixed the bug in Traffic light (with no registry entries for WinJar was in the wrong place)
  86.  - Change default MainWindow size at first start.
  87.  - Fixed error with "Parse None" and "Parse Dir". With nothing in the main ListView, WinJar wouldn't
  88.    extract or delete files.
  89.  - Fixed problem with large fonts. Add dialog now look normal when using large fonts.
  90.  
  91. 7.2. Changed from '2.1' to '2.2':
  92.  
  93.  - No manual installation version anymore.
  94.  - Helpfiles have been changed to HTML files. Use a browser to view it.
  95.    Pressing F1 (or choosing help from the menu) will start your brower, this
  96.    will only work from the MainWindow.
  97.  - There is NO support for Winamp skins ;-)
  98.  - Program was now made with C++Builder 3. Because of this matter, the executable has 
  99.    increased in size.
  100.  - Because of Compiler upgrade, the Drive/Directory boxes have been downgraded to
  101.    Win 3.x look-a-like. This is because some previously used components don't work
  102.    with C++Builder 3.
  103.  - Main Listview columns are no longer moveable. Too bad.
  104.  - Configuration has changed.
  105.  - Fixed the opening of files in directories with spaces in them, jar archives
  106.    will now be associated with "s around the %1.
  107.  - Large buttons settings are now saved, I forgot to include them.
  108.  - Configuration inside program has changed significantly.
  109.  - Dialogs are not created until they are actually needed, it saves some memory 
  110.    and resources. The two add dialogs (drag 'n drop and the normal one) are now also
  111.    the same dialogs, but with just some things moved around and made (in)visible.
  112.  - Jar32 execution priority added, option between NORMAL (default in previous WinJar)
  113.    and HIGH (didn't work well on Windows NT). See section 12 for realtime.
  114.  - Changed some things in the configuration dialog. All add/extract dialog options are in 
  115.    1 page. Added Appearance and Jar pages.
  116.  - Added Toolbars options: Allow drag, Limit to one row.
  117.  - And some more, just try.
  118.  
  119. 7.3. Changes from '2.0 Final' to 2.1 :
  120.  
  121.  - Registered Jar32 support added. Select in the Configuration which version you have.
  122.  - Open Special added. Opens the archive in a special way. Speeds up opening of 
  123.    Jar archive with many files.
  124.     - Parse Folders Only: Only show the folders in the archive;and no files are added to
  125.       the main listview. 
  126.     - Parse None: Open the archive, but don't show the contents. Very fast if you want
  127.       to open an archive with many files.
  128.    These options where added after I waited more than 10 minutes for WinJar to open
  129.    a Jar archive with Visual C++ 5.0 in it. That jar-file contained over 15.000 files.
  130.    Being slow with that many files is also a fault of the standard listview from Windows 9x/NT.
  131.  - Modifable size of the Recent entries added.
  132.  - Generate Jar.cfg added.
  133.  - Recover header added.
  134.  - Copy with new options added. Not fully tested.
  135.  - Order of switches and options has been changed.
  136.  - Some add options have been added.
  137.  - Now almost all Jar32 switches are implemented.
  138.  - Wipe floppy implemented for multiple disk spanning to floppy's. A check for floppy's
  139.    has been made, but be careful with this option. (I AM NOT RESPONSIBLE FOR ANY DATA LOSS).
  140.  - Some other improvements have been made.
  141.  
  142.  Some changes are not represented in the Help-file, this needs to be done. 
  143.  
  144. 7.4. Changes from 1.x and 2.0 test to '2.0 Final':
  145.  
  146.  There are some changes to the program which are not covered in the help-file:
  147.  - A progressbar was added to WinJar. It tracks the progress of parsing the Jar output
  148.    file. The time it takes to parse the output is not depending on the size of the 
  149.    opened Jar archive, but on the number of files in that archive. (An archive of
  150.    about 2300 files takes about 17 seconds on my computer to parse and about 10 seconds
  151.    for executing Jar itself. So it takes about 30 seconds to open that archive.
  152.    I think this an acceptable time. I plan to implement a option for not showing 
  153.    the archive contents, in case any-one want to open an archive with many files,
  154.    this will save time in parsing).
  155.  - You now can specify multiple files on the WinJar command-line and the drag 'n drop
  156.    add dialog will start=up. Also specifying just one 'non-jar' file will also start
  157.    that dialog.
  158.  - Specifying 1 Jar archive on the command-line will result in opening that archive.
  159.  - Dropping 1 Jar archive on WinJar will result in opening that archive.
  160.  - Some options are disabled in the Delete and Extract dialogs, depending on wether or
  161.    not "Show Dosbox" is (un)checked; and depending on the existance of more than 1 chapter.
  162.  - In the add, extract and delete dialog I added the "Show Dosbox" (or "Dosbox" only because
  163.    of the less space) option. Now you can change that more easily, without exiting the
  164.    dialog and going to configuration and then going back to the dialog. If you change the
  165.    setting in one of the dialog, this setting will be changed globally, so also in the 
  166.    configuration dialog.
  167.  
  168. 8. Bugs:
  169.  
  170.  - There will be very likely more bugs, please mail me if you find one.
  171.  - Had some problems with opening files in directories with spaces, I hope
  172.    it's somewhat solved (it works on my computer).
  173.  - There is a problem with WinJar if you don't have a c-drive in your system, 
  174.    I'm working on it.
  175.  - On rare occasions there can be an error "list index out of bounds", I can't
  176.    seem to find it and/or reproduce this error. Reopening the archive or restarting
  177.    WinJar helps.
  178.  - There where reports of problems on Windows NT. When your not "administrator", WinJar
  179.    can't associated ".j" and/or ".jar" correctly. I'll test for myself, when I get NT
  180.    working again.
  181.  - In the add dialog I experienced some errors with the fileslistview when I
  182.    set it to a floppy (empty one). Don't know about this, i'll try later.
  183.  - Someone said there was a error with extracting multiple disk spanning archives.
  184.    I tested and found nothing. The error he got was solved with using "Dos Box"
  185.    and pressing 'a' when Jar32 asks a question. I'll sort it out later.
  186.  - The copy with new parameters has not been tested completly, be careful, always
  187.    backup your archives.
  188.  
  189. 10. Comments:
  190.  
  191.  For any comments, bugs or future-to-be-added-features e-mail me.
  192.  The makers of WinZip and Jar have nothing to do with program.
  193.  
  194. 11. Disclaimer
  195.  
  196.  See License.txt
  197.  
  198.  Copyright (c) 1997, 1998, 1999 Rolf Janssen
  199.  HTTP://fmf.fwn.rug.nl/~rjanssen
  200.  E-Mail: rjanssen@fmf.fwn.rug.nl
  201.  (no HTML e-mail please, just plain ascii text)
  202.  
  203.  Thanks to all who (e)mailed suggestions.
  204.  Also thanks to the two persons who sent me X-mas cards.
  205.  
  206.  January 2, 1999
  207.  
  208.  
  209.  Pentium (II/Pro) are Registered Trademark of Intel Corp., 
  210.  WinZip is copyrighted to Nico Mak Computing Inc., 
  211.  Arj and Jar are copyrighted to Arj Software.
  212.  Windows 95/98, Windows NT and MS Word are trademarks of Microsoft.
  213.  
  214.  ps.  I you like WinJar then a small contribution is always welcome,
  215.       mail it to the address in the top of this readme.txt
  216.  
  217.  ps2. Jar is not freeware, read their license for using Jar.
  218.  
  219. 12. "Hidden" feature (not very very hidden).
  220.  
  221.   You can enable the REALTIME priority for jar32 execution by adding 
  222.   a DWORD entry to :
  223.     HKEY_CURRENT_USER\Software\WinJar\Configuration
  224.   called 'RealTimeAllowed' with values '1'.
  225.  
  226.   BE VERY CAREFUL WITH REALTIME PRIORITY SINCE IT WILL TAKE ALL OFF
  227.   THE PROCESSOR AND YOUR OS WILL NOT RESPOND TO ANYTHING ELSE.
  228.   IF JAR32 CRASHES AND WON'T RETURN YOU WILL HAVE A PROBLEM.