Compu-Fix

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

/ Compu-Fix / Compu-Fix.iso / misc / shell1 / dis.man < prev next >

Wrap

Text File | 1993-03-01 | 59KB | 1,421 lines

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ██████ ▐██▄ ██████ ██████ ██████ ▀██ ██████ ██████ ██████ ██ ██████ ▀▀▀▀▀▀▀▀▀▀▀▀▀██████ ██████ ▄██ ██████ ██████ ██████ ██▀ ██████ ██████ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Directory Manager by Dennis Moon & Scott Leonard Version 3.17 Copyright (c) 1988 - 1990 MoonBeam Systems All rights Reserved. This software is protected under Federal Copyright Laws, and may not be copied or duplicated in any form whether mechanical, electronic, by latest invention, or whatever. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ █████████████████████████████████████████████████████████████████████████████ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This version of DIS is NOT public domain or free software, but is being distributed as "shareware". Non-registered users of this software are granted a limited license to make an evaluation copy for trial use on a private, non-commercial basis, for the express purpose of determining whether DIS is suitable for their needs. At the end of this trial period, you should register your copy of DIS. What does all this really mean? If you regularly use this program - i.e., once a week or more - then you should pay for your copy. A DIS registration entitles you to use the program on any and all computers available to you. It also entitles you to a version without the initial and final delays. Registered users will also receive >>>>>>>>>>>>> a FREE version of 'DSKVEW'. <<<<<<<<<<<<<<< See 'Registration' below for more details. All users are granted a limited license to copy DIS only for the trial use of others and subject to the above limitations. This license does NOT include distribution or copying of this software package. DISCLAIMER Use of this program acknowledges this disclaimer of warranty: "This program is supplied as-is. We disclaim all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness of this program for any purpose. We assume no liability for damages direct or consequential, which may result from the use of this program." ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ The Dis Operating Manual Format: Dis [options] drive, path and filespecs are optional Options: ( All command line options must be preceded by a '-' or a '/'. ) ┌─────────────┬──────────────────────────────────────────────┐ │ Option │ Result │ ├─────────────┼──────────────────────────────────────────────┤ │ -D │ Toggles between default file time option. │ │ -N │ Sort by name. │ │ -E │ Sort by extension. │ │ -M<mask> │ Only load a specific file mask. │ │ <Drive> │ │ │ <Path> │ │ └─────────────┴──────────────────────────────────────────────┘ Examples: dis Loads the current directory. dis -D Include or exclude file times. dis -N Sort files by name. dis -E Sort files by extensions. dis -M*.exe Load up all files with the extension of 'EXE'. dis C: Load the current directory on drive C. dis C:\doc Load 'DOC' directory on drive C. dis C:\doc D:\ Load 'C:\DOC' in the right window, and the root directory of drive D in the left window. dis C:\doc a:\test\123 -N -M*.doc Load the 'DOC' directory on drive C. Load the '123' directory on drive A. Sort both windows by file name. Only load files with the extension of 'DOC'. ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ╔═══════════════╗ ════════════════════════════╣ MAIN SCREEN ╠══════════════════════════════ ╚═══════════════╝ Help Files Disk Tree Sort taG Misc. Quit ╓───────────┬[ Tagged ]┬────────────╥───[ Sort ]───╥───[ Mask ]───╥──[ Total ]─╖ ║ 0 │ 0 │ 0 ║ UNSORTED ║ *.* ║ 230,561 ║ ╙─[ Files ]─┴─[ Dirs ]─┴──[ Size ]──╨──────────────╨──────────────╨──[ Size ]──╜ ╔══════════[ C:\GAMES\NFL ]══════════╗╔═════════[ C:\GAMES\CHESS ]═════════╗ ║.. │ <DIRECTORY> ║║.. │ <DIRECTORY> ║ ║A │ 128│ <A> │ 8-01-85║║CHESS .EXE│ 1744│ <A> │ 1-23-86║ ║B │ 128│ <A> │ 8-01-85║║CHESS .HLP│ 6561│ <A> │ 4-02-88║ ║C │ 242│ <A> │ 8-01-85║║CHESS1 .OVL│ 95744│ <A> │ 4-02-88║ ║D │ 162│ <A> │ 8-01-85║║CHESS2 .OVL│ 87552│ <A> │ 4-02-88║ ║E │ 128│ <A> │ 8-01-85║║CHESS3 .OVL│ 9920│ <A> │ 10-30-85║ ║F │ 162│ <A> │ 8-01-85║║CHESS4 .OVL│ 15120│ <A> │ 10-30-85║ ║G │ 1832│ <A> │ 8-01-85║║CHESS5 .OVL│ 4320│ <A> │ 4-02-88║ ║H │ 128│ <A> │ 8-01-85║║CHESS6 .OVL│ 9600│ <A> │ 4-02-88║ ║I │ 128│ <A> │ 8-01-85║║ │ │ │ ║ ║J │ 3456│ <A> │ 8-01-85║║ │ │ │ ║ ║K │ 14720│ <A> │ 8-01-85║║ │ │ │ ║ ║L │ 1024│ <A> │ 8-01-85║║ │ │ │ ║ ║M │ 3712│ <A> │ 8-01-85║║ │ │ │ ║ ║N │ 130│ <A> │ 8-01-85║║ │ │ │ ║ ║O │ 384│ <A> │ 8-01-85║║ │ │ │ ║ ║P │ 384│ <A> │ 8-01-85║║ │ │ │ ║ ║Q │ 384│ <A> │ 8-01-85║║ │ │ │ ║ ║NFL .EXE│254080│ <A> │ 8-01-85║║ │ │ │ ║ ╚══[ # Files 52 # Dirs 1 ]══╝╚══[ # Files 8 # Dirs 1 ]══╝ This, if you have not yet seen it, is Dis's main screen. ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ╔═══════════════════╗ ═══════════════════════════╣ MENU SELECTIONS ╠════════════════════════════ ╚═══════════════════╝ At the very top of the screen are the main menu selections. Each selection will have one capitalized (highlighted) letter. To select a main selection, simply press the highlighted letter. This will cause the sub selections to appear. There are two methods of selection sub selections: 1. Press the highlighted letter of the desired function. 2. Use the up and down arrow keys to move the bar over the desired function, then press enter. ┌─────────────────────────────────────────────────────────────┐ │note: If the capitalized letters do not appear highlighted,│ │ and you are using a monochrome monitor, adjust the │ │ contrast and brightness controls. │ └─────────────────────────────────────────────────────────────┘ Most of these functions can also be called through the use of Function keys, or Alt key combinations. This is discussed later in the KEYS section. ┌─────────────┐ │STATUS WINDOW│ └─────────────┘ Directly under the main menu selections is the status window. The status window is divided into four main categories: 1. Tagged a. Files : Shows total number of tagged files. b. Directories : Shows total number of tagged directories. c. Size : Shows total size of all tagged files. 2. Sort : Shows type of sort (Name, Extension, Unsorted). 3. Mask : Shows the current file Mask. 4. Total Size : Shows total size of all files in the active directory window. ┌──────────────────────┐ │RIGHT AND LEFT WINDOWS│ └──────────────────────┘ The top of each directory window displays the current directory. The files and subdirectories within that directory are displayed below. Subdirectories are always displayed first, followed by files. Each file is divided into six fields. 1. File name (without extension) 2. File extension 3. File size 4. File attributes 5. File date 6. File time ( Configuration Option ) Files or directories that have special attributes ( hidden, read only, or system ) are highlighted differently. These colors can be set using disconfg.exe. The bottom of the window displays the total number of files and subdirectories within the current directory. ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ╔════════╗ ════════════════════════════════╣ KEYS ╠══════════════════════════════════ ╚════════╝ ┌────────────────┐ │ General Keys │ └────────────────┘ These keys control the file bar. Page Up Moves one page up. ( 21 files ). Page Down Moves one page down. ( 21 files ). Up Arrow Moves one file up. Down Arrow Moves one file down. Home Moves to the first file in directory. End Moves to the last file in directory. ┌────────────────┐ ──────────────────────────────┤ Command Keys ├──────────────────────────── └────────────────┘ Dis allows the user two way to select functions. Either with the pull down menu, or by the use of function and Alternate keys. ||||||||||||||||||||\\\ Pull Down Menu ///||||||||||||||||||||| There are eight main menu selections. Each main selection will have sub selections to choose from. Here is an expanded list of the functions. Help Quick help Extended help Files Copy Move Rename Delete Backup Jump to file change file Attributes change file Time and date Search and delete entire disk load user Editor Disk Drive change Change disk or dir. Make directory Search disk for file seT home directory Tree View tree Sort Extension Name Unsorted taG All files / no dirs Select extension Untag all Misc. system Call System status Dos shell Print file toggle file Time load common file Mask Quit Yes No A description of all of these functions is explained below. In this manual these functions are referenced by two letters (the capitalized letters) enclosed in 'greater and less than' brackets ( <> ). For and example, main selection File and subselection Copy, would look like < FC >. Some more frequently used functions are not called by the pull down menu. Here is a list of these functions. ┌────────────────┬─────────────────────────────────────────────┐ │ KEY │ FUNCTION │ ├────────────────┼─────────────────────────────────────────────┤ │ │ │ │ F1 │ Quick Help │ │ Alt F1 │ Extended Help │ │ F2 │ Normal Dir (No Sort) │ │ Alt F2 │ Sort by Name │ │ Cnt F2 │ Sort by Extension │ │ F3 │ Rename files │ │ F4 │ New Disk / Dir. │ │ F5 │ Copy files │ │ Alt F5 │ Move files │ │ Cnt F5 │ Backup Files │ │ F6 │ System Calls │ │ F7 │ Make Directory │ │ F8 │ Delete Files / dirs. │ │ F9 │ Change dir. with Tree │ │ F10 │ Change File Attributes │ │ ESC │ Quit Dis ? │ │ │ │ │ Insert │ Mark / Unmark │ │ Cnt PgUp │ Up one Directory │ │ Cnt Home │ Return to home Directory │ │ │ │ │ Alt C │ Load Common Mask │ │ Alt D │ Toggle File Times │ │ Alt E │ Load User Editor │ │ Alt F │ Search For File │ │ Alt J │ Jump to File Name │ │ Alt L │ Remove Left File Window │ │ Alt R │ Remove Right File Window │ │ Alt S │ System Stats. │ │ Alt T │ Move to Root Directory │ │ Alt M │ Macro Men │ │ Alt 1 -> Alt 9 │ Execute Macro │ │ │ │ │ Cnt A -> L │ Change Drive │ │ │ │ │ PrtSc │ Mark All Files │ │ Grey + │ Selective Marking │ │ Grey - │ Unmark All │ │ │ │ │ Space bar │ Reread Disk │ │ │ │ │ Enter │ View file, Change dir., execute file, │ │ │ View archive. See 'ENTER' below. │ │ │ │ └────────────────┴─────────────────────────────────────────────┘ ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ENTER The reaction of Enter is dependent upon the position of the file bar. If it is on a directory, then dis will change to that directory. If it is on '..' directory, dis will move one directory up. If the file bar is on an '.exe' or '.com' file, the user will be prompted for command line arguments, and the file will be executed. If it's on a '.bat' file, the user will be prompted whether to view or execute the file. If execute is selected the user will be prompted for command line arguments. If the file bar is on a file with the extension of '.zip' or '.arc', dis will prompt the user with a utility menu to select the desired program options. Dis will try to execute the archiving/unarchiving program with the selected options. This means that the programs must be present along the path for this function to work. Selecting any other file will view the file (see VIEW FILE below). ┌─────────┐ ───────────────────────────────┤VIEW FILE├─────────────────────────────────── └─────────┘ 'View' Commands: Page Up : Moves up 23 lines. Page Down : Moves down 23 lines. Home : Jumps to the beginning of the file. End : Jumps to the bottom of the file. Up arrow : Moves up 1 line. Down arrow : Moves down 1 line. Escape : Returns back to the directory window. ┌───────────────────────────────────────────────────────────┐ │note: Large viewing tasks may be more convenient by using │ │ an editor. ( See 'Edit files' < FE > ) │ └───────────────────────────────────────────────────────────┘ ═════════════════════════════════════════════════════════════════════════════ ESCAPE Escape at any time when control is in the directory window, will pull down the 'Quit' menu. To exit the program either press return on the 'Yes' selection or press 'Y'. Escape during any of the Pop Down menues or prompting windows will return back to DIS. ─────────────────────────────────────────────────────────────────────────────── SPACE BAR The space bar will reread the current directory. This is most helpful when changing floppy disks. ═════════════════════════════════════════════════════════════════════════════ ┌──────────────┐ ───────────────────────────────┤Help Functions├────────────────────────────── └──────────────┘ < HQ > F1 QUICK HELP At any time when control is with the file highlighter, < HQ > will display a help window. Any key will return you back to the directory window. ┌──────────────────────────────────────────────────────────┐ │note: For more information about a function, │ │ use the Extended Help function < HE > │ └──────────────────────────────────────────────────────────┘ ═════════════════════════════════════════════════════════════════════════════ < HE > Alt F1 EXTENDED HELP < HE > calls an external program called 'DISHELP.EXE'. Dishelp.exe then uses an external file called 'DIS.HLP'. Both of these files must be in the system path. Dishelp.exe can also operate independently of Dis. To use the extended help, just move the selector bar over a help topic, and press enter. Information about the topic will be displayed in the window. The up and down arrows scroll the window one line, and page-up and page-down scroll the window an entire page. To return from a description, press enter or escape. To exit dishelp (extended help) press escape. ┌─────────────────────────────────────────────────────────────┐ │note: Dishelp.exe and Dis.hlp must be along the system path.│ └─────────────────────────────────────────────────────────────┘ ═════════════════════════════════════════════════════════════════════════════ ┌──────────────┐ ───────────────────────────────┤File Functions├────────────────────────────── └──────────────┘ ┌──────────────────────────────────────────────────────────────────┐ │ note: Some file functions will also work on directories. In │ │ some cases directories will be treated like files. Copy,│ │ Move, Rename, Delete, Backup, Change attribute, and │ │ Jump to file will all work on directories also. │ └──────────────────────────────────────────────────────────────────┘ < FC > F5 COPY < FC > will display all tagged files or file at bar, and total number and size of all files to be copied. ╒════[ Insufficient Disk Space ]════╕ │ │ │ [ R ] to Retry with a BLANK disk │ │ Escape to Abort │ │ │ ╘════[ Press other key to Skip ]════╛ If a file is to large to fit onto the destination drive, the user will be asked to either skip to next file, replace the full disk with a blank disk (assuming floppies), or abort the entire copy operation. ╒═══════[ FILEXX.EXE ]═══════╕ │ [ F1 ] Replace All │ │ [ F2 ] Replace File │ │ [ F3 ] Skip │ │ [ ESC ] Abort │ ╘═════[ Already Exists ]═════╛ If a file already exists in target path, the user will be asked to Replace just that file, or replace All files (exist or not). Escape will abort entire copy function. Any other key will skip only that particular file. < FC > will also copy whole directories. Example: Tag directory(s) from root directory. < FC > will ask for drive and/or path. It will then show all the files within the directory. It will also ask you, just for added security, whether to copy the directory files. Answer yes. It will copy all files in the directory to the destination, keeping them in their directory. ─────────────────────────────────────────────────────────────────────────────── < FM > Alt F5 MOVE < FM > will move files between directories on the same disk. This is a fast way of managing groups of files. It, in effect, only renames the files, therefore never even touching the data. MOVE can also move files or directories between disks. This is accomplished by first coping files, then deleting the source files. Moving directories will create the destination directory (not the full path) if it does not already exist. ─────────────────────────────────────────────────────────────────────────────── < FR > F3 RENAME < FR > will rename files and directories. If files are tagged it will ask for each file/dir. separately. Escape will skip the file, and Control A will abort entire rename function. ─────────────────────────────────────────────────────────────────────────────── < FD > F8 DELETE < FD > will delete either tagged files or file at bar. If files are protected (read-only), it will ask if user wants to delete or skip. It will also delete entire directories, much in the same that copy works. Example: Tag directory. < FD > will ask if you want to delete it. Answer Yes. It will then show a list of all files in the directory, and ask again if you want to delete the full directory. Answer yes. For added protection, it will ask for each full directory. ─────────────────────────────────────────────────────────────────────────────── < FB > Cnt F5 BACKUP < FB > will backup the entire current directory or tagged files. If no files are tagged, Dis will backup the entire directory. This means that Dis will check the backup bit (Archive), and if set copy the file(s) to the destination drive. Dis then resets the backup bit (Normal) to indicate the files have been backed up. If any files are tagged, Dis will backup only those files that are tagged, and reset the backup bits. Tagged files will be copied regardless of the backup bit. Dis will create a path tree on the destination drive identical to the source path. F9 will allow the user to easily select an already existing directory. More on F9 functions later. Option [ 'S' ] will let the user specify a different destination path. ─────────────────────────────────────────────────────────────────────────────── < FA > F10 CHANGE FILE ATTRIBUTES ╒════<< Hit Return when Done >>═════╕ │ │ ╘════════<< + - H R A N S >>════════╛ < FA > will change the file attributes of either tagged files or the file at the bar. There are four attributes that can be assigned to a file. 1. Archive. This attribute indicates that the file has been modified at some time since its creation. This is the bit most backup operations check. 2. Hidden. This attribute protects the file or directory from normal DOS commands by hiding it. Hidden files are also protected because they can not be erased. DIS CAN BOTH SEE THEM AND DELETE THEM. 3. Read-Only. This attribute enables you to view/run the file, but it cannot be erased or modified from DOS. DIS CAN DELETE READ-ONLY FILES. 4. System. This attribute is used to mark system files. A system file is hidden and cannot be deleted. Caution should be used when modifying these files. They are usually crucial to the system. ┌──────────────────────────────────────┐ │WARNING : DIS WILL DELETE SYSTEM FILES│ └──────────────────────────────────────┘ An absence of any attributes is referred to as NORMAL. Although this is not an actual attribute, it is regarded as one here. After files have been backed up, the attribute is usually set to normal to indicate the file has not been modified since it was last backed up. To add an attribute, enter the plus sign followed by the attribute to be added. To remove an attribute, enter the minus sign followed by the attribute. Entering only the attribute will clear all other attributes and assign the new. Subdirectories can only be Hidden or Normal. When Dis either adds or removes attributes it first checks to be sure they can be added or removed. If they can not, Dis 'beeps' to notify that the attribute was not modified. ─────────────────────────────────────────────────────────────────────────────── < FT > CHANGE FILE TIME AND DATE ╒═════════[ Set File Time ]═════════╕ │ 20:57 │ ╘══[ Format : hr:mi ( 24 hr ) ]══╛ ╒═════════[ Set File Date ]═════════╕ │ 01-10-89 │ ╘══════[ Format : mo-da-yr ]══════╛ < FT > will change the file time and date stamp of all tagged files or the file at the selector bar. < FT > will prompt user with a time window, and a date window. Dis defaults to the system time and date. Time must be entered in a 24 hour format. The date must be after 1980. note: < FT > will NOT change the time or date of subdirectories. ─────────────────────────────────────────────────────────────────────────────── < FS > SEARCH AND DELETE (Mass Delete) < FS > will delete a file, or a group of files, throughout the entire disk. This function uses the 'dis_tre' file for scanning. This function does NOT ask before deleting each file. It is advisable to first do a 'SEARCH' for the filespec before calling the mass delete. ─────────────────────────────────────────────────────────────────────────────── < FE > Alt E LOAD USER EDITOR < FE > will load up to 5 tagged files into the default editor. When the editor is exited, dis will regain control. Not all editors will allow loading a list of files on the command line. The initial default editor is 'edlin.com'. Edlin will only load one file from the command line, so tagging more than one file will have no effect. ┌─────────────────────────────────────────────────┐ │note: User editor can be set with 'DISCONFG.EXE'.│ │Discussed later. │ └─────────────────────────────────────────────────┘ ─────────────────────────────────────────────────────────────────────────────── < FJ > JUMP TO FILE ┌──────────┤ Jump to File ├──────────┐ │ │ │ Enter a Letter > _ │ │ │ └─────────┤ Escape to Abort ├────────┘ Jump to file will 'jump' to the file name typed at the prompt. For example: Pressing 'D' will cause the file selector to jump to the first file or directory beginning with 'D'. Then by pressing 'I' the file selector will jump to the first file beginning with 'DI'. Etc... . If a match can not be made the jump function will abort. Pressing the escape key or the space bar will also abort the jump function. ═════════════════════════════════════════════════════════════════════════════ ┌──────────────┐ ───────────────────────────────┤Disk Functions├────────────────────────────── └──────────────┘ < DD > CHANGE DRIVE < DD > will prompt the user for a drive letter. ╒══════════════════════════════════════╕ │ Change Drive │ │──────────────────────────────────────│ │ │ │ Enter Drive > _ │ │ │ ╘══════════════════════════════════════╛ Simply press the letter for the desired drive. And Dis will change the the current directory of the new drive. Drives can be more easily changed with the < Control key > < Drive > short-cut. ─────────────────────────────────────────────────────────────────────────────── < DC > F4 NEW DISK OR DIR < DC > will prompt user to enter name of a Drive and/or Directory. Dis will then 'jump to' the specified path. (saves some running around). It is now possible to enter only a drive letter (without the colon) to select a drive. ─────────────────────────────────────────────────────────────────────────────── < DM > F7 MAKE DIRECTORY < DM > will prompt user with a window. Simply enter the name and/or path of new directory. Dis will create the directory. ╒══[ Save tree structure to file ]══╕ │ [ F1 ] Save to File │ │ [ ESC ] Skip │ ╘═══════════════════════════════════╛ After making the directory, Dis will ask to save the disk tree structure to a file. If the disk is NOT scanned, the changes will not be reflected when using the 'F9 directory tree' command. ─────────────────────────────────────────────────────────────────────────────── < DS > Alt F DISK SEARCH < DS > will search the current drive for a specified file pattern. Wildcards are accepted. If user wishes, Dis will pause after each match. If in pause mode, the choices are to abort search, view file, or jump to directory where the file was found. When finished, Dis will display total number of directories scanned and the total number of matches. ╒[ Pause when match is found ? ]═╕ │ [ F1 ] Yes │ │ [ F2 ] No │ │ [ ESC ] Abort │ ╘════════════════════════════════╛ Search will search the entire disk for matching files or directories. If the tree structure has not been read into memory, it will search for a file named 'dis_x.tre' ( x = drive letter ). If the file can't be found, it will read the directory structure into memory. ┌──────────────────────────────────────────────────────────────┐ │note: The speed of the search process is increased if the │ │directory structure has been saved via F9. Searching is also │ │faster if disk is compressed and unfragmented. │ └──────────────────────────────────────────────────────────────┘ ─────────────────────────────────────────────────────────────────────────────── < DT > SET HOME DIRECTORY Setting a directory is a way of tagging a directory for easy return. The initial home directory is the directory that dis was started from. When the directory is set it marks the current directory as the home directory. Control Home will return, at any time, to the last set (home) directory. ═════════════════════════════════════════════════════════════════════════════ ┌─────────────┐ ───────────────────────────────┤Tree Function├────────────────────────────── └─────────────┘ < TV > F9 VIEW TREE ┌──────────[ C:\GAMES\CHESS ]──────────┐ │C:\ │ │├───ASM │ │├───BASIC │ │├───EDIT │ ││ ├───QX │ ││ ├───WP │ ││ └───WX │ ═ ═ │├───TEMP │ │└───GAMES │ │ └───CHESS │ └[ Cnt A - L change dr. [^R] Re-Scan ]─┘ F9 is a fast and easy way to move around a disk. It provides a graphical display of the disks directory structure. When using F9, Dis first looks in the root directory of the current drive for a file called 'DIS_X.TRE' (created by Dis), where X is the drive letter. If this file is present, Dis will quickly read in the disks directory structure. ┌─────────────────────────────────────────────────────────────┐ │note: We strongly recommend that this file (DIS_X.TRE) │ │ is created and maintained. │ └─────────────────────────────────────────────────────────────┘ If this file is not present Dis will prompt the user to create the file. Dis then scans the entire subdirectory structure and saves it if previously requested. It takes a few seconds to do this. ┌──────────────────────────────────────────────────────────────┐ │note: This file (DIS_X.TRE) will also increase search time│ │ when searching for a file < DS >. │ ├──────────────────────────────────────────────────────────────┤ │WARNING: If a directory structure is modified, (deleting, │ │ renaming, or creating directories), the disk must be│ │ re-scanned and re-saved. This is done easily with │ │ 'Control R' (inside the left directory window). │ └──────────────────────────────────────────────────────────────┘ To change directories with F9, simply move the directory bar over the desired directory and press return. Dis will change to the directory, and remove the 'tree' window. By just entering a single letter, Dis will search the entire tree for directories beginning with specified letter. Successive tries of the same letter will move to the next directory beginning with the letter. F9 can also view, and change to another disk. Control A through Control L Change drives. It does not actually change drives until enter is press. The nice thing about F9 is it can be used for coping or moving also. Any time a prompt window displays 'F9 for directory tree', The path can be selected by the tree instead of manually typing it in. This is very convenient for lengthy paths, or if you are not quite sure of the exact path name. ═════════════════════════════════════════════════════════════════════════════ ┌──────────────┐ ─────────────────────────────┤Sort Functions├─────────────────────────────── └──────────────┘ Dis enables files and directories to be sorted in three different ways. Sorting, groups files for easier comprehension. Dis does not actually sort the physical directory, it only sorts the files within the directory window. ┌────────────────────────────────────────────────────────────┐ │note: Default sort can be set with 'DISCONFG.EXE'. Discussed│ │later. │ └────────────────────────────────────────────────────────────┘ ═════════════════════════════════════════════════════════════════════════════ < SE > Cnt F2 SORT BY EXTENSION < SE > will sort files alphabetically by their extensions. ─────────────────────────────────────────────────────────────────────────────── < SN > Alt F2 SORT BY NAME < SN > will sort files alphabetically by their names. ─────────────────────────────────────────────────────────────────────────────── < SU > F2 ORIGINAL DOS SORT If files were previously being sorted by name or extension, < SU > will return them to their original order ( same order as if you typed 'dir' ). This function simply rereads the current directory without doing any sort. ═══════════════════════════════════════════════════════════════════════════════ ┌─────────────────┐ ────────────────────────────┤Tagging Functions├─────────────────────────────── └─────────────────┘ Tagging files creates a file 'queue' for selectively manipulating files and directories. INSERT TAG FILE / DIRECTORY Insert will tag/untag any file or directory (except ..). When a tag is made, a total will be displayed in the status window. This window will indicate how many files and directories are tagged, and the total size of all tagged files. If a file is tagged, insert will untag the file. ─────────────────────────────────────────────────────────────────────────────── < GA > PrtSc TAG ALL FILES / NO DIRECTORIES < GA > will tag all files and untag all directories. ─────────────────────────────────────────────────────────────────────────────── < GS > Grey + SELECT A COMMON EXTENSION ╔══════════════════════════════════════╗ ║ Tag Common Extension ║ ║──────────────────────────────────────║ ║ ║ ║ Enter extension to tag > .* ║ ║ ║ ╚══════════════════════════════════════╝ < GS > will prompt user to enter an extension to tag. All Files having the extension will be tagged. < GS > can tag files and directories. This is a fast and easy way to selectively tag common extensions. Consecutively using < GS > will add to the tag queue. Example: At the prompt enter COM . This will tag all files with a 'COM' extension. At the prompt enter EXE . This will add all files with an 'EXE' extension to the tag queue. ─────────────────────────────────────────────────────────────────────────────── < GU > Grey - UNTAG ALL < GU > will untag all files and directories. This is a fast and easy way to clear out all tags. ┌───────────────┐ ───────────────────────────────┤Misc. Functions├────────────────────────────── └───────────────┘ < MC > F6 SYSTEM CALLS < MC > will prompt user with a window. Any command that can be executed at the DOS prompt can be entered here. This saves time by eliminating the need to exit and reload Dis. ┌──────────────────────────────────┐ │note: You should NOT execute any │ │ TSR (terminate and stay │ │ resident) commands here. │ └──────────────────────────────────┘ ─────────────────────────────────────────────────────────────────────────────── < MS > Alt S SYSTEM STATUS < MS > will pop up a disk status window. The window displays: The systems time and date Port Status (Comm., Printer, Game) Path and Comspec Volume Label Current Directory Startup Directory (or last 'set' home directory) Dos Version Total Disk Space on current drive Total System memory (Total, Available, Used) ─────────────────────────────────────────────────────────────────────────────── < MD > DOS SHELL < MD > will load command.com on top of Dis. This enables the user to do anything he would normally do when in DOS. To return to Dis, just type 'exit' and DOS will return control back to Dis. ─────────────────────────────────────────────────────────────────────────────── < MP > PRINT FILE < MP > will print the file at the file selector to the system printer ( PRN ). ─────────────────────────────────────────────────────────────────────────────── < MT > TOGGLE FILE TIME ╒════════════[ C:\GAMES\CHESS ]════════════╕ │.. │ <DIRECTORY> │ │CHESS .EXE│ 1744│ <A> │ 1-23-86│ 8:24a│ │CHESS .HLP│ 6561│ <A> │ 4-02-88│ 3:59a│ │CHESS1 .OVL│ 95744│ <A> │ 4-02-88│ 3:59a│ │CHESS2 .OVL│ 87552│ <A> │ 4-02-88│ 3:59a│ │CHESS3 .OVL│ 9920│ <A> │10-30-85│ 1:00a│ │CHESS4 .OVL│ 15120│ <A> │10-30-85│ 1:00a│ │CHESS5 .OVL│ 4320│ <A> │ 4-02-88│ 3:59a│ │CHESS6 .OVL│ 9600│ <A> │ 4-02-88│ 3:59a│ │ │ │ │ │ │ ═ ═ ═ ═ ═ ═ │ │ │ │ │ │ ╘════[ # Files 8 # Dir's 1 ]═════╛ < MT > increases \ decreases the size of the file window to include file times. To start dis up with window expanded, use command line argument -d. EXAMPLE : dis -d ┌─────────────────────────────────────────────────────┐ │note: Default setting can be set with 'DISCONFG.EXE'.│ │Discussed later. │ └─────────────────────────────────────────────────────┘ ─────────────────────────────────────────────────────────────────────────────── < MM > LOAD COMMON MASK ( Extension ) ╒══════════════════════════════════════╕ │ Change Common Extension │ │──────────────────────────────────────│ │ │ │ Enter extension > *. │ │ │ ╘══════════════════════════════════════╛ < MM > will load all files with a common extension. Directories will be loaded regardless of their extension. Example: At the prompt enter EXE . Dis will ONLY load files with the extension '.EXE'. ( and all directories ) This is a convenient way to filter out unnecessary files. ─────────────────────────────────────────────────────────────────────────────── Alt M Select User Defined Macro Pressing the <Alt> key while pressing the 'M' key on the will display a menu of your user defined macros. These macros can be executed from this menu. Simply move the selector bar over the desired macro and press enter. Macros can also be executed directly from the file window by pressing Alt 1 through Alt 9 ( See 'Execute Macro' below ). ╒═══════════[ Macro Menu ]═══════════╕ │ │ │ Directory then pause │ │ Dir of C: │ │ Chkdsk │ │ Unzip file at bar │ │ │ │ │ │ │ │ Dir of file at bar │ │ │ │ │ ╘════════[ Enter to Select ]═════════╛ These macros can be created or modified with the configuration program 'disconfg.exe'. See 'Modifying User Macros' in the configuration section below. ─────────────────────────────────────────────────────────────────────────────── Alt 1 through Alt 9 Execute Macro Nine User definable macros are possible. The macros are stored in a text file call 'DIS.MAC'. This file can be anywhere along the system path. To execute a macro simply hold down the <Alt> key while pressing one of the numeric keys (1 - 9) on the TOP row of your keyboard. Alt 1 will execute the first macro, Alt 2 will execute the second, etc... . These macros can be created or modified with the configuration program 'disconfg.exe'. See 'Modifying User Macros' in the configuration section below. ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ╔══════════════════╗ ════════════════════════════╣ CONFIGURATION ╠═════════════════════════════ ╚══════════════════╝ ┌──────────────┐ ──────────────────────────────┤ Disconfigure ├────────────────────────────── └──────────────┘ Disconfg.exe Disconfg.exe is an external program that enables the user to configure Dis.exe to their own preference. Disconfg functions: 1. Sets Users editor for < FE > command. 2. Sets start-up sort type. a. No sort b. Name c. Extension 3. Sets Default Colors. 4. Selects option for expanded directory window. ( file times ) 5. Configures User Definable Macros. ┌───────────────┐ │CHANGING COLORS│ └───────────────┘ -> [ Tagged File ] [ Selector Bar ( untagged ) ] [ Selector Bar ( tagged ) ] [ Windows / untagged files ] [ Window Borders ] [ Window Titles ] [ Special Attribute ] [ Include File Times ] = OFF [ User Editor ] = EDLIN.COM [ Default Sort ] = NO Sort [ Modify User Macros ] Use the up and down arrows to move the small arrow next to the desired item. The left and right arrows change the color. 'F' toggles between foreground and background colors. 'I' toggles intensity of foreground color. 'B' toggles blinking of the foreground. Definition of color names. Tagged File Color of a tagged file if the file bar is NOT over it. Selector Bar ( untagged ) Color of the file bar if it is over a file that is NOT tagged. Selector Bar ( tagged ) Color of the file bar if it is over a file that IS tagged. Windows / untagged files Color of UNTAGGED files when the file bar is NOT over them, and the color of all other windows. Window Borders Color of the window borders. Window Titles Color of the window titles. Special Attribute Color of untagged files or directories with special attributes ( Hidden, Read only, or System ). Press Escape when finished with changes. Disconfigure will then prompt to [S]ave configuration. 'S' will modify Dis.exe, any other key will abort changes. When using an IBM PS2 system with a monochrome monitor, dis uses the color defaults, which aren't very pleasing in black and white. ┌─────────────────────────────────────────────────────────┐ │note: Dis.exe must be in the current directory. │ │ Disconfg will only change the color attributes │ │ that correspond to the current monitor type. │ │ I.e., changing the attributes with a color monitor│ │ will not effect the monochrome attributes. │ └─────────────────────────────────────────────────────────┘ ┌───────────────────────┐ │ Modifying User Macros │ └───────────────────────┘ Nine User definable macros are possible. The macros are stored in a text file call 'DIS.MAC'. This file can be anywhere along the system path. To create or modify the macros, move the pointer arrow next to the 'Modify User Macros' field and press <enter>. If the file is not found in the path, disconfg will create a new file. Move the editing field to the desired Alt key combination by pressing <enter>. To modify the macro simply type over or add to the old one. Be sure to press <enter> when finished to save the modifications. Using a %1 in the command will cause the name at the file bar to be substituted for the %1. To execute a series of commands use the '!' character to define the separation. Here is the default (shipping) DIS.MAC file and an explanation of the results. ┌───────────────────────────────────────────────────────────────────┐ │ All of these examples first return to DOS. │ ├───────────────────────────────────────────────────────────────────┤ ├───────────────────────────┬───────────────────────────────────────┤ │ Alt 1 = dir!pause │ Show a directory of the current │ │ │ drive. Then pause. │ │ Alt 2 = dir C: ! pause │ Show a directory of drive C. │ │ │ Then pause. │ │ Alt 3 = chkdsk ! pause │ Run DOS chkdsk of the current drive.│ │ │ Then pause. │ │ Alt 4 = pkunzip %1 │ Unzip (unarchive) the file at the │ │ │ file bar. │ │ Alt 5 = │ Does nothing. │ │ Alt 6 = │ Does nothing. │ │ Alt 7 = │ Does nothing. │ │ Alt 8 = dir %1 │ Show the directory of the directory │ │ │ at the file bar. │ │ Alt 9 = │ Does nothing. │ └───────────────────────────┴───────────────────────────────────────┘ ┌─────────────────────────────────────────────────────────────────┐ │ note: The file 'DIS.MAC' can also be created or modified with │ │ a standard editor. Each line should not exceed 66 │ │ characters. If more than 66 characters are needed it │ │ is recommended to create a batch file and call the │ │ batch file with the macros. │ └─────────────────────────────────────────────────────────────────┘ ░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒▓░▒ ┌──────────────┐ ─────────────────────────────┤ REGISTRATION ├──────────────────────────── └──────────────┘ If you are not already a Registered user, and you like the program and find it useful, we would appreciate if you would register your copy. A $15 (+ shipping) shareware contribution will register you as a user, and entitle you to a version without the initial and final delays. Registered users will also receive >>>>>>>>>>>>> a FREE version of 'DSKVEW'. <<<<<<<<<<<<<<< Dskvew is a utility that gives the user low level disk access. Some of Dskvews features include: 1. Display and edit disk sectors. 2. Display and edit binary files. 3. Search an entire disk or file for specific data. 4. Compare files. 5. Fill an entire sector with a specified data byte. See the file 'ORDRFORM' for registration details. We would also appreciate any input you would care to give concerning DIS. If you have any ideas or comments that would make DIS a better program, then please let us know. Thank You MoonBeam Systems