Black Box 4

home *** CD-ROM | disk | FTP | other *** search

/ Black Box 4 / BlackBox.cdr / archiver / gus_150.arj / GUS.DOC < prev next >

Wrap

Text File | 1992-04-13 | 39KB | 832 lines

╔══════════════════════════════════════════╗ ║ █▀▀▀▀▀▀█ █ █ █▀▀▀▀▀▀█ ║ ║ █ █ █ █ ║ ║ █ ▀▀██ █ ██ ▀▀▀▀▀▀██ ║ ║ █ ██ █ ██ ▄ ██ ║ ║ ████████ ████████ ████████ ║ ║ ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ ║ ║ General Unpack Shell ║ ║ version 1.50 ║ ╚══╤═════════════════════════════════════╤═╝ │Copyright (C) 1992 by TRI-SYSTEMS co.│ │ - ALL RIGHTS RESERVED - │ │ Written by Johan Zwiekhorst │ └─────────────────────────────────────┘ T A B L E O F C O N T E N T S ********************************* 1. LEGAL STUFF The no-nonsense licence statement Warranty Contact Payment What you should have received 2. INTRODUCTION 3. USAGE 3.1. General Usage under DOS SYSTEM REQUIREMENTS COMMAND-LINE PARAMETERS NOTE EXAMPLES EXIT CODES 3.2. Unpacking Mailarchives 3.3. Identifying Archive Types 4. BUILT-IN DEFINITIONS 4.1. Built-in Unpacker Definitions 4.2. How To Define Other Unpackers 5. GUS & OTHER SHELLS 6. RUNTIME MESSAGES [A] General information messages [B] Warning messages [C] Fatal error messages 7. ACKNOWLEDGEMENTS 8. REVISION HISTORY ═══════════════════════════════════════════════════════════════════════════════ ╒════════════════╕ │ 1. LEGAL STUFF │ ╘════════════════╛ This software is copyrighted (C) 1991, 1992 by TRI-SYSTEMS co., hereafter called the Owner. All Rights Reserved. The software was written by Johan Zwiekhorst, hereafter called the Author. The No-Nonsense Licence Statement ================================= This software and everything enclosed with it are protected by both Belgian copyright law and international treaty provisions. It is called "freeware". FREEWARE software may be used, copied and distributed freely for NONCOMMERCIAL use only IF: ▀▀▀▀▀▀▀▀▀▀▀▀▀ NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION. IT IS NOT MODIFIED IN ANY WAY. It may be distributed ONLY in it's original, unmodified compressed package file. ~~~~~~~~~~ This means you may not add comments to the compressed package file (also known as an archive file or simply an archive), nor may you delete files from or add files to the archive file, UNLESS YOU HAVE A WRITTEN PERMISSION TO DO SO. Converting the archive file to another compression method or another archive file format is allowed, provided that the above conditions are met. The original package as released by me is in Yoshi's LZH archive format. (See below for what you should have received.) In order to extract the files from an LZH archive, you will need to get the file LHA***.EXE, where '***' stands for the version number of the program LHA. At the time this is written, the latest version is 2.13, so look for LHA213.EXE. Note, that recompressing the archive will nearly always result in a bigger archive. The use of FREEWARE software is prohibited in a governmental or commercial situation. In these cases, this software must be purchased and a Commercial Licence Statement will then be provided for. You may write to TRI-SYSTEMS at the address below for more information. Warranty ======== This software is provided AS IS without any warranty, expressed or implied, including but not limited to fitness for a particular purpose. IN NO EVENT SHALL THE AUTHOR/OWNER OF THIS PRODUCT BE LIABLE FOR ANY DIRECT OR CONSEQUENTIAL LOSS OR DAMAGES WHICH MAY HAVE ARISEN FROM THE USE OF THIS PRODUCT. If your local law does not permit any of the statements made above, or if you do not agree with any of them yourself, THEN YOU ARE NOT LICENCED TO USE THIS PROGRAM! Contact ======= The Author can be reached via electronic mail at phone number +32-11-762626. This is the Tripod BBS. Network addresses: Internet Johan.Zwiekhorst@f100.n292.z2.fidonet.org Compuserve >INTERNET:Johan.Zwiekhorst@f100.n292.z2.FidoNet.Org FIDOnet 2:292/100 SIGnet 27:332/0 Turbo-DataNet 77:8320/100 The Owner can be contacted at the following address: TRI-SYSTEMS co. Langstraat 89 3630 MAASMECHELEN (Belgium) Phone +32-11-764905 during office hours, Central European Time. Payment ======= If you would like to use this product in a commercial or governmental situation, please contact TRI-SYSTEMS at the address above. You will then learn the price of the product and a Commercial Licence Statement will be made available to you. For all others, this product is free, as mentioned before. But if you would like to support the author and encourage him to write more useful software, you're welcome to pay some money. You may pay whatever you feel the product is worth to you. Note that this kind of freeware products is developed entirely in the author's leisure time and he receives absolutely no compensation for it, apart from what you as a user would pay him. If you pay at least U.S. $15 (BEF 500, NLG 30, DEM 25), you will receive, when available, a 5.25" or 3.5" floppy diskette with the next version. Please specify which. Immediately after receiving your payment, I will send you an acknowledgement and a list of the latest versions of all freeware I wrote. Payments to the author can be sent in cash to the address mentioned above or transferred to one of the following bank accounts: Bank Brussel Lambert (Belgium) - account number 335-0076382-89 Rabobank (Holland) - account number 1059.19.519 ***NOTE THAT THIS IS FOR NON-COMMERCIAL SITUATIONS ONLY! For all payments made: please specify NAME and VERSION NUMBER of the product! What you should have received: ============================== You should have received the file GUS_150.LZH - (24741 bytes) with the following contents: ┌──────────┐ ┌─────┐ ┌─────────────────────────┐ │ filename │ │bytes│ │ description │ └══════════┘ └═════┘ └═════════════════════════┘ GUS .DOC 39186 This documentation. GUS .EXE 9859 The program file. CRC/32 = 700e08b3 GUS_WCFG.PAS 4843 TP source for a program CRC/32 = 3491569d that writes a new configur- ation into GUS.EXE. You may also use the program VALIDATE from McAfee Associates for the purpose of checking the authenticity of the program file(s). It should produce the following: File Name: gus.exe gus_wcfg.pas Size: 9,859 4,843 Date: 2-15-1992 2-15-1992 File Authentication: Check Method 1 - D1E4 94B3 Check Method 2 - 03E4 172E ╒═════════════════╕ │ 2. INTRODUCTION │ ╘═════════════════╛ The General Unpack Shell, or GUS, identifies compressed file types and calls the correct unpacker in order to extract the files from them. Its main purpose is, of course, to take work out of YOUR hands. You can use GUS with its straight-forward and easy to remember commands instead of having to learn a new set of commands each time a new archiver sees the daylight. GUS will also work nicely in automated tasks, where any type of archive should be uncompressed, or where a certain file has to be added to any given archive. GUS was made to be command-line compatible with the ARCE.COM unpacker program by Vernon Buerg. This makes it possible for you to rename GUS.EXE to ARCE.COM and have it invoked by any program that expects both ARCE and SEA's ARC-type compressed files, so that such a program will in fact work with any archive format YOU choose. GUS does not require you to fiddle with cumbersome and difficult configuration files: it's just a single EXE file. You copy it into your favourite utility directory and you can immediately start using it, no hassles at all. ╒══════════╕ │ 3. USAGE │ ╘══════════╛ GUS assumes you have located all archiver programs it has to invoke somewhere in your system PATH. GUS is small and it will only occupy about 21K while shelling out to other programs, which should leave more than enough memory for those archiver programs. 3.1. General Usage under DOS ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SYSTEM REQUIREMENTS: -------------------- GUS will run on any IBM PC compatible computer running DOS 3.0 or greater, provided that at least 21K plus the memory the largest archiver program to invoke would need is available. COMMAND-LINE PARAMETERS: ------------------------ As said before, GUS is command-line compatible with ARCE. Hence, the general syntax is: GUS «compressed_filespec» [filespec(s)] [target_path] [switch(es)] (Entries enclosed within [] are optional, those within « » are mandatory. The [] and « » signs serve to indicate this only and should never be typed!) «compressed_filespec» ::= this specifies where to find the compressed file. If an extension is not given, GUS will assume '.*'. Currently, the following archive types are supported: ARC and ARC+, ARJ, DWC, HYP, LZH (both LHarc and LHA), PAK, ZIP and ZOO. [filespec(s)] ::= specifies which files should be unpacked. You may give more than one file specification, all of which may contain wild cards. [target_path] ::= specifies where to locate the unpacked files. In order to allow GUS to be as flexible as possible, the ordering of the file specifications and the target path is not important. You may define the target path first and then the files to be extracted. It is even allowed to put the target path in the middle of a number of specifications of files to extract! If you give more than one directory, GUS will ignore all but the last. [switch(es)] ::= specifies one or more of the following switches... /I : Identify only, don't shell out (see 3.3 below) /M : unpack Mailarchives only (see 3.2 below) /N : do Not use embedded path while extracting (for the sake of compatibility with ARCE, /5 may also be used) /P : Print file(s) on standard output device /Q : Quiet mode, suppresses shell output /R : Replace existing files /T : Test archive integrity /Gpswd : supply password 'pswd' for Garbled archive All parameters have to separated by at least one blank. Switches may be joined together without spaces, but the '/' character must be present for each switch. GUS does not support the dash '-' instead of the slash '/'. NOTE: ----- Consistent with ARCE's behaviour, GUS will create any directories contained within an archive if they do not exist. Both ARCE and GUS have a commandline switch with which you can prevent this and have them extract to the current directory. If you are using the /M (mail archive) switch however, use of the /N (No embedded paths) switch is automatically assumed and unpacking will always be done in the current directory. The /N switch is also automatically invoked with /P (print) and /T (test). EXAMPLES: --------- 1) Extract all files from an archive CFILE.ANY: > GUS CFILE.ANY 2) Extract all *.COM and *.EXE files from an archive UTILS.ANY into a target directory D:\Utils and replace all existing ones: > GUS UTILS.ANY *.COM *.EXE D:\UTILS /R/N 3) A batchfile LA.BAT which will list any text file inside any archive: LA.BAT: @echo off GUS %1 %2 %3 %4 %5 %6 %7 %8 %9 /P|LIST/S Then you can use this like: LA GUS_140 *.DOC 4) Test the integrity of all archives in the directory F:\Arcs > GUS F:\ARCS\* /T 5) Unpack all ZIPfiles PW*.ZIP protected with password JiMmY into the directory D:\PWS, not replacing any existing files and using any embedded paths: > GUS PW*.ZIP D:\PWS /GJiMmY EXIT CODES: ----------- GUS will yield an errorlevel of 0 if all operations succeeded. If something's wrong, it will pass on the errorlevel returned by the invoked child program. If the child program could not be invoked, GUS will return errorlevel 202 = no such program file found in PATH 203 = non-existing directory 204 = too many open files (increase FILES=... parameter in your CONFIG.SYS file) 205 = access denied 206 = invalid handle 208 = not enough memory to start the child program 210 = invalid environment 211 = invalid format 218 = no more files Note, that GUS will not be able to handle a PATH of more than 255 characters properly. 3.2. Unpacking Mailarchives ~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are a BBS SysOp or a Point connected to a Fidonet Technology compatible electronic mail network, you receive mail packets compressed and bundled within mailarchives. You obviously need to unpack those mailarchives. You can do that in two ways: a) Have your mailprocessor call GUS to unpack the mailarchives. + If your mailprocessor allows you to specify which unpacker it should invoke to decompress mailarchives, have it call GUS. Example for ConfMail: > CM IMPORT AREAS.BBS -K -N -F Conf.Imp -A GUS This approach has the disadvantage that GUS will create any directories embedded in the archive, should they not exist. Another disadvantage is, that the mailprocessor is still in memory. This occupies a lot more memory than is necessary. + If your mailprocessor does not allow you to specify which unpacker to use, it will most likely expect ARCE or PKXARC/ PKUNPAK. Rename GUS.EXE to ARCE.COM or PKXARC.EXE or PKUNPAK.EXE, whatever your mailprocessor wants. If your mailprocessor wants to use an unpacker that needs a specific decompress command (like PAK E Archive), you cannot have it call GUS, since GUS would interpret its first command-line argument as the archive name. Use the method described in item b) to have GUS unpack your mailarchives BEFORE your mailprocessor is started. Since your mailprocessor will only see mail packets then and no mailarchives, there will be no problem. b) Have GUS unpack all mailarchives BEFORE you invoke your mailprocessor. This is the preferred method. You this by starting GUS with the following command-line: GUS «Inbound_directory» /M Instead of the archive name, you specify the path to the directory where your inbound mail is located. Suppose your inbound directory is D:\Opus\NetFiles. GUS will unpack all mailarchives in that directory with the following command: > GUS D:\OPUS\NETFILES /M After a mailarchive has been unpacked succesfully, GUS will delete it automatically. If a mailarchive cannot be unpacked succesfully, then GUS will create a subdirectory BADARC.GUS in your inbound directory and move that mailarchive to it. This allows you to inspect the problematic mailarchives later on while retaining their original name. Other unpack shells always rename a faulty archive to BADARC.001, which makes it very difficult if you would like to restore the archive to its original name after you have inspected and maybe repaired it. I didn't like that procedure, so I decided to let GUS move problematic archives to a special subdirectory instead. Let me know how you feel. 3.3. Identifying Archive Types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ With the /I switch, you can have GUS simply report which archive type is at hand and not do anything else. This switch can be used just to get a list of archive types, like this: > GUS J:\Outbound\*.MO? /I Type Archive Filename ---- ---------------- LZH J:\OUTBOUND\0009FE64.MO1 ??? J:\OUTBOUND\8FDCB1E2.MO1 ZIP J:\OUTBOUND\8FDCB243.MO0 ARJ J:\OUTBOUND\FF24FFE9.MO0 LZH J:\OUTBOUND\8FDCB241.MO0 GUS yields something like the above list. The '???' means that GUS was unable to determine the archive type, possibly because it isn't an archive at all. In this case, it was a zero-length file. A much more useful way of using this switch is to determine the type of just one archive and act upon that. For instance, to add a file to any archive that comes along. If used with /I, GUS will return an errorlevel from 0 to 9, indicating the archive type. Archive Type: Unknown ARC ARJ ARC+ DWC HYP LZH PAK ZIP ZOO Errorlevel : 0 1 2 3 4 5 6 7 8 9 Example: suppose you want to add a header text LOGO.TXT to ZIP and ARJ files, and leave other archive types alone. These batchfile instructions will take care of that: GUS %1 /I if errorlevel 9 goto Finish if errorlevel 8 goto IsZIP if errorlevel 3 goto Finish if errorlevel 2 goto IsARJ goto Finish :IsZIP PKZIP -z %1 <LOGO.TXT goto Finish :IsARJ ARJ c -zLOGO.TXT %1 :Finish ╒═════════════════════════╕ │ 4. BUILT-IN DEFINITIONS │ ╘═════════════════════════╛ 4.1. Built-In Unpacker Definitions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following unpackers are defined by default within GUS.EXE: ╔════╤════════════╤═══════╤═══════╤═══════╤═════╤═════╤════════╗ ║Type│Program │Extract│Replace│Display│Test │Path │Password║ ╟────┼────────────┼───────┼───────┼───────┼─────┼─────┼────────╢ ║ARC │PKUNPAK .EXE│-n │-r │-c │-t │*****│-g ║ ║ARJ │ARJ .EXE│e -n │e -y │p │t │-jf │─g ║ ║A7+ │XARC .EXE│ │/o │***** │*****│*****│/g ║ ║DWC │DWC .EXE│xow │xw │p │t │r │g ║ ║HYP │HYPER .EXE│-x │-xo │***** │*****│p │***** ║ ║LZH │LHA .EXE│e /m+ │e /m+c+│p │t │x+ │***** ║ ║PAK │PAK .EXE│e/WN │e/WA │p │t │/PATH│/g ║ ║ZIP │PKUNZIP .EXE│-n │-o │-c │-t │-d │-s ║ ║ZOO │ZOO .EXE│e: │eSO: │e:p │e:N │// │***** ║ ╟────┼────────────┼───────┼───────┼───────┼─────┼─────┼────────╢ ║ 3 │ 12 │ 10 │ 10 │ 10 │ 10 │ 5 │ 5 ║ ╚════╧════════════╧═══════╧═══════╧═══════╧═════╧═════╧════════╝ The numbers above indicate the number of characters provided for each string. Note that Extract, Replace, Display and Test are COMMANDS, while Path and Password are OPTIONS. The difference is, that an OPTION is always combined with a COMMAND and cannot be used alone. All spaces means that that particular program does not need any parameters for that particular command. All stars means that that particular program does not support that command or that option. You may want to redefine some of those built-in definitions for various reasons. To use another unpacker program, for instance. Or to change some parameters. 4.2. How To Define Other Unpackers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There are two ways to modify the built-in definitions. You can grab a hex editor and change GUS.EXE directly. If you do, please take note of the lengths of the strings as listed above in section 4.1. All strings occupy the specified number of characters. To achieve that, they were padded with spaces where necessary. If you edit them, make sure you retain the number of characters and do NOT change the funny looking character at the start of each string (that's in fact the string length indicator byte). If a particular parameter is not supported by a certain unpacker program, then you should edit the appropriate field to contain all stars. If you own a Turbo Pascal compiler v5.0 or later from Borland International, you can edit the file GUS_WCG.PAS and re-compile it. This small program will update the configuration information at the end of GUS.EXE for you. Do *NOT* modify the record layout of that information, since GUS will not recognize it anymore if you do. Future versions of GUS may come with a complete setup program to edit and save a new configuration. ╒═══════════════════════╕ │ 5. GUS & OTHER SHELLS │ ╘═══════════════════════╛ Since GUS was first created, other authors have joined the club and released their own versions of a utility that identifies archive types and shells out to the appropriate unpacker programs. Some of those other shell programs come with source, others don't. Some have configuration files, others don't. Some are large, others small. Only one is GUS and all the others "ain't"! Why should you use GUS? 1. GUS is small and fast. Other shell programs typically use a lot more memory than GUS does. 2. GUS provides you with all possible commands to allow not only automatic use, but also easy DOS command-line usage. 3. While scanning a file to determine the archive type, the identification bytes have to be investigated in a well-defined order. Only then, the program will not be fooled by things like archives within archives. GUS is the only program that does this flawlessly: it will never be fooled. 4. GUS has built-in code especially designed for archives that have their identification code at the end of the file. If such an archive has been transmitted by means of a protocol like X-modem, some junk may have been appended to the file to make it grow to the next 128 byte or even 1 K-byte boundary! GUS is the *only* program that will recognize an archive with appended junk because it can skip that while scanning. (At this time, this is only needed for DWC archives, but you never know...) 5. The DWC archiver requires its compressed files to have the extension '.DWC' or else it won't work with them. GUS knows this and will rename any DWC archive that does not have the proper extension before calling DWC.EXE and rename it back to the original name afterwards. 6. Because *I* wrote it! <grin> ╒═════════════════════╕ │ 6. RUNTIME MESSAGES │ ╘═════════════════════╛ GUS may produce a number of messages while it's working. I will list all messages below, with an explanation what's wrong. [A] General information messages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ MESSAGE: Child program returns exit code # -> this message is given when the invoked unpacker program returns control to GUS. It shows the errorlevel returned by the unpacker program. The "#" will be replaced by the actual exit code. [CHILD]: «unpacker_commandline» -> this is shown in Quiet mode (/Q switch) instead of the archiver's screen output. The «unpacker_commandline» will be replaced by just that. Extract: ALL files (XARC cannot extract specific files) -> this message is shown when the first four characters of the unpacker program definition string are "XARC". Any files to extract specified on the command-line will be ignored. [B] Warning messages ~~~~~~~~~~~~~~~~~~~~ WARNING: multiple target directories defined -- will use the LAST one! -> you have defined more than one target path on the command-line. GUS warns you that it will ignore all paths but the last. WARNING: unknown switch /X ignored -> you have specified a switch that GUS doesn't know. In the above warning message, the "X" will be replaced by the actual character that you used. GUS will continue but ignores this particular command. WARNING: a slash by itself is not a valid option -- ignored -> you have typed a slash "/" followed by a space or an end-of-line. GUS will continue and ignore this. WARNING: unknown parameter #9 «X» ignored -> you have typed something on the command-line that GUS can't decipher. The actual word you typed will be inserted instead of "X" in the above message, and the number of that parameter on the commandline will be shown instead of the "9" above. WARNING: moving bad archive HHHHHHHH.XX9 to X:\Inbound\BADARC.GUS\ -> in mail unpack mode (/M switch), GUS was unable to unpack an archive and warns you that it will be moved to the BADARC.GUS subdirectory that GUS creates in the mail inbound directory. The actual name of the bad archive will be inserted in the message instead of "HHHHHHHH.XX9" and "X:\Inbound" will be replaced by the path to your mail inbound directory. WARNING: unsupported command -- will do normal extract instead -> you tried to perform an action not supported by the particular archiver defined within GUS (i.e., issue a /T [test] command with the HYPER archiver program). GUS warns you it will ignore that command and do a normal extract instead. WARNING: XXX type can only be unpacked into current directory! -> the unpacker program has no option to enable using embedded directories or creating them, so all unpacking will be done into the current directory, since that is the only way. WARNING: XXX type cannot be garbled - ignoring password... -> you supplied an extraction password for an archive whose unpacker program does not support password-protection. GUS will continue the command while ignoring the /G switch. The "XXX" will be replaced by the actual archive type detected. [C] Fatal error messages ~~~~~~~~~~~~~~~~~~~~~~~~ >ERROR<: cannot read configuration information! MESSAGE: aborting with exit code 255... -> GUS complains it can't find the configuration information at the back of it's EXE file. This means something is terribly wrong with that EXE file. You better delete it and get the original release archive unpacked again! (You *did* save that one, didn't you?) >ERROR<: cannot move bad mailarchive! -> in mail unpack mode (/M switch), GUS encountered a bad archive but is unable to move it to the BADARC.GUS directory. (Possible causes: a file with exactly the same name exists already in the BADARC.GUS directory, or the BADARC.GUS directory does not exist [anymore?] at the time of the move.) The bad archive will remain in the inbound directory and you'd better find out what the heck is going on! >ERROR<: cannot erase unpacked mailarchive! -> in mail unpack mode (/M switch), GUS is unable to delete the mailarchive after it has been unpacked successfully. This more than likely means that the mailarchive was marked Read/Only. You will have to unlock and delete it manually. As mailarchives are created fresh upon receipt, it is very unlikely that they would be marked R/O. >ERROR<: DOS couldn't execute «XXX» due to: YYY -> GUS was unable to load and execute the unpacker program. The path and name of that unpacker will be inserted in the error message instead of "XXX" and the reason will be shown instead of "YYY". That reason will be one of 9 possible problems described in section 3.1. General Usage under DOS, EXIT CODES. If the error code returned by DOS should be unknown to GUS, it will display "DOS ERROR" followed by the error number instead. >ERROR<: error locating directory XXX will unpack in current directory. -> You specified a target directory GUS was unable to find. The target path specification will be ignored and the unpacking will be done in the current directory. >ERROR<: «XXX» is no ARC/ARC+/ARJ/DWC/HYP/LZH/PAK/ZIP/ZOO file! -> GUS encountered a file that is not one of the known archive types. GUS will continue with the next file, if there is one. "XXX" will be replaced by the actual archive name. >ERROR<: no such file(s)! -> GUS was started with an archive filename specification, but no such file could be found. GUS will abort with errorlevel 1. >ERROR<: no such mail directory! -> you specified a mail inbound directory (/M switch) that GUS was unable to locate. GUS will end with errorlevel 0. ╒═════════════════════╕ │ 7. ACKNOWLEDGEMENTS │ ╘═════════════════════╛ + PKUNPAK FAST! Archive Extract Utility Version 3.61 08-02-88 Copyright (c) 1986-1988 PKWARE Inc. All Rights Reserved. + PKUNZIP (R) FAST! Extract Utility Version 1.93 ALPHA 10-15-91 Copr. 1989-1991 PKWARE Inc. All Rights Reserved. PKUNZIP/h for help PKUNZIP Reg. U.S. Pat. and Tm. Off. + XARC - to decompress a standard ARC Format Archive, Ver 7.1, October, 1990 Copyright 1990 by System Enhancement Associates, Inc.; ALL RIGHTS RESERVED + ARJ 2.22 Copyright (c) 1990,91 Robert K Jung All rights reserved. Free for non-commercial personal use. + DWC - Archive utility, Release 5.10, Created 3/07/90 (C) Copyright 1986-90 by Dean W. Cooper; All rights reserved. + Hyper - Pack Utility 2.5 Copyright (c) 1989,1990 P. Sawatzki and K.P. Nischke + LHA version 2.13 Copyright (c) Haruyasu Yoshizaki, 1988-91 + Pak 2.51 Copyright 1988-90 NoGate Consulting + Zoo archiver, Version 2.10 (1991/07/09 02:10:34) (C) Copyright 1991 Rahul Dhesi -- Noncommercial use permitted + ARCE Copyright (c) 1986-91 Vernon D. Buerg. Extract ARC files, Version 4.0g, 4/12/91. All rights reserved. + Conference Mail - Revision: 4.07 by Bob Hartman, FidoNet Node 132/101 (C) Copyright 1986, 1987 by Spark Software Inc. All rights reserved. ╒═════════════════════╕ │ 8. REVISION HISTORY │ ╘═════════════════════╛ Ver. Comment ~~~~ ~~~~~~~ 1.50 - Added the /N (/5) switch to prevent GUS using or creating paths embedded within archives. - Made this switch automatic while working with mail archives (/M). Thanks to John Lots (2:512/36.3@fidonet) and Eef Hartman (2:281/603.5) for suggesting this and detecting the problem with this in GUS 1.40. /N is now also automatically invoked with /P and /T. - Changed the way the configuration information is stored a bit, since there was a useless amount of space being reserved for the "Unknown" type, which of course shouldn't have been saved. - Fixed a minor problem which caused a runtime error when GUS.EXE was given a read/only attribute. Thanks to Rob Essers (2:283/406.2) for reporting this. - Cleaned up the batchfile listing in section 3.3 a bit. Thanks to Roelof Heuvel (27:3331/5000@signet.ftn) for the suggestion. - Fixed a minor problem which caused GUS to not append '.*' to a filename given without an extension when the pathame would contain a dot somewhere. Thanks to Hans Siemons (2:285/214@fidonet.org) for reporting it. - Because of a space inserted between the appropriate switch to supply a password to an unarchiver and the actual password it- self, encrypted archives could never be unpacked. This is now fixed. - Made minor modifications for PKUNZIP 2.00, due to some changes in the way that one handles its command options. - The `use path' option was always supplied with the ZOO unpack commands. Corrected. 1.40 - Removed MDCD archive support again, since nobody was likely to use it -- unless you're looking for the worst performing archiver ever, of course. - Added support for the new LHA version 2 archiver from Yoshi, which succeeds LHARC. The previous version of GUS could already handle the new compression, but I didn't expect the name of the program to be changed. - Added support for the ARJ archiver program from Robert K. Jung, which yields nearly always the best compression and has a lot of features. - Added support for the HYPER archiver program from Germany, which seems to outperform every other archiver on 600..800K logfiles ONLY. Weird. - Added support for ARCfiles made by the new ARC version 7 compressor from SEA. At this time, only one public domain extractor is available, which unfortunately lacks almost every feature GUS has to offer. My thanks to Donn Bly (1:236/7@fidonet.org) and Jeffrey Nonken (1:273/715@fidonet.org) for providing me with all the information on the ARC7+ archive format and the XARC program. - GUS is now fully commandline compatible with Vernon Buerg's ARCE program. All of ARCE's switches are supported - except for /5, which prevents ARCE from creating subdirectories contained within ARCfile entries. - GUS provides two extra options: /I will identify an archive type by means of the exitcode (errorlevel) and /M will unpack and delete mailarchives in Fidonet Technology Networks. - BUGFIXES: * cleaned up handling zero-length and read/only files. From now on, GUS won't abort with a runtime error on those. * you could only specify one single file to extract on GUS's commandline, although the help screen and manual suggested you could give more than one filespec. That's also corrected now. - OTHER IMPROVEMENTS: * the code which detects the archive type has been completely re-written and now is a *lot* faster than before! 1.31 - This version was never released, but mentioned in the documentation of the ARCA*Simulator v2.31 (ASIM_231.LZH). 1.30 - This version was never released, but mentioned in the "Latest Software Versions" column of the FidoNews magazine. 1.20M Added MDCD archives, corrected an error which made GUS not recognize uncompressed file entries in an LZH archive, made sure the new compression method of PAK is supported, added features to allow selection of files and target directory for unpacking. This is a maintenance release, hence the 'M' behind the version number. 1.10 - Added LZH archives, and changed the way DWC archives are identified in order to identify them even if up to 1K of rubbish is appended to the end of a DWC archive. This is useful for DWC archives which have been transferred by means of an Xmodem protocol. 1.00 - Base version. (Turbo Pascal 5.0) _______________________________________________________________________(eof)__