Apple //e De-ARC Version 1.1 8/23/88 The original ARC is Copyright (c) 1985 by Thom Henderson, System Enhancements Associates. The port to the Apple //GS (DEARC only) is Copyright (c) 1987 by Tim Swihart, P.O. Box 26303, Fort Worth, TX 76121. The port of De-ARC to the Apple //e is Copyright (c) 1988 by David R. Larsen, P.O. Box 160313, Cupertino CA 95016, All Rights Reserved. 1. Introduction ARC is an archiving utility first developed on the IBM PC. Versions now exist for Amiga and Atari as well. Early versions simply packed multiple related files into a single file for ease of storing and manipulating. Later versions began to compress the files as well, to reduce disk storage space and to reduce telecommunication time when moving the files between machines. ARC is widely used in the IBM PC world for source code and executables, and in the Amiga world for picture files. ARC is frequently used as a method of compressing text files on bulletin boards and Information Services, and are typically stored under names such as "knr.arc". Until recently, there was no way for Apple //'s to take advantage of these text files. Then Tim Swihart ported the de-ARC code from the PC version written by Thom Henderson and System Enhancement Associates to the Apple 2 GS. Dearc2e is a port of the 2GS version of the de-ARC code, to run on the Apple //e. This program only De-ARCs files. A future release may include the capability to ARC as well. Supported compression types are the "Packed", "Squeezed" (Huffman), "crunched" (LZW) and "Crunched" (Dynamic LZW). A compression type being used in some IBM PC implementations, "Squashed", is not supported. 2. System Requirements An Apple //e or //c with 128k, and ProDOS 8. An accelerator card is recommended but not required. Dearc2e has only been tested on an enhanced //2, but I know of no reason it should not work on unenhanced //e's and //c's. The contents of auxiliary memory, typically devoted to /ram, will be deleted. If dearc2e thinks there is something in /ram, you will be asked if this is acceptable. If it is not, dearc2e will exit. 3. How to use it Dearc2e is a ProDOS 8 SYS file. It may be started from a shell or from Applesoft using the - command. A list of available options will be provided: [L]ist contents of an archive [E]xtract contents of an archive [S]et name of archive to work with [Q]uit You may then enter one of the commands, either in upper case or lower case. 3.1 List For each file stored in the archive, the List command displays its name, its size as stored in the archive and as it will be when removed, and the method of compression used. File names may contain illegal ProDOS characters; dearc2e will change any invalid characters to periods, and leading numbers to 'z' when the file is extracted. If the Set command has not yet been given, you will first be prompted for the name of the archive file to use. Standard ProDOS path names may be used. This will then Set that file for subsequent use. 3.2 Extract The Extract command actually removes one or more files from the archive. You are first prompted for the archive file name if it has not yet been provided. The Extract command will put the de-ARCed files into the same directory as the archive file. You are then asked if you want to extract All, Some or None of the files; if None, the extract command is cancelled and you are returned to the initial command list. If you select Some, you are then asked file by file if you want that file to be extracted or not. Enter y or n, or to cancel extracting, enter a q. While extracting a file, an approximate percent complete will be displayed to show progress. 3.3 Set As stated above, Set allows you to specify the name of the archive file to use for subsequent operations. This allows you to de-ARC several files without quitting and restarting. If you mistype the file name at one of the other commands, use Set to change it. 3.4 Quit Quit terminates the program. 3.5 A Potential Problem When Dearc2e is run from BASIC.SYSTEM, typing in the name of the file to de-arc without also entering its prefix may not work, even if the file is in the current prefix. This is due to a bug in BASIC.SYSTEM. If this happens, you'll get the message "Illegal arc file". Simply enter the file name again using the full prefix. If you set the prefix just before invoking Dearc2e, this problem does not seem to appear. 4. Changes from Previous Releases Version 1.1 differs from 1.0 in the following ways: * A problem that could cause a crash when exiting was fixed. * The screen is now automatically initialized to 80 columns. * If the requested file is not found or is not a valid ARC format file, the program no longer exits after reporting the error. * The performance of the screen updating has been improved somewhat. 5. Development Details (for those who care) Dearc2e was developed on an enhanced Apple //e, under ProDOS 8 version 1.4, with the following additional hardware: 128k, 512k Ramfactor, Transwarp Accelerator, Sider 10 Meg Hard disk. The code is written in C, using Manx Aztec C65 for Apple //, version 3.2b. Most of the code came from Tim Swihart's Apple 2 GS version. I modified it to use auxiliary memory for the large memory buffers. I also added a few more niceties, including displaying the percent done, since the //e version is slower than the 2 GS version. 6. Conclusion and legal stuff I have alluded above to possible future releases. These may or may not occur, depending on a variety of things. In the spirit of the original sources for this program, it is considered Freeware. No payment is required, but if you find it useful, I will gladly accept a registration fee of $10; for that you will receive at least one additional upgrade, should there be one. Please let me know what version you have when registering. You may distribute this program provided that this document is distributed with it. Copies of the program may not be sold for more than $10. Dearc2e is supplied as-is and the author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and the warranties of fitness for any particular purpose. David R. Larsen GEnie address: D.LARSEN2 US Mail: P.O. Box 160313 Cupertino CA 95016-0313