The Ham Radio & Scanner Companion

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

/ The Ham Radio & Scanner Companion / scanner.iso / pcutil2 / sd-300.exe / SD.DOC < prev next >

Wrap

Text File | 1991-12-18 | 103KB | 2,248 lines

StupenDOS 3.0 A Stupendous Dos Shell By Eclipse Technologies P.O. Box 23136 Milwaukee, WI 53223 USA (414) 354-7040 StupenDOS 3.0 Order Form ========================================================================= Send StupenDOS registrations to: Eclipse Technologies P.O. Box 23136 Milwaukee, WI 53223 Phone: (414) 354-7040 With registration, you will receive a diskette, and a printed manual for StupenDOS. You will also be notified of inexpensive upgrades. The cost for upgrades is currently $7 plus shipping. Please make payments in USA funds drawn on a USA bank. We are unable to cash checks drawn on foreign banks. The best method for payment overseas is to get an American Express International Money Order. Site License and Volume discounts available. Dealer inquiries invited. ORDERING INFORMATION ========================================================================= StupenDOS Version 3.0 & Printed Manual . . . . . . . . . . . . . . $35.00 Sales Tax & County Tax (Wisconsin Residents ONLY: 5.5% $ 1.93). . Shipping & Handling ($3.00 USA, $5.00 Foreign) . . . . . . . . . . ______ Total Enclosed . . . . . . . . . . . . . . . . . . . . . . . . . . Current SD Version Number ______ Date _____________ Name: _______________________________________________________________ Company: _______________________________________________________________ Address: _______________________________________________________________ City: __________________________ State: _____________ Zip: _________ Country (if not USA) _____________________________ Phone: (______)_____________________ Method of payment ========================================================================= __ Check enclosed __ American Express International Money Order __ MasterCard Card# Expiration: / __ VISA Card# Expiration: / Signature _____________________________________ (Required for credit cards) Diskette Size: ___ 5 1/4" Low density (360K) ___ 3 1/2" Low density (720K) Thank you for your order. Please allow 5-10 days for delivery. Questionaire (Optional) ========================================================================= Where did you find out about StupenDOS ? Have you used previous version of StupenDOS ? How do you think StupenDOS compares to other DOS Shells ? Do you have a modem ? Please list any Comments or Suggestions: Page 1 Basics 3 Installation 3 Keyboard Usage 4 Mouse Usage 4 Starting StupenDOS 4 How to Select Pull Down Menus 5 Tagging Files 6 Shortcuts from the Main Screen 7 Changing Directories and Drives 7 Changing Drives 7 Single Letter Options 7 The Pull Down Menus 8 DOS 8 SORT 13 TAG 14 MORE 17 FILE 20 ZIP 22 SETUP 23 EXIT 28 Modes (Full Screen) 29 File Finder 29 Tree 30 Zip 32 Unzip 35 Configurable Options 37 Programming KEY Commands 39 Programming RUN Commands 41 Programming USR Commands 43 Page 2 CREDITS Written by Douglas Hay. Written in Borland C++ and Assembly Language Special thanks to: Dennis Meilicke Developer, Testing Phil Katz Programming tips Ralf Brown Spawn Routines Rick Carrara, Kevin Clark, Mark Downing, A. Mark Fonda, Chris Herriges, Mark Kolpin, Stuart Lindenberger and Dave Mize for testing the software. StupenDOS is a DOS SHELL program that increases your productivity. Repetitive DOS commands are eliminated with easy to use commands. StupenDOS uses Pull-Down menus, so all the commands are easily accessible. Many shortcut keys are also provided, so as you become more familiar with the program, you can become even more productive. You can even reconfigure the keyboard so that you can configure and create your own shortcut keys. Page 3 BASICS INSTALLING StupenDOS HARD DISK: Copy the files from the distribution diskette to a location on your disk that is in your PATH statement. If you are not familiar with the PATH statement, refer to your DOS manual. You can type in PATH from the DOS prompt to display your current PATH setting. Suppose your path statement says something like: PATH=C:\DOS;C:\UTIL;C:\WINDOWS You can copy StupenDOS into the C:\UTIL directory by typing: COPY A:*.* C:\UTIL All StupenDOS commands work in a similar way. After you have used a few commands, you will have mastered how the other commands work as well. When StupenDOS is first run, it displays the files in the current directory (or any directory you wish). This is called the Filelist. These are the same files you would see if you used the DOS command DIR. Page 4 KEYBOARD USAGE ESC Cancels a command Removes a pop-up window ENTER Tag highlighted file or RUN highlighted file (Configurable) Change directory from Main Screen Selects commands from Pull- Down menus Accepts text that you have typed Home Go to the first file in the Filelist End Go to the last file in the Filelist PgUp Go up one page in the Filelist PgDn Go down one page in the Filelist UpArrow Go up one file in the Filelist DownArrow Go down one file in the Filelist ALT keys Many ALT key combinations are used. ALT key combinations can be programmed CTRL Keys Very few CTRL key combinations are used. CTRL key combinations can be programmed. Function keys The available Function Keys are always listed on the bottom line of the screen. Mouse Usage The left key of the mouse works like the ENTER key on the keyboard. The right most button works like the ESC key on the keyboard. If your mouse has three buttons, the middle button is not used. STARTING StupenDOS Type SD and press the ENTER key at the DOS prompt. C:\> SD This will run StupenDOS in the current directory, and all of the files in the current directory will be displayed. If you only want to display certain files, type in the filespecs desired after SD. For example, if you want to run StupenDOS and just show *.DOC and *.TXT files, type: C:\> SD *.DOC *.TXT You can also specify files to exclude. Suppose you wanted all *.DOC files, but not the files that start with the letter A. You would type: SD *.DOC -xA*.* The -x tells StupenDOS to exclude that filespec from the filelist. You can also open two file windows when starting StupenDOS. Suppose you want to see all *.EXE and *.COM files in the C:\DOS directory, and all SD*.* files in the D:\UTIL directory. You would type: SD C:\DOS\*.exe *.com D:\UTIL\SD*.* Page 5 Exiting StupenDOS Press ESC repeatedly, or press CTRL X to exit to the currently selected directory. How To Select Pull Down Menu The Pull Down menu items are listed on the top line of the screen. One letter in each item is capitalized and is a different color. Press ALT + the capitalized letter to select the desired menu. The menus can also be selected by pressing the RIGHTARROW or LEFTARROW key, until the desired menu is displayed. MOUSE: Click once on the menu name at the top of the screen. Selecting items in a Pull Down Menu Use the UPARROW and DOWNARROW keys to move the highlighted bar up and down while in a Pull Down menu. Some items in the Pull Down menus can be either selected or not selected (turned ON or OFF). To toggle an option, press the SPACE bar. Some options are either/or options. For example, in the Prune and Graft option, you are asked to select from either Copying or Moving the files. You can only do one or the other, but not both. This would be displayed as follows: (*) Copy ( ) Move An option with a dot indicates that this option is selected. Some options can be selected in combination with other options. For example, the Print Directory menu allows you to print information about the files in the filelist to the printer. You can choose to print additional information about the files, such as the Size, Time, and Date of the files. These items can be selected independently of each other. Items such as these are displayed with brackets. Empty brackets indicate the item has not been selected. Brackets with a 'X' between them indicate the option has been selected. In the example below, the Size and Date have been selected, but the Time has not been selected. [X] Size [X] Date [ ] Time Press the ENTER key to select the highlighted item. If the item is an option that you wish to toggle, press the SPACE bar to toggle the option. Important: There is a highlighted letter in most items, and pressing this letter will select that item. If the item is a option that toggles, pressing the highlighted letter will toggle the option. Page 6 MOUSE: Click on the item you wish to select with the left mouse button. If the item toggles, clicking the left button will toggle that item. Moving Around the Filelist Use the UPARROW and DOWNARROW keys to move up or down one line at a time. Use PGUP and PGDN keys to move an entire page at one time. The HOME key will place you at the top of the filelist, and the END key will place you on the last file in the filelist. MOUSE: To move the highlight bar up and down, click on the arrows that point up and down at the top and bottom of the file scrollbar (See figure 1). Click once to move the filebar one file, or hold down the mouse button to scroll continuously. This simulates the UPARROW or DOWNARROW keys on the keyboard. Click on the horizontal bar above the filelist to go one page up in the filelist. This simulates PGUP. Click on the horizontal bar below the filelist to move down one page in the filelist. This simulates PGDN. You can also click on the scrollbar to move rapidly through the filelist. Clicking near the top of the scrollbar will locate you near the top of the filelist. Clicking near the middle will locate you near the middle of the filelist. For example, if there are 200 files in the filelist, and you click near the middle of the scrollbar, you will be located near file 100. Tagging a File When you want to perform an operation on a file, or a group of files, you need to tell StupenDOS which files to use. This is done by tagging the desired files. There are several ways to tag a file or a group of files. All of the different methods are described later in the TAG Pull Down Menu section. To tag a single file, you would use the ARROW keys (described above) to highlight the file you wish to tag. Then press the SPACE bar to tag that file. MOUSE: Click on a file to tag. Page 7 Shortcuts from the Main Screen Function Keys The bottom line of the screen lists StupenDOS' most commonly used features. There is a function key that is associated with each function. Press the function key to access that function without having to use the Pull Down menus. MOUSE: The bottom line of the screen list StupenDOS' most commonly used features. Click on the text to activate that option without having to use the Pull Down menus. ALT keys Hold down the ALT key for several seconds, and a Pop Up window will appear. This window will contain a list of available ALT key options. This list does not include ALT key combinations you have configured with the SD.PRO file (described later). Changing Directory MOUSE: The current directory name is displayed at the top of the filelist. You can click on this directory name to change to that directory. For example, if the current directory is C:\UTIL\SD\300, you could click on the letter U in UTIL to change to the C:\UTIL directory. If the desired subdirectory name is displayed in the filelist, double click the mouse on the subdirectory name to change to that directory. Changing Drive MOUSE: All disk drives available to the system are listed in the lower right-hand corner of the screen. To change to a different disk drive, click on the drive letter you wish to change to. Single letter Options StupenDOS has several shortcut keys that are active from the main screen. These keys are listed in the Pull Down menus to the right of each item. Not all functions have shortcut keys. Several options are selectable by pressing a single key. The help screen contains a list of these shortcut keys. The help screen can be viewed by pressing F10. Page 8 The Pull Down Menus DOS The items in the DOS menu are items related to DOS commands. In this menu you will find commands to Copy files, Delete files, Rename files, etc. All the commands are listed below. COPY Shortcut Keys: F1 or C Copy is one of StupenDOS' most used commands. Tag all of the files you wish to copy (see the section TAG Pull Down Menu). If you do not tag any files, the highlighted file will be copied. Now select the COPY option from the DOS Pull Down Menu (ALT D), C. The shortcut key for copy is F1. A PopUp menu will appear. You can then enter the drive and/or directory you wish to copy to. To copy the files to the A: disk drive, just type in A:, and press the ENTER key. StupenDOS will then copy all of the tagged files to the specified drive/directory. The information you entered will be retained, just in case you want to copy more files to that same location. Up to three copy locations will be retained. You can also modify the old directory locations that have been retained. MOUSE: To copy to a drive, without specifying a directory name, you can click on the drive letters that appear below the COPY TO: area. If two file windows are open, you can copy the tagged files to the other window by pressing F1. See the FILE Pull Down Menu for information on opening a second file window. The destination drive/directory can also be selected from the Tree Display. This is done by pressing the F2 key. See the MORE Pull Down Menu for information on how to use the Tree Display. Before copying, many different options can be selected from the Copy window. If these options are changed, they will retain the new value until you change it again, or until you exit StupenDOS. These options are described below. After you have selected the copy destination, press the ENTER key to start the copy process. The process can be aborted by pressing the ESC key. Overwrite StupenDOS will normally overwrite files with similar names (like DOS does). If you want to be asked before overwriting a file, turn off the Overwrite option. Page 9 Error Check Free Space Available On Floppies Suppose you have 10 files tagged, and you wish to copy these files to the A: drive. If this option is selected, StupenDOS will make sure sufficient disk space exists on the destination drive before starting the copy. If there is not enough space, you can still copy as many files as possible before the disk is full. At that time, StupenDOS will ask you if you want to stop copying files, or if you want to insert another disk and continue copying. Clear Tag After Copy or Move If selected, the file tag will be removed after a file is successfully Copied or Moved. This is useful when coping many files to floppy disks, and you are sure the files will not all fit on the floppy drive. After each file has been copied, the tag will be cleared, so the files that remain tagged have not yet been copied. Newer The newer option tells StupenDOS to check the time and date of the file being copied. If the destination file exists, the file will only be copied if it has a newer time and date than the destination file. This is useful when copying several files to a floppy disk. Suppose you have a floppy disk that contains backup files. You can easily update the files on the floppy without recopying the files that are unchanged. The files that have not changed will not be copied because the times and dates are identical. Only If Target Exists The file(s) will be copied only if the destination already contains a file of the same name. Useful for updating files. Only If Target Does Not Exist The file(s) will be copied only if the destination does not contain a file of the same name. Useful for getting files off a floppy that you may have deleted or not installed previously. Move Shortcut Key: F2 or M Moving files works much the same as COPY. The only difference is that the source files are deleted after the file has been copied. Page 10 Delete Shortcut Key: F4 or D The Delete function is a very powerful option. Care should be taken to insure that only files you want deleted actually get deleted. To delete a file or a group of files, tag the files you wish to delete. Then bring up the DOS Pull Down Menu. Then either highlight the DELETE option, or press the letter D, which is the highlighted shortcut key. The DELETE Sub Menu will pop up. Highlight the DELETE TAGGED FILES option in the Delete Sub Menu, and press ENTER. The menus will disappear, and the tagged files will be deleted. The number of files deleted, and the bytes used by these files will be displayed on the right side of the screen. You can also set the CONFIRM option, which will ask you if you really want to delete each file before StupenDOS deletes that file. If you are a computer novice, you may want to confirm files before deleting. Note: Pressing ALT F4 from the main screen deletes all of the tagged files without confirmation. This should be used with extreme caution! Delete Highlighted File This option deletes only the file that is highlighted, rather than all tagged files. This is useful when you may be tagging files to copy, and see a file that you want to delete. You can delete the file, even though other files may be tagged. Delete *.BAK Global Delete *.BAK Local Many programs leave behind files with .BAK extensions. These files are usually backup files that are unnecessary. These files can consume precious disk space that could be used by other applications. StupenDOS can delete these files quickly. The DELETE *.BAK GLOBAL option will delete all of the *.BAK files from the current drive. It will look through all directories and delete all .BAK files. The DELETE *.BAK LOCAL option will only delete the *.BAK files from the current directory. Delete Specified Delete Specified works like the DELETE *.BAK GLOBAL option, but it allows you to select the files that will be deleted. Suppose you want to delete all files that have a .TMP extension. Select the Delete Specified option, type in the filespec you wish to delete (*.TMP), and press the ENTER key. Page 11 Change Drive Shortcut Key: F5 or V When you need to change to a different disk drive and/or directory, the Change Drive option can be used. Select the Change Drive option from the DOS Pull Down Menu. This menu can also be selected by pressing F5. A Pop Up menu will appear. Type in the new drive and/or directory. Press the ENTER key. If you have previously changed drive/directory, the information you entered previously will be displayed. You can use the ARROW keys to highlight this information and edit it (if necessary), or just press the ENTER key to change to that drive/directory. MOUSE: If you have changed drive/directory before, you can Double Click on the text of the new drive/directory. Save Directory Information to Disk If there is a drive/directory that you change to often, you can save this information to disk so that you do not need to type this information each time you run StupenDOS. After you successfully changed drive, bring up the Change Drive menu again, and press F1 to save the drive information to disk. The next time StupenDOS is run, this information will automatically be loaded. TYPE File Shortcut Keys: F8 or Y You can view text files from within StupenDOS with this option. You may use any program you like to display the files. If you do not have a file viewer or text editor, you can use the DOS Command TYPE. The program used to display the file is selected in the SETUP Pull Down menu. See the SETUP, External Programs section later in this manual. To view a file, highlight the file you wish to view. Select the TYPE FILE option from the DOS Pull Down menu. The screen will be cleared, and the file will be displayed. If you have not configured an external program to call to view the file, StupenDOS will ask you if you want to use the DOS Type Command. TYPE All Tagged This option works like TYPE File, except that all tagged files will be displayed, rather than just the highlighted file. The files will be displayed one by one, starting from the beginning of the filelist. Page 12 EDIT File This option is similar to TYPE File, except it is designed to edit the tagged file, rather than just view the file. The program used to edit the file is configured in the SETUP Pull Down menu. EDIT All Tagged Similar to TYPE All Tagged, except the files may be modified, instead of just being viewed. See TYPE All Tagged and EDIT File options above. MAKE Directory (Pop-Up) This option is similar to the DOS Command MKDIR or MD. You can make a directory on any legal drive. Select the Make Directory option. Type in the name of the directory you wish to create, and press the ENTER key. REMOVE Directory (Pop-Up) This option is similar to the DOS Command RMDIR or RD. If you want to remove a directory that is a subdirectory of the current directory, you can just highlight the directory you wish to remove, and select the Remove Directory command from the DOS Pull Down menu. A Pop Up menu will appear. If you currently have a directory highlighted, this name will be inserted automatically. Enter the name of the directory to remove, and press the ENTER key. RENAME File / Directory (Pop-Up) This option is similar to the DOS Command RENAME or REN. Rename will work on all tagged files. Select the Rename File option from the DOS Pull Down menu. A Pop Up menu will appear. StupenDOS will show you the current name of the file. You are required to enter the new name of the file. The new name is initially set to the current name of the file. You can then modify the name to the new name desired. If several files are tagged, and you want to skip a file, pressing F2 will go to the next tagged file in the filelist. If you are done renaming files, you can press the ESC key to abort renaming files. Directories can be renamed in the same manner as files. Page 13 SORT Shortcut Key: S When the files are read from disk, StupenDOS can automatically display the files in different orders. The default method is to sort alphabetically by filename. Subdirectories are listed first, followed by the files. The default display (sort) method can be changed in the SETUP Pull Down menu, so the files will be sorted by the method you prefer every time StupenDOS is run. To display the files by another method, bring up the SORT Pull Down menu by pressing ALT S, or by pressing the letter S, which is the shortcut key. You can sort by File Name, File Extension, File Date, File Size, or leave the files unsorted. You can also select ascending or descending order. Use the ARROW keys to highlight the desired sort method and press the ENTER key. If you wish to toggle the sort order from ascending to descending, or from descending to ascending, highlight that line using the ARROW keys and press the SPACE bar. NAME Sort the filelist alphabetically by the eight character File Name. If two identical names are found, the files extensions will be used to sort the files. For example, SD.A would be listed before SD.B. EXTENSION Sort the filelist alphabetically by the three letter File Extension. DATE/TIME Sort the filelist numerically by the File Date and Time. SIZE Sort the filelist numerically by the File Size. UNSORTED The filelist will be displayed without being sorted. This is the same order the files would appear in if you used the DOS Dir command. Page 14 TAG Pull Down Menu Tagging files is a very important option. It allows you to quickly select a group of files that StupenDOS can perform an operation on. You can tag a single file, or a group of files. You are also able to clear tags with this menu. When a file is tagged, there is a tag character immediately to the left of the filename. There is a indicator on the far right side of the screen showing the number of files tagged, and the number of bytes in these files. To bring up the TAG Pull Down menu, press ALT T. TAG ALL FILES If you want all files in the filelist tagged, use this option. All files will be tagged, and the bytes tagged will be displayed. If a file is already tagged, it will be remain tagged. CLEAR ALL TAGS Shortcut Key: ALT C If you would like to clear all the file tags, use this option, or press ALT C from the main screen. All of the file tags will be removed, and the number of files tagged and the bytes tagged will be zeroed. TAG Files Toggle The ( ) parentheses indicate that this item can be toggled. If a dot appears between the parentheses, the item is currently selected. If this option is selected, the other options in the TAG menu will tag files. If it is not selected, the other options in the TAG menu will clear file tags. For example, if this option is selected, and you tag files by name, and select *.EXE, all files with the .EXE extension will be tagged. If this option is not set (no dot between the parentheses), then tagging by name would clear all files with the .EXE extension. The TAG All Files and Clear All Tags options are not affected by the TAG Files or Clear Tags Toggles. Another use of this option could be if you wanted to copy all files except the *.EXE files to a floppy drive. You would first tag all files, and then set the CLEAR Tags Toggle, and then select the tag by Name option, and enter *.EXE. The result would be that all files would be tagged, except for the files with .EXE extensions. CLEAR Files Toggle If this option is set, the tag operations will clear file tags, rather than set the tags. See the Tag Files Toggle for more information. Page 15 NAME (Pop Up) When you want to tag (or clear) files by Filename or File Extension, you use this option. After selecting this option, a Pop Up window will appear. Enter the filespec (name of the file, wildcards are legal) you wish to tag (or clear), and press the ENTER key. The files specified will be tagged, and the number of files and the bytes tagged will be updated. SIZE (Pop Up) You can tag (or clear) files by File Size using this option. After selecting this option, you are required to enter the size to compare the files in the filelist against. You can press the ARROW keys to toggle the operator that will be used for the comparisons. You can select less than, less than or equal to, equal to, not equal to, greater than or equal to, or greater than. After you have selected the operator, and have entered the size to compare against, press the ENTER key. The files specified will be tagged, and the number of files and the bytes tagged will be updated. DATE (Pop Up) You can tag (or clear) files by File Date using this option. After selecting this option, you are required to enter the date to compare the files in the filelist against. You can press the ARROW keys to toggle the operator that will be used for the comparisons. You can select less than, less than or equal to, not equal to, equal to, greater than or equal to, or greater than. After you have selected the operator, and have entered the date to compare against, press the ENTER key. The files specified will be tagged, and the number of files and the bytes tagged will be updated. ONLY TODAYS FILES Use this option to tag (or clear) all files that have the current days date. This is useful for tagging all of the files that have been changed today. ARCHIVE (CHANGED FILES) When an application creates or modifies a file, DOS remembers this and sets an attribute on the file called the ARCHIVE bit. StupenDOS displays the attributes of a file in the filelist. An 'A' after the files' time in the filelist indicates that files' archive attribute is set. If you save a file with a word processor, the files' archive bit will be set. Most backup programs clear the archive bit after backing up a file. This option will only tag files (or clear) by looking at the archive bit. The archive bit is not modified by StupenDOS. Page 16 FLIP TAGS Use this option to reverse all of the tag characters. All files that are tagged will be cleared, all files that have no tag will become tagged. This is useful when you want to tag many files, and leave only a few untagged. Suppose you wanted to tag all the files except the .EXE files. You could tag all of the .EXE files, and then flip the tags. REMOVE FROM DISPLAY Some directories contain hundreds or even thousands of files. If you are looking for certain files, and you want to reduce the number of files in the filelist, you will want to use this option. Suppose you have several hundred files with the .TXT extension, and you do not want to work with these files at this time. You can tag all the *.TXT files with the TAG / NAME option, and then remove these files from the filelist. The files have not deleted, they just are not shown on the screen. LOAD TAG FILE You may find yourself tagging the same files over and over again, day after day. If this is the case, you can make a TAG file with an ordinary text editor. Suppose you want to tag all *.DOC files and all *.TXT files. Create a file with a .TAG extension, and enter the following: *.DOC *.TXT If you called the file MINE.TAG, you can load this from StupenDOS with the Load Tag File option. The .TAG files should be located in the directory where SD.EXE is located. All files with .DOC and .TXT extensions will be tagged. When selecting this option, a Pop Up window will appear. You can use the ARROW keys to select the TAG file you wish to load, and press the ENTER key. Page 17 MORE The MORE Pull Down Menu contains miscellaneous options that don't fit in any other menu. Press ALT M to bring up the MORE Pull Down menu. FIND A FILE (Full Screen Pop-Up) If you have forgotten where you put a file, the File Finder will find it! Most Where Is programs can find files, but after a few files are displayed, they scroll off the screen. StupenDOS remembers all of the files it has displayed, and lets you use the ARROW keys to review all of the files found. This option is a full screen mode and is described later in the manual. Dos Call This option allows you to run an external program from within StupenDOS. There are several other ways to run external programs. See the EXECUTE option described in the FILE Pull Down menu section for more information. You can have StupenDOS write itself to expanded or extended memory, or to disk, before running an external program. This is only possible if you are running a .EXE or .COM file. It is not possible if you are running a .BAT file, or an internal DOS command, like TYPE. Press ESC to cancel the DOS Call command. OS Shell If you need to return to DOS from StupenDOS, but do not want to exit StupenDOS, the OS Shell option will allow you to do this. You will be returned to the DOS prompt. Do whatever you need to do, and type in EXIT and press the ENTER key when you are ready to return to StupenDOS. Stamp Time It is sometimes desirable to alter the Time and Date stamp of a file or a group of files. After selecting this option, you can either select to use the current time and date, or you can enter a date and time of your choice. If you want to use the current time and date, just press the ENTER key to stamp the files. If you want to select the date and/or time, ARROW down and select the Defined Time/Date option. Then ARROW down to the area where you can type in the date and time. Press ENTER to tell StupenDOS that you want to alter this information. A flashing cursor will appear. After entering this information, press the F1 key to stamp the files. The stamped files time and date will be reflected in the file display. Press ESC if you choose not to stamp the time. Page 18 Byte info A ten byte file may be very small, but it takes up much more disk space than ten bytes. This is due to the way DOS formats your disk. The minimum amount of space a file uses on a disk is the same as the disks cluster size. The Byte info option tells you how many bytes are in tagged files, and how much disk space these files really take. The number of clusters, cluster size, and other useful information is also displayed. Press any key to remove this window when you are finished. Info, disk You can quickly see how big each disk drive on your system is, how much space is used, and how much space is available. The volume label is also displayed. Network, Joined and Substituted drives are also supported. Wipe dir(ectory) WARNING: This is an option that should be used with extreme caution. Wipe directory deletes all files and all subdirectories in a given directory. The root directory cannot be wiped with this option, however it can be wiped from the tree display. See the Tree options Pull Down menu section later in this manual for more information. Suppose you have decided you do not need the \GAMES directory any longer. In the GAMES directory, there are several subdirectories, say MONOPOLY and TETRIS. To wipe the \GAMES directory and all of its subdirectories, highlight the GAMES directory, and select the Wipe Dir option. A warning Pop Up will appear asking if you really want to wipe the selected directory. You must press the CTRL F1 key to confirm that you want to start wiping. As the wipe process is being completed, the number of files deleted and the number of bytes removed are displayed. You will be informed when the process is complete. Press ESC during a wipe to abort wiping, however a files that have already been deleted will be gone. Disk format You can format 5 1/4" disks or 3 1/2" disks, low or high density. If you try to format a disk for an illegal density, a error will be displayed. For example, you cannot format a 5 1/4" disk to 720K. A Quick format option allows previously formatted disks to be reformatted quickly. New boot sectors, FAT information, and ROOT directory information are written. You can also verify the disk after it is formatted or quick formatted. After a disk format is complete, you can format another disk, or press ESC. The format option supports data diskettes only, the disks cannot be used to boot (startup) the computer. Page 19 Tree Display (Full Screen Pop-Up) This option lets you view the structure of all your disks in a graphic display. It is a full screen mode, and is described in detail later in this manual. Help Shortcut Key: F10 One page of help information displaying the basic usage and functions of StupenDOS. About SD.EXE A message about the author, and the development environment used to create StupenDOS. Reset Mouse After running some external programs, the mouse characteristics may have changed. Some programs change the mouse cursor, or the distance the mouse cursor travels when the mouse is moved. The Reset Mouse option sets these characteristics back to normal. Page 20 FILE Select the FILE Pull Down menu by pressing ALT F. All of the items in this menu are options that relate to the files that are in the filelist. Attribute Change (Pop Up) Shortcut Key: ALT A An attribute is saved by DOS for every file and directory on a floppy or hard disk. This option allows you to change the attributes of all tagged files. If you don't know what DOS uses attributes for, you will not need to use this option. You can set the Archive bit, Hidden bit, System bit, and Read Only bit. You can set the files attributes, or add the selected attributes. After bringing up the Change Attributes Pop Up window, use the ARROW keys to highlight the different attributes you wish to select, then press the SPACE bar. After you have selected the attributes you wish the files to have, ARROW down and select either Set Attributes or Add Attributes. Press F1 to make the change. The attributes will be updated in the filelist. Filespec Change (Sub Menu) It is sometimes desirable to have just certain files listed in the filelist. You may be in a directory where many files exist, but you just want to view the .TXT and .DOC files. You can tell StupenDOS that you just want to view the .TXT and .DOC files with the Filespec Change menu. After selecting this option, a menu will appear. Type in the filespec you wish to view. You can enter up to five filespecs. You can specify if this filespec is to be included or excluded. To toggle the INCLUDE/EXCLUDE toggle, press the SPACE bar. If you wanted to view all .TXT files except B*.TXT, you would enter *.TXT as a filespec to include, and B*.TXT as a filespec to exclude. Locate On (Pop Up) Shortcut Key: / If many files exist in the filelist, and the files are not displayed alphabetically, it may be difficult to find a file in the filelist. The Locate On option locates the highlight bar on the specified file. Suppose you wanted to find SD.EXE so you could copy it to a floppy drive. Select this option from the FILE Pull Down menu or press / (slash) from the main screen. A Pop Up window will appear. Enter the name of the file. As you type each letter, the highlight bar will be moved to the first file matching the text you typed. The wildcards * and ? are legal. Page 21 Execute File Shortcut Key: X If you want to run a program from inside StupenDOS, use the ARROW keys to highlight the file. Then select the Execute File option from the FILE Pull Down menu. Press the ENTER key to execute the file. You can Execute any type of file. Only .EXE and .COM and .BAT files are actually run, but you can configure the SD.PRO file to execute any type of file. For example, if you try to execute a picture file, StupenDOS can automatically run your picture viewer. The SD.PRO file must be configured for this to work properly. See the section on programmable options for more information. MOUSE: Double click the file you wish to execute. New Directory Shortcut Key: N This option rereads the current filelist. It is sometimes necessary to update the files in the list. For example, if you wanted to view the contents of several floppy disks, you could insert a new floppy disk and press 'N' to show the files on the floppy. Using this option will clear all of the file tags. Create File List (Pop Up) List Files are used by many popular programs, like PKZIP and PKUNZIP. You can easily create a List File that is compatible with these programs. To make a List File from all of the tagged files, select this option from the FILE Pull Down menu. You can save just the filenames, or you can also save the path information. You must enter the filename to use for the List File. If the List File already exists, you will be asked if you wish to add to that List File, or make a new List File. Print (Sub Menu) Shortcut Key: P This option prints the tagged files to the printer. The printer port can be set in the SETUP Pull Down menu. Form Feed NOW If you want your printer to do a Form Feed, use this option. It will send a Form Feed character to the printer. Page 22 Directory List Use this option if you need a listing of files printed on the printer. You can specify if you want all files printed, or just the tagged files. You can also specify what information about the file is to be printed. The file Size, Date, Time, Attributes, and path name can be printed. Only files will be printed by default. If you want to print the information about sub-directories, select the Directories option. Press F1 to start printing after you have set the desired options. Window - OPEN or CLOSE Shortcut Key: ALT W StupenDOS supports two file windows, in a vertical format (See figure). If one window is currently open (there is always at least one window open), selecting this option will open a second window. If two windows are open, this option will close the current window. If the highlighted entry in the filelist is a directory, the second window will contain that subdirectories information. For example, if you have one file window open, and you highlight a directory using the ARROW keys, and then press ALT W, the second window will be opened displaying the files from the highlighted directory. When performing operations from StupenDOS, the operations are only executed in the current window. For example, if you have two windows open, and all files are tagged in both windows, and you delete all tagged files, only the files in the current window will be deleted. Expand/Reduce Window Size Shortcut Key: +/- Used to alter the size of the current window. Pressing + or - will move the bar separating the two windows. MOUSE: Press and hold down the left mouse button while located on the character at the far right side of the bar separating the two file windows. Move the mouse up or down until the bar is in the desired location. Release the mouse button. Switch Windows Shortcut Key: TAB Used to change to the other window. The highlighted bar will appear in the other window. The highlighted bar indicates which file window is currently active. MOUSE: Click on a file in the window you wish to change to. Unzip a ZIP file Shortcut Key: U This is a full screen mode function described on page 35. ZIP tagged files Shortcut Key: Z This is a full screen mode function described on page 32. PKZMENU You can run PKWARE's popular PKZMENU program with this option. Page 23 SETUP You can configure StupenDOS just the way you like it. The settings can be saved to disk, so that every time StupenDOS is run, it is setup properly for your needs. Bring up the SETUP Pull Down menu by pressing ALT P. File Options Selecting this option displays a sub menu containing several options. Hidden System Read Only You can tell StupenDOS that you want to display Hidden files, System files, and Read Only files in the filelist. These files will not be displayed by default. Filespec You can specify the files StupenDOS displays in the filelist. You can specify up to five different filespecs (file names, wildcards are legal). See the FILE, Filespec change pull-down menu option for more information. Initial Sort Specify the way you would like the files displayed when StupenDOS is first run. Nine different methods are available. See the SORT Pull Down menu for a description of the different sorting methods. Windows Normally StupenDOS has one file window when first run. You can force a second window to be opened with this option. Video & Sound options Snow problems Some monitors display screen snow when running StupenDOS. If you have this problem, turn this option on. Time on Screen You can turn off the time display in the upper right hand corner of the screen with this option. Beeps Turn off the sounds StupenDOS makes with this option. Exploding Screen When StupenDOS is first run, the text that was previously on the screen is removed in a ■exploding■ fashion. Turn this option off if you don't want the screen to clear this way. The loading time will be faster with this option turned OFF. Page 24 Monitor Choose between Black & White or Color. You can also choose 25 line or 43/50 line display. You must have a EGA or VGA monitor to display more than 25 lines. A EGA video card displays either 25 or 43 lines. A VGA card will display either 25 or 50 lines. Change Colors You can change nearly all of the colors in StupenDOS. Use the ARROW keys to highlight the desired screen option, and press the SPACE bar. The colors will be changed immediately. There are over ten different items you can change. As you press the DOWNARROW key, the list will scroll. You can press the F10 key to reset all of the colors to their defaults. After you have finished, press F2 to save the colors to disk. External Programs List Files Edit Files The List Files and Edit files options are very powerful. You can select several options about the programs that StupenDOS uses when you wish to LIST (view) or EDIT a file. A Pop Up window will appear. You must type in the name of the program you wish to use to LIST or EDIT. You can also select other options. These options are described in detail in the Programmable section near the end of this manual. If you use the LIST File command from the PKZIP or PKUNZIP screens, it uses the options you specified in the LIST option. Pkunzip Directory If PKZIP and PKUNZIP are not in a directory that is in your DOS PATH statement, you must tell StupenDOS where these files are located. If PKZIP/PKUNZIP are in the D:\UTIL directory, you would type in D:\UTIL for this option. Zip Extract Directory If you extract ZIP files to the same directory often, you can enter that directory here, and it will be used as the default extract directory each time StupenDOS is run. The extract directory tells PKUNZIP where to place the files being extracted from a .ZIP file. Temp Drive StupenDOS sometimes needs to write to the disk. If you are running on a write protected floppy disk, or on a disk with little free space, you need to tell StupenDOS where it can write temporary information to. When SD runs external programs, it writes itself to expanded or extended memory if it is available. If expanded or extended memory is not available, it writes itself to disk, so it must have a temporary space on disk to write to. For example, enter C: to use the C: drive as the temporary drive. This drive is also used when LISTing a file that is inside a .ZIP file. Page 25 Reread After Unzip If you do a PKZIP with the -Move option, the filelist may not be accurate. You can have StupenDOS automatically reread the files in a directory with this option. You can specify three options: YES, NO, ASK. ASK will pop up a window after a ZIP or UNZIP operation, and ask you if you would like to reread the files at that time. Copy Options Overwrite By default, the COPY option will automatically overwrite files of the same name. This can be changed with this option. This can be also be overridden in the COPY Pop Up window. Error Checking If selected, StupenDOS will see if sufficient disk space exists on the destination drive before starting a copy operation. This can also be overridden in the COPY window. Clear Tags After a file is Copied or Moved, the file tag will be cleared. This can be overridden in the COPY window. Mouse Setup Selecting this option displays a Pop Up window. Tracking Speed Adjustment You can set the tracking speed of the mouse by clicking on the tracking speed line. The tracking speed is the distance the mouse cursor will travel with a given movement of the mouse. A Fast tracking speed will move the mouse cursor all the way across the screen with a small movement of the mouse. A Slow tracking speed will require considerably more mouse movement to get the mouse cursor across the screen. Double Click Speed Adjustment You can set the Double Click speed of the mouse by clicking on the Double Click speed line. The Double Click speed is the amount of time between clicks of the mouse. A Fast Double Click speed will require rapid clicks of the mouse to be accepted as a Double Click. A Slow Double Click speed will require less rapid clicking to be accepted as a Double Click. Mouse Character Clicking on this area of the screen will display a Pop Up window that contains all of the characters available for the mouse cursor. Click on the desired character. Mouse Color Clicking on this area of the screen will display a Pop Up window that contains all of the colors available for the mouse cursor. Select Foreground or Background color, and click on the desired color. Page 26 Auto Locate Mouse You can have StupenDOS try to guess where to locate the mouse with this option turned on. Whenever a Pull Down Menu is selected, the mouse will be located on the line you were on when you were previously in this window. Printer Options (Sub-Menu) Form Feed Between Files If you are printing several files, this option will send a Form Feed to the printer after each file is printed, so the next file will start on a new page. PRN, LPT1, LPT2, LPT3, COM1, COM2 Set the printer port to whatever your system requires. If you are not sure, you will most likely want to leave this set to PRN. No Mode ASCII Mode Binary Mode If you are printing a Binary file, you will want to set this option. If you are printing regular ASCII text, either None or ASCII should be set. Most users will never need to set this option. Other Options Directory Return StupenDOS will automatically exit to the Drive and Directory you were in when you started StupenDOS. You can override this with this option. If Directory Return is turned off, StupenDOS will exit in the current directory. This can be overridden by using ALT X or CTRL X when exiting StupenDOS. ALT X, ENTER always exits to the original directory, CTRL X always exits to the current directory. Use Tree File After the TREE command is used to display the layout of the disk, this information is written to the disk. When running StupenDOS in the future, if you again choose the TREE display option, the information saved previously will be used by default. The SD.TRE file is read from the disk, rather than scanning the entire disk again. The advantage to reading the Tree file is speed. Reading the old information from a file is many times faster than re- scanning the disk. The disadvantage is that the information may not be correct. If you added directories or removed directories since you last used the Tree display, the SD.TRE file will no longer be accurate. If the Use Tree File option is turned off, StupenDOS will always scan the disk when you ask for the Tree Display. You can always reread the tree information even if you loaded the SD.TRE file. See the TREE Display section discussed previously in this manual for more information. Page 27 EMS Memory There are two versions of StupenDOS. One version uses overlays, one version does not. Overlays allow StupenDOS to use less memory while running, but slows the execution of the program because different parts of the program must be loaded often. If you have a fast computer, or are using a disk cache, the overlay version of StupenDOS will run at about the same speed as the non- overlay version. If you have a slow 80286 computer, or a 8088 based computer, you will want to use the non-overlay version. If you are using the overlay version of StupenDOS, you can save the discarded overlays to EMS memory, so that they can be quickly retrieved if necessary. If other applications need all of your EMS memory, turn this option off. About 128K of EMS memory is needed for this option. Screen Blanker If StupenDOS has been running for several minutes with no activity, it will blank the screen. A message will appear instructing you to press a key when you want to resume working. You may wish to turn this option off if you have some other screen blanker installed. ESC Key You can have the ESC key do several things from the main screen. It can either be used to Exit To DOS, enter the TREE Display, or do nothing. Press the SPACE bar to change this option. ENTER Key The ENTER key can be used to TAG Files, or execute files. Press the SPACE bar to change this option. User Level (Menu) The user level has three settings. Novice users are locked out of certain dangerous features on the main screen, such as Wipe Directory. Choose the appropriate level for your skill level. Write Setup to ... StupenDOS can write the setup information to several different places. By default, the information is appended to the SD.EXE file. When StupenDOS is run, it looks for setup information in several places: 1) The current directory (File SD.SET) 2) In the directory specified by the SDCONFIG environment variable. 3) In the directory where SD.EXE is located (File SD.SET) 4) In the SD.EXE file SD.EXE file (best) The setup information will be appended to the SD.EXE file. If you have a DOS version 3.0, this option may not work for you (see options below). Page 28 SD.SET in EXE directory The setup information will be written to a file called SD.SET in the directory where SD.EXE is located. You can then copy this file to other directories and modify it, creating multiple configurations. SDCONFIG directory If you run StupenDOS from a RAM disk, you will need to write the setup information to a file that is not on the RAM disk, so the information is not lost when the computer is shut off. If you have a DOS version less than 3.0, you will also need to use this configuration. Suppose you want to write the setup information to the C:\UTIL directory. You must add the statement SET SDCONFIG=C:\UTIL to your autoexec.bat file. EXIT Original Directory Exit to the drive and directory from which you started StupenDOS, even if you changed drive or directory while running StupenDOS. Current Directory Shortcut Key: CTRL X Exit to the current drive and directory. Page 29 MODES File Finder (Full Screen Mode) Shortcut Key: ^ The File Finder can help you locate lost files. Up to five different filespecs can be searched for at one time. You can also search multiple drives. Unlike most file finding programs, the StupenDOS file finder retains the list of files it has found, so that the list of files can be reviewed. Pressing ESC during a search aborts the search process. Press ESC to return to the StupenDOS main screen after you are done with the File Finder. The File Finder takes over the entire StupenDOS screen, and has its own set of Pull Down menus. Go The GO Pull Down menu starts the search process with the parameters selected in the other Pull Down menus. Sort After the search process is complete, you can display the files many different ways. See the SORT Pull Down menu section described earlier in this manual for more information. Filespecs You can search for up to five different filespecs at a time. To enter a filespec, press the ENTER key. A flashing cursor will appear. Enter the filespec you wish to search for. Press the ENTER key again to finish entering the filespec. You can use the ARROW keys to move to other lines in this menu and enter additional filespecs. Drives StupenDOS automatically assumes you will want to search on the current drive (the default drive). You can change this, or select additional drives using the Drives Pull Down menu. Use the ARROW keys to highlight the drive you wish to select, and press the SPACE bar. Misc Pause after each page If you are searching for a filespec that will have many matches, you may wish to pause the display after each page of files. Page 30 TREE (Full Screen Mode) Shortcut Key: T The TREE mode allows you to display a graphical listing of systems disks. Unlike other Dos Shells, the StupenDOS TREE display can display up to 26 (A: to Z:) drives simultaneously. The tree information is saved to the disk in a file called SD.TRE. This information is read when you enter the TREE mode. Reading this information from a file is much faster than scanning the disk each time you enter the TREE display. The drawback is that the information may not be up to date. This can be configured in the setup pull-down menu. The information can easily be reread (described below). Information displayed in the TREE display includes: Bytes Free Bytes Total Percent of the disk used Number of Files in the highlighted directory Percentage of the disk the highlighted directory occupies Volume label Truename (The TRUENAME pertains mostly to users running on a network) If the TREE display has listing for more than one disk, the information displayed relates to the drive that is currently highlighted. If the drive you wish to view is not currently in the TREE display, just press the drive letter you wish to display. If you need to see the display of the D: drive, simply press the 'D' key. You can delete the SD.TRE file if you do not want to read in old directory information (this can also be selected in the setup). When you are finished with the TREE display, press ESC to return to the StupenDOS main screen. TREE Options Pull Down Menu Change directory If you would like to change to the highlighted directory, press the ENTER key. MOUSE: Double click on the desired directory. Reread current drive If the tree display is not up to date (the SD.TRE file may be old), you can use this option to rescan the disk and update the SD.TRE file. This option also refreshes the items displayed about the TREE. If the File(s) in the directory currently shows ?????, rescanning the disk will refresh this information. Reread selected drives It is sometimes necessary to reread more than one drive at a time. This option allows several drives to be selected, and then reread. Page 31 Wipe directory WARNING: This is an option that should be used with extreme care. Caution should be used when using this option. Wiping a directory deletes all the files in the highlighted directory, as well as all the files in its subdirectories. See the WIPE Directory option in the MORE Pull Down menu for more information. After highlighting the directory you wish to WIPE, select this option. A window will pop up asking for confirmation to continue. Pressing CTRL F1 will then start the wiping process. After the wipe is complete, the TREE display will be updated, as well as the SD.TRE file. Print tree structure You can get a printed copy of your tree structure with this option. Prune and graft It is sometimes necessary to move an entire directory structure to another hard disk, or to a different subdirectory. The Prune and graft option allows you to do this easily. Unlike other DOS Shells, the destination disk can be a different drive than the source drive. StupenDOS checks for sufficient disk space before starting the Pruning. You can either make an additional copy of the structure you are pruning (COPY), or relocate the structure (MOVE). After selecting this option, StupenDOS will ask you to select the SOURCE directory (the directory where the pruning will start). Use the ARROW keys to locate the desired directory and press the ENTER key. Then select the destination directory the same way. At this point, StupenDOS will check to see if enough disk space is available on the destination drive. A If there is enough disk space, you are allowed to continue. At this point, you can choose to COPY or MOVE the tree structure, using the F1 or F2 function keys. Press the ENTER key to start the Prune and Graft operation. After the prune is complete, the tree display and the SD.TRE file will be updated. Page 32 ZIP (Full Screen Mode) Shortcut Key: Z You can easily add files to a ZIP file, or create a new ZIP file with this option. If you want to work with a ZIP file that is in the filelist, highlight the file and invoke this option. A listing of the files inside the ZIP file will be displayed. You can tag files using the ARROW keys and the SPACE bar. If you want to make a ZIP file, or add files to a ZIP file, tag the files you wish to add before invoking the ZIP option. You may wish to consult your PKZIP manual for more information on the following options. If you need to create a new ZIP file, you can enter a new ZIP file name after you select START from the GO Pull Down menu. GO This option invokes PKZIP with the options specified in the other Pull Down menus. SORT The files inside the ZIP files can be displayed several ways. See the SORT Pull Down menu section described earlier in this manual. ZIP In this menu you select the main options to pass to PKZIP. Add Add the files that were tagged in the filelist to the ZIP file. Freshen Freshen the files in the ZIP (rezip files with newer time/date). Update Update the files in the ZIP (rezip files with newer time/date or new files). Delete Delete the files tagged in the ZIP file. View Use PKZIP to view the files inside of the ZIP file. View options Select the display method PKZIP will use to view the files inside the ZIP. Move Erase the files after they are moved into the ZIP file. List File StupenDOS will extract the highlighted file to disk, and run your favorite file viewer to display the file. Page 33 Save Options You can save your configuration to disk, so you do not need to reconfigure StupenDOS each time it is run. The default filename is SD.PKZ. The file is stored in the directory where SD.EXE is located. The file SD.PKZ is loaded by default when you enter the ZIP mode. Restore Options Load a .PKZ setup file. You can save several setup files, each containing a different setup. Compression Fast Compression PKZIP can invoke a super fast compression algorithm. This is useful for very large files, or for slow computers. Extra Compression PKZIP can invoke a super compression algorithm. This is used when maximum compression is desired. Path Recurse PKZIP can compress files in the current directory, as well as its subdirectories. Select this option if you want to include subdirectories in the ZIP file. This option should be used with one of the 'path' options described below. Pathnames Store the directory name for directories recursed. See your PKZIP manual for more information. Absolute Paths Store the directory name for directories recursed and directories specified. See your PKZIP manual for more information. Comments Zipfile Comment This option allows you to add a comment to a ZIP file. File Comments PKZIP will pause and ask you to enter a comment for each file if this option is selected. New File Comments PKZIP will pause and ask you to enter a comment for each new file that is being added to a ZIP if this option is selected. MISC Password If you select this option, StupenDOS will prompt you to enter a password that PKZIP will use to encrypt the files that will be compressed. Do NOT forget the password or you will never be able to UNZIP the files! Page 34 Other Options Selecting this option will prompt you to enter a text string that will be passed to PKZIP. Temp Drive PKZIP sometimes needs to write temporary files. If this option is selected, PKZIP will use the drive specified. ANSI Comments If selected, PKZIP will display ANSI comments. Keep zipfile date If selected, the time and date of a ZIP file will not change, even if the file has been updated. Latest file date If selected, the time and date of a ZIP file will be set the time and date of the newest file in the ZIP. Page 35 UNZIP (Full Screen Mode) Shortcut Key: U The UNZIP mode is a full screen mode function with it's own set of Pull Down menus. Highlight the ZIP file you wish to work with before invoking this option. GO This option invokes PKUNZIP with the options specified in the other Pull Down menus. SORT The files inside the ZIP files can be displayed several ways. See the SORT Pull Down menu section described earlier in this manual. UNZIP Extract If selected, this option tells PKUNZIP to extract the tagged files to disk. Console If selected, this option tells PKUNZIP to extract the tagged files to the screen. Printer If selected, this option tells PKUNZIP to extract the tagged files to the printer. Newer If selected, this option tells PKUNZIP to extract the tagged files only if the files in the ZIP are newer than the files on the disk. Newer & Exists If selected, this option tells PKUNZIP to extract the tagged files only if the files in the ZIP are newer than the files on the disk, and they already exist. View This option tells PKUNZIP to display the files that are inside of a ZIP file. Test If selected, PKUNZIP will test the files in the ZIP file and will check for errors. List File StupenDOS will extract the highlighted file to disk, and run your favorite file viewer to display the file. Overwrite This option tells PKUNZIP to overwrite files with files in the ZIP file of the same name. Create directories This option tells PKUNZIP to create directories stored in the ZIP file. Page 36 MISC Password If you select this option, StupenDOS will prompt you to enter a password that PKUNZIP will use to decrypt the files in a ZIP. Other Options Selecting this option will prompt you to enter a text string that will be passed to PKUNZIP. Extract Directory When selected, PKUNZIP will extract the files in the ZIP file to the directory specified. ANSI Comments If selected, PKZIP will display ANSI comments. Volume Label If selected, PKUNZIP will restore the volume label, if one was stored in the ZIP file. Check Free Space StupenDOS can check the available disk space before running PKUNZIP. A warning message will appear if there is not enough disk space available. Page 37 Configurable Options There are several ways to customize StupenDOS. The file SD.PRO, is read when StupenDOS is run. A Sample file is provided to serve as an example. There are three different ways to program StupenDOS: You can reconfigure the keyboard so your favorite options or programs can be run with a single key stroke. You can tell StupenDOS how to act on a file that is 'executed', or double clicked on with the mouse. You can configure an area of the screen to list your favorite programs or StupenDOS option(s). These options can be run by pressing F9, and then selecting the desired option, or double clicking the mouse on the desired item. SD.PRO is a ASCII text file. You can use any standard ASCII text editor to modify or create this file. If you have DOS 5, you can use the EDIT program included with DOS 5. Each entry in the SD.PRO file has four sections. These sections vary depending on the type of entry in the file (KEY, RUN, USR). StupenDOS gives you a lot of power when using the programmable options. The following list describes what you can tell StupenDOS to do before and after running an external program. C = Continue from previous option. If you have a command that does a CHKDSK C:, and also want to do a CHKDSK D:, you could have the following in SD.PRO; USR:CHKDSK;W;CHKDSK C:USR:CHKDSK;CW;CHKDSK D: D = Change Directory Force StupenDOS to change directory after running this command. If your application changed the default drive or directory, you may want StupenDOS to change you back to the drive and directory where you were originally. L = Looping Control. Suppose you want to run a certain program on each tagged file. For example, if you wanted to run PKLITE on each tagged file, you would tell StupenDOS that you want to 'loop' through the filelist and run PKLITE on each tagged file, rather than on just the highlighted file. M = Do not reset the mouse after running. Page 38 Some programs do not use the mouse, or do not change the mouse's speed settings. When your application is done being run, StupenDOS will normally reset the mouse. This takes about 1 second or more, even on a fast computer. If you do not want to reset the mouse after running a program, use the 'M' option. P = Prompt for more parameters before Running. Some programs need to have information passed to them before they are run. If you have the 'P' parameter set, StupenDOS will prompt you for parameters to pass to the application. R = Reread files after running application. If your application creates or deletes files in the current directory, the filelist will become inaccurate. This option allows you to reread the files in the filelist. Then all deleted files will not appear, and any new files will appear. U = Update the highlighted files Time/Date after Running. If the program you are going to run affect the Time/Date of the highlighted file, StupenDOS will update this information in the filelist if this option is specified. W = Wait after running the program for a key to be pressed. If you are running a program like CHKDSK, you will want to pause after running the program, or you won't have time to see what CHKDSK displayed. If the 'W' option is used, StupenDOS will pause and ask you to press a key after the application has been run. X = Do not save StupenDOS to EMS before running. Some programs need very little memory to run, so StupenDOS does not need to be saved to EMS memory before running the application. This saves time, because StupenDOS does not have to be written to memory, and restored after the application has been run. Y = Use the SYSTEM command to run the program. StupenDOS normally uses the SPAWN command to run external programs. This works for programs with .COM or .EXE extensions only. If you are running a .BAT file, or an internal DOS program, like DIR, you will need to use the 'Y' option. The 'Y' option forces StupenDOS to use the SYSTEM command, which can run .BAT files and DOS commands. The drawback is that you cannot save StupenDOS to EMS memory before running the application. The applications you are running from StupenDOS may need to have information passed to them. The following parameters can be set to automatically pass certain items to your application. Page 39 %c Pass the current drive letter and a colon. (Like C:) %C Pass the drive letter and colon from the other window. %d Pass the directory name to the application. %D Pass the other windows directory name to the application. %f Pass the highlighted filename to the application. %F Pass the highlighted filename from the other window. %l Create a listfile from the tagged files, and pass it. %L Same as above, except using the other window. These options can be used with KEY, RUN and USR options. Programming KEY Commands You may have a program that you run often, and you want to be able to run it with one key stroke. Or you may have a StupenDOS option that you use often, and you want to make a shortcut key for that option. The KEY options in the SD.PRO file allow you to do this. Each KEY entry in the SD.PRO file has four sections. All four sections must be on the same line. Suppose you want to invoke the StupenDOS File Finder by pressing SHIFT F1. You will need to know what value StupenDOS uses for the key SHIFT F1. All of the available key stroke values are listed at the end of this manual. Look up SHIFT F1. The value is 340. The SD.PRO file is used for three different programmable functions, so the first thing we need to enter in the SD.PRO file is the type of command we are running, either a KEY option, a RUN option, or a USR option. To tell the SD.PRO file that an option is a keyboard configuration, enter KEY:. Then next item is the key stroke that you want to define. So enter the value of SHIFT F1, which is 340. After the value, we need a semicolon to separate this value from the next value. Since we are defining an internal StupenDOS option, you must enter the value of the option next. These values are listed at the end of this manual. The value for the File Finder is 11055. Type in 11055, and then a semicolon. If the command you are configuring is an internal StupenDOS command, you are done! The entire line looks like: KEY:340;11055; What this says is: If key 340 (SHIFT F1) is pressed, do option 11055 (File Finder). Page 40 You can also configure StupenDOS to run your favorite programs with a single key stroke. Suppose you want to run the DOS command CHKDSK by pressing SHIFT F2. We start by typing in KEY:. Then we need the value for SHIFT F2, which we get by looking at the table at the end of this manual. The value is 341. Type in 341, and then a semicolon. Since CHKDSK is not a internal StupenDOS command, you must enter options for running CHKDSK at this time. The available options are described on the previous 2 pages. For CHKDSK, we just want to pause after running CHKDSK, so we can see what the results were. So we need to use the 'W' command, which waits for a key to be pressed before returning to StupenDOS. So a 'W' is needed, and a semicolon. The last parameter is the application to be run. So enter CHKDSK. The entire line should look like: KEY: 341;W;CHKDSK It reads, If key 341 (SHIFT F2) is pressed, run CHKDSK, and wait for a key to be pressed after it is run. KEY Examples: KEY: 317;wmx;MEM Run the DOS 5 command MEM when F3 (317) is pressed. Wait for a key stroke after it is run. Do not write StupenDOS to EMS memory before running, and do not restore the mouse. KEY: 350;pu;PKUNZIP %f Pressing the CTRL F1 (350) key will run PKUNZIP. You will be prompted for additional parameters to pass to PKUNZIP. The highlighted files Time/Date will be updated in the filelist. To use this command, highlight a .ZIP file, and press CTRL F1. PKUNZIP will be executed on the highlighted .ZIP file. KEY:360;l;PKLITE %f Pressing ALT F1 (360) will execute PKLITE. The 'L' parameter tells StupenDOS to run PKLITE on each highlighted file. You can tag several .EXE and .COM files, and then press ALT F1, and StupenDOS will automatically run PKLITE on each file. KEY:340;11306; This is another example of how to configure an internal StupenDOS command. Pressing SHIFT F1 will run option 11306, which is SORT by SIZE. Page 41 KEY:368;w;CHKDSK C: KEY:369;wc;CHKDSK D: If ALT F10 (369) is pressed, just CHKDSK D: is run. If ALT F9 (368) is pressed, CHKDSK C: is run, and you will be prompted to press a key, and then CHKDSK D: will be run because the 'C' option was specified. You will be prompted to press a key after CHKDSK D: is run also. KEY:76;89; If you would rather press the 'L' key (76) to list files from StupenDOS, you can configure 'L' to do what 'Y' (89) currently does. Executing KEY Commands Press the key that has been configured to execute that command. These commands are loaded when StupenDOS is first run, so if changes are made to the file while running StupenDOS, you must restart the program. Programming RUN Commands DOS can only run .EXE, .COM and .BAT files. StupenDOS extends this so that any type of file can be 'run'. The file itself is not run, but rather another program is run on the highlighted file. For example, if you try to execute a .DOC file, you can tell StupenDOS that you want to run your favorite file viewer on any .DOC file that is executed. You can configure .GIF files to be sent to a picture viewer, etc. The format for the 'RUN' option is listed below. You must edit the file SD.PRO with a standard ASCII text editor to modify the RUN options. If you modify SD.PRO while running StupenDOS, you must restart StupenDOS for the changes to take effect. The format for RUN options is similar to the KEY options described previously, except the first parameter after 'RUN:', is the filespec of the files to be 'run'. Page 42 RUN Examples: RUN: *.GIF;;PICEM %f If a file with a .GIF extension is 'executed', run PICEM and pass the highlighted filename. RUN:*.EXE;pw;%f If a .EXE file is executed, StupenDOS will prompt you for additional parameters before running. After the program has been run, StupenDOS will require you to press a key before continuing. RUN:*.DOC;u;EDIT %f If a file with a .DOC extension is 'executed', StupenDOS will run the text editor EDIT, and will pass EDIT the highlighted filename. When EDIT is done, the highlighted filename in the filelist will have its Time/Date updated. RUN:*.WKS;;123 %f If a file with a WKS extension is 'executed', run a program called 123 and pass the highlighted filename. RUN:*.*;;LIST %f /m If the filespec does not match any of the RUN commands filespecs found above it (in this case *.GIF, *.EXE, *.DOC, *.WKS), it will execute LIST. The highlighted filename will be passed, and the /M is a LIST option to tell LIST you wish to use the mouse. It is a good idea to have the last RUN command have the filespec *.*. This will catch any file that did not match any of the previous filespecs. Executing RUN Commands Highlight the file in the filelist that you wish to 'run'. Press X to execute, or select Execute from the FILE Pull Down menu. These commands are loaded when StupenDOS is executed, so if changes are made to the file while running StupenDOS, you must restart the program. MOUSE: Double Click on the file you wish to 'run'. Page 43 Programming USR Commands The Mouse Menu is located to the right of the Filelist Window. In StupenDOS 2.0, these items were fixed, and were not configurable. Now, you have complete control of these items. You can modify the file SD.PRO with a standard ASCII text editor. The USR options can be internal commands, like Open Window, or external programs like WP, or 1-2-3. The first USR parameter is the text you want to display in the menu to the right of the filelist. The last two parameters are the same as the KEY and RUN parameters. USR Examples USR: OPEN;273; Selecting this command will open a second file window. If a second window is already open, the current window will be closed. USR: PKLITE;u;PKLITE %f Run PKLITE on the highlighted file. Update the files TIME/DATE after running PKLITE. USR: COPY A:;11150; The text COPY A: will appear on the screen, and if selected, the tagged files will be copied to A: (11150). Don't forget that the codes for the StupenDOS options are listed at the end of this manual. USR: DEL NOW;4006; Delete the tagged files without confirmation. USR: QPRO;;C:\QPRO\Q.exe Run the program Q.exe in the C:\QPRO directory. Executing USR Commands Press F9 to enter the USR mode. A highlighted cursor bar will appear to the right of the filelist. Use the UPARROW and DOWNARROW keys to select the desired option. Press the ENTER key to execute that command. These commands are loaded when StupenDOS is executed, so if changes are made to the file while running StupenDOS, you must restart the program. MOUSE: Double Click on the item in the Mouse Menu you wish to execute. Page 44 PRO Values The following is a list of the options in StupenDOS and its' associated value. These values are used in the SD.PRO file. A sample SD.PRO file is included with StupenDOS. You may wish to view this file for programmable option examples. Text Value Description (do not include in SD.PRO) RMDIR 11050 Remove a Directory MKDIR 11051 Make a Directory STATS 11006 Disk Statistics TOUCH 11005 Touch Files PKZMENU 11004 Run PKZMENU WINDOW 273 Open a Window SWITCH 9 Switch Windows COLORS 11001 Change Colors ABOUT 11000 About SD ViewZip 303 View A ZIP File ZIP 90 Zip Tagged Files UNZIP 85 Unzip a ZIP File PRINT 80 Print Tagged Files Loc BAK 4006 Delete local *.BAK Glo BAK 4000 Delete Global *.BAK DelSpec 4001 Delete Specified Files TagName 4020 Tag by Name ClrName 4021 Clear by Name TagSize 4022 Tag by Size ClrSize 4023 Clear by Size TagDate 4024 Tag by Date ClrDate 4025 Clear by Date ArchTag 4028 Tag Archive ArchClr 4029 Clear Archive 2DayTag 4026 Tag Todays Files 2DayClr 4027 Clear Todays Files Reverse 4030 Reverse Tags Remove 4031 Remove Tagged Files List 4002 Create a List File Locate 47 Locate a File DosCall 11052 DOS Call Shell 11053 DOS Shell RENAME 11054 Rename a File TREE 84 TREE display TreeNew 82 Read TREE ATTRIB 286 Change Tagged Files Attributes Find 11055 Find a File DrvInf 11056 Info, All drives NewDir 78 Reread Files COPY 315 Copy Tagged Files MOVE 316 Move Tagged Files DelNOW 363 Delete Tagged Files without confirm DELETE 318 Delete Menu CHDIR 319 Change Drive and/or Directory Clr All 302 Clear all Tags Tag All 4013 Tag all Files TYPE 89 Type File Page 45 TypeAll 4011 Type All Tagged Files EDIT 69 Edit a File EditAll 4010 Edit All Tagged Files HELP 324 Help Screen EXECUTE 88 Execute a File EXIT 11201 Exit to Startup Directory EXIT 11200 Exit to Current Directory FORMAT 75 Format a Floppy disk In the following example, StupenDOS will change to the C:\DOS directory. Normally there are only two parameters specified for internal commands. In the following example, the third parameter, C:\DOS, is necessary, and is used to specify what drive and directory to change to. CD DOS;12000;C:\DOS Any keystroke that can be pressed from the main screen can be placed in the SD.PRO file as a USR option. Like 'U' calls the UNZIP screen, so the USR line would be as follows: UNZIP;85; Copy to Drive . . . COPY A:;;11150 COPY B:;;11151 etc... Page 46 Keystroke Values that can be used for KEY options in SD.PRO. BACKARROW 8 F1 315 SHIFTF1 340 COLON 58 F2 316 SHIFTF2 341 SPACE 32 F3 317 SHIFTF3 342 PERIOD 46 F4 318 SHIFTF4 343 COMMA 44 F5 319 SHIFTF5 344 EQUAL 61 F6 320 SHIFTF6 345 QUOTE 39 F7 321 SHIFTF7 346 DBLQUOTE 34 F8 322 SHIFTF8 347 INS 338 F9 323 SHIFTF9 348 F10 324 SHIFTF10 349 CTRLF1 350 ALTF1 360 ALTB 304 CTRLF2 351 ALTF2 361 ALTE 274 CTRLF3 352 ALTF3 362 ALTG 290 CTRLF4 353 ALTF4 363 ALTH 291 CTRLF5 354 ALTF5 364 ALTI 279 CTRLF6 355 ALTF6 365 ALTJ 292 CTRLF7 356 ALTF7 366 ALTK 293 CTRLF8 357 ALTF8 367 ALTL 294 CTRLF9 358 ALTF9 368 ALTO 280 CTRLF10 359 ALTF10 369 ALTQ 272 ALTR 275 ALTY 277 CTRLLEFT 371 CTRLUP 416 SHIFTUP 500 CTRLRIGHT 372 CTRLDN 420 SHIFTDOWN 501 CTRLEND 373 CTRLDEL 422 SHIFTLEFT 502 CTRLPGDN 374 SHIFTRT 503 CTRLHOME 375 SHIFTDEL 504 CTRLPGUP 388 A 65 B 66 etc... Other key strokes that are not listed can be determined by running the WHATKEY.EXE program on the StupenDOS installation diskette.