------------- DC Xtract 2.1 ------------- Program written by Paul W. Lee (C) Copyright 1990 Double Click Software DC Xtract revolutionizes the method used to manipulate your archive files. No longer will you need to remember dozens of command line options or be forced to use shell programs. DC Xtract handles in one program, the equivalent of four different compression-archival programs, with a user interface unmatched by any other archival system. DC Xtract uses a GEM window to show the files within a archive. Then you can select on the file and perform various functions with it. ------------------ Window Information ------------------ DC Xtract shows the file information in the following format: YMODEM.DOC 66489 Crunch 58% 28538 10/27/87 10:00a C291 ^ ^ ^ ^ ^ ^ ^ ^ | | | | | | | | Filename | | | | | | | Original | | | | | | Method | | | | | Ratio | | | | Compressed | | | Date | | Time | CRC Note: ZIP uses a 32 bit CRC, because of the limited space within the GEM window, DC Xtract shows only the lower 16 bits. --------------- Selecting Files --------------- You can select a single file by pointing the mouse to it and clicking on the left button. Selecting multiple files may be done by using the rubber box. Note: Pressing on the LEFT shift and using the rubber box will also select files within a sub-directory. ------------------- Main Dialog Buttons ------------------- CONFIG ------ After clicking on the 'CONFIG' button, you will be presented with the 'DC Xtract Configuration Menu'. There are 11 options which you may adjust: Archive Format : ARC,LZH,ZIP,ZOO,AUTO ---------------- This allows you to select between four archive file formats : ARC,LZH,ZIP,ZOO and AUTO. You may use the following keys to switch formats from the main dialog. In AUTO mode, DC Xtract will use the file extender to select the mode. F1 = ARC, F2 = LZH, F3 = ZIP, F4 = ZOO, F5 = AUTO Overwrite existing files : NO or YES -------------------------- With this option set to 'NO' and a file with the exact name is found, a prompt will appear asking you if you want to overwrite existing file, skip, or quit. If this option is set to 'YES', no prompt will appear. Create directories : NO or YES -------------------- If this option is set to 'NO', all files will be extracted to the path you have seleted. With this option set to 'YES', directories will be created starting with the path you have selected. Add directories : NO or YES ----------------- If this option is set to 'NO', only files in the current directory will be added to the archieve. With this option set to 'YES', all files in the current directory and subsequent subdirectories. Show directories : NO or YES ------------------ Setting this option to 'YES' will show files which are archived within archived to be shown. Otherwise, the file is shown as one archive file. For example, if a ARC file is contained within another ARC file, and this option set to 'YES', you can see the files of the second ARC file. Maintain file Date/Time : NO or YES ------------------------- Setting this option to 'YES' will use the date and time given in the archive header of each file, instead of the current system date and time. Using 'NO' will use the current system date and time. Abort on bad header : NO or YES --------------------- Setting this option to 'YES', DC Xtract will abort reading the archive headers if a bad header is encountered. However, there may be times which you may want this set to 'NO', to recover files in a corrupted archive file. Note: Recovering bad headers may take long periods of time, if you feel too much time has elapsed, press the ESC key to abort. Auto select all : NO or YES ----------------- If this option is set to 'YES', then all files will be selected when the archive is first opened. Source Path : SAVED or CURRENT ------------- If this option is set to 'SAVED', the source path for archives will be the user defined path. Otherwise, the current path will be used. Destination Path : SAVED or CURRENT ------------------ If this option is set to 'SAVED', the destination path for extracting files will be the user defined path. Otherwise, the current path will be used. Entries : ??? --------- Enter the maximum number of files to allow for an archive. This allows you to free up memory when running as a desk accessory. (C) --- Copyright and miscellanous information. SAVE ---- Clicking on the 'SAVE' button will cause a file selector to appear. You must find 'DCXTR20.PRG' or 'DCXTR20.ACC' to save the current configuration settings to. OK -- Return to main dialog. SEARCH ------ DC Xtract allows you to search for an archive for specific filename or extender. Clicking on 'SEARCH' you will be presented with the 'Search Menu'. You will notice there are 20 pre-defined file extenders that are supported by DC Xtract. You may select on one or more of these extenders, however, if none of the pre-defined extenders suits your needs, you may choose a user definable extender. Note : The is no wildcard matching on extenders. If you have a need to use wildcard searching use 'MASK 1' or 'MASK 2'. Files to search : Current or All ----------------- If set to 'Current', only the files on the current level are selected. For example, if you are on the root level of the archive file, only those files are searched. Other files which are contained is sub-directories are NOT searched. With this option set to 'ALL' every file in the archive is searched. Mode of search : Select or Unselect ---------------- If set to 'Select' and a match has been found, then the file will be highlighted. If set to 'Unselect' and a match has been found then the file will be unhighlighted. Search ------ Begin searching archive files. After a search has been done, a prompt will appear informing you the number of matches that have been found. Use may use the 'F' key from the main dialog to begin the search function. Exit ---- Return to main menu. ADD --- Create or Add selected file(s) to an archive. The first file selector will ask to for the archive file you wish to add to. If you are creating a new archive file then enter the name and click on 'OK'. The next file selector will ask for a file(s) to add to the archive. When you are finished, just click on 'CANCEL'. The selected file(s) will be printed to the screen, and a alert box will ask you if the file(s) are correct. Note: To include the full pathname or sub-directories in a file, you use the '*' character in the filename. Examples -------- Path : ------ A:\DEMO\*.* Filename : *.* Then, all the files and directories within the DEMO directory will be added to the archive file. Filename : *.PRG Only files with the 'PRG' extender will be added to the archive file. Pressing the ESC key will abort the adding process. EXTRACT ------- Extract selected file(s) within an archive. You will be presented with a file selector to select the destination path to write the extracted file(s) to. Note: If sub-directories need to be created, they will start from the path you select. Pressing the ESC key will abort the extraction process. PRINT ----- Print the contents of a selected file(s) within an archive. TEST ---- Test the contents of a selected file(s) within an archive. VIEW ---- View the contents of a file(s) within an archive. During view, you can use the mouse to control the paging of the text. LEFT button or SPACE bar to page down , RIGHT button or ESC to abort viewing the current file. OK -- Begin executing the selected function. If a archive has not been selected, a file selector will appear. Select on a file, and the information and files in the archive will be displayed within a window. Now, you may select on the files within the archive. Exit ---- Exit DC Xtract. ------------- Helpful Hints ------------- 1) Like the desktop window, you can move the mouse to the far left column of the window and press on the left button to engage the rubber-box. Note: If you hold down the left-shift key while 'rubber boxing' files, this will select files within a sub-directory. 2) Keyboard equilavents: A - Select Add button C - Configuration menu E - Select Extract button F - Search files ( using search menu parameters ) P - Select Print button Q - Exit program S - Search menu T - Select Test button V - Select View button W - Close window or current directory X - Select all files Z - Unselect all files F1 - ARC F2 - LZH F3 - ZIP F4 - ZOO HELP - Brief help dialog ALT-A - Add ALT-D - Toggle subdirectory create bell=on, otherwise off ALT-E - Extract ALT-P - Print ALT-T - Test ALT-V - View DOWN arrow - scroll window down a line UP arrow - scroll window up a line SHIFT&DOWN arrow - scroll window down 1 page SHIFT&UP arrow - scroll window up 1 page 3) You can rename 'DCXTR20.PRG' to 'DCXTR20.ACC' so you can have the program become a desk accessory. 4) To use another archive file, simply click on the close button of the window and the file selector will appear.