i6comp v1.03beta Release Notes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (InstallShield v6.x Compression and Maintenance util) -] Morlac - Jul-20-2000 [- General exception bugfix -] DarkSoul - Jan-10-2002 [- (InstallShield v5.x Compression and Maintenance util) -] fOSSiL - Jul-10-1999 [- 1. INTRODUCTION 2. INSTALLATION 3. CONCEPTS 4. UNSUPPORTED 1. INTRODUCTION --------------- This is a utility to handle version 6 of the InstallShield cabinet files. Its based on i5comp by -] fOSSiL [-, so, thank him first. Without his excellent work, this one would not exist. All features are present from i5comp. What changed was the data structures only. The decompression routines are handled in ZD51145.DLL. I hope that no body flames me for using the i5comp readme, but i suck big time when it comes to writting docs. Changes/New features are: - [DarkSoul] Added bugix to aviod general exceptions. Should now work without errors on IS 6.3 cabinet files. I changed nothing else, so don't ask me if you still get errors! - [MORLAC] Converting multi-volume cabinets to a single one has been removed. No longer needed. Adding a file is not tested and propably wont work. - [MORLAC] Multi-Volume Cab's are supported. Cab's must be of the form: Data1.cab, Data2.cab, Data3.cab ...etc. This works in the case where all these files share the same Data1.hdr Of course, the name "Data" can be anyother like lw1.cab, lw2.cab...etc. :-) - [MORLAC] Now -f works with commands e and x, i.e: i6comp x -f data1.cab (files are decompressed under File Groups and subdirs) or i6comp e -f data1.cab (files are decompressed into their File Group sub-directory) - Added AutoDetect for cabinet version (yay!) It is no longer necessary to specify -v in most cases, only if autodetect fails for some reason - New option -o: suppresses any extra output, like comments, start msg (easier to make wrappers/GUI) Please note, that it will not suppress error and warning messages - New option -f: treat File Groups as directories Now u can use it instead of -g and specify filegroup name as u would specify a folder, i.e.: i6comp a -f data1.cab "English Intel 32 Files" *.dll (this will add all .dll files in the current dir to the filegroup "English Intel 32 Files" in data1.cab) or i6comp a -r -f data1.cab "English Intel 32 Files\Lalala\*" (this will add all files and subdirs starting from the "English Intel 32 Files\Lalala" directory to the subdir Lalala inside filegroup "English Intel 32 Files" in data1.cab) Other variants are possible too. This option was really intended for use with Far MultiArc plugin, see the next item ;) - Far MultiArc plugin script U can now use Far to browse IS cabinets and do some basic operations. There are some limitations of course - MultiArc cannot add files to a subdir inside an archive, so u have to work around by adding whole directories to the root of a cabinet, which is a list of File Groups ;) Please look at the attached Far-Arc.txt file for more details - Changed format of listings: mostly extended Size fields (uhm, files are getting bigger now, need more space ;) - Source code is now included with this version. You are welcome to make changes and recompile, the only thing I will ask is that u update the version to something like 2..x in the start message :). Other than that - RTFM ! 2. INSTALLATION --------------- 1) Put 'i6comp.exe' wherever u want (preferrably somewhere in PATH). 2) Put 'zd*.dll' files in %WinSysDir%. For example, on Win95 that might be 'C:\WINDOWS\SYSTEM' and on NT - 'C:\WINNT40\SYSTEM32'. Or u can put these files anywhere in PATH. 3. CONCEPTS ----------- 1) COMMAND SYNTAX Unlike weird icomp.exe, i6comp mimics the command syntax of ARJ/RAR style compressors, but the big difference is that the established syntax order can not be broken, meaning that u have to specify [-opts] in this order, no mixing is allowed. Just run i6comp with no parameters to see the explanation of syntax, commands and options. 2) FILE INDEX Every file inside a cab has a fixed index. U can see that index when u do 'i6comp l your.cab' in the 'Ind' column. InstallShield allows duplicate filenames within one cab, so u might have to referr to the file by its index to ensure that u extract/replace the right one. 3) MASK MATCHING In addition to the references to files by name and index u can use filemasks ('fmask' for short in the command line help). The mask matching in i6comp is extended compared to standard DOS one. U can use, for example, masks like this : a*b.dll, *b?c?d*.d*, etc. For example, '*b?c*.dll' will match with 'boc.dll', 'bac12.dll', 'aablc.dll', but will NOT match 'bc.dll'. 4) FILEGROUPS Every file inside a cab belongs to some FileGroup. Because of this structure, u have to specify a FileGroup with a -g option when adding files to a cab. Alternatively, u cab use -f mode of i5comp, in which FileGroups are treated as directories. 5) COMPRESSION DLLs Somewhere in the middle of the development of versions 5.x InstallShield changed the way the files are being compressed. Because of that the option -v was created. It allows u to specify which version of compression dll to use. With InstallShield ver 6, they changed the file structures inside the cabinet but they did not change the way the files are compressed. 4. UNSUPPORTED -------------- 1) Compressed files that span more than one cabinet are not tested and i dont think they exist. 2) CAB creation functionality was never intended and required too much effort, especially since u can create CABs with InstallShield itself. BETA TESTERS : ;-b ~~~~~~~~~~~~~~ GREETZ go to : fOSSiL for his i5comp and the source code. ~~~~~~~~~~~~~~ Iceman of romania. Nice guy. G-Rom and the ProcDump team. I wish they continue it. +HCU for what they tought me. And anyone that i forgot. Its 4:05am, time to sleep.