======== ====== ======= == == == === == == === === == == == === == ====== ======= [TDZware] Magical Systems Software DiRectory ********* Enhanced Directory Utility (for DOS) Version 0.07a August 20, 1994 (C) Copyright Victor Magdic 1994, All Rights Reserved Description ----------- DiRectory (DR) is an enhanced directory listing utility for DOS. It as been tested with DOS 5.x and 6.x. It should work fine with earlier versions of DOS. Reason for this Program ----------------------- You're probably asking, "why another directory utility?". I wrote this program because I feel there are a number of shortcomings with DOS's "built-in" directory command. "DR" was initially a utility I wrote for myself, but at the request of several people I have fixed it up and decided to release it publicly. Features -------- * You can specify multiple wildcards on the command line. For example, DR *.TXT *.DOC *.WP *.BAT will give you a directory listing matching *any* of the wildcards you have specified. Up to 30 wildcards can be specified. * Show transfer times for 2400, 4800, 9600, 14.4k, 28.8k modems for the displayed files. * There are several built in "filters" which will automatically 'choose' certain file types (extensions) for you. Example, the /fe switch will show you all the executable files in the directory (e.g. files with *.BAT *.EXE or *.COM extensions). This is perhaps the most powerful feature of DR. The filter options are explained in more detail in the section "Command Line Options" below. * The directory can be sorted by filename, extension, time and date, by size, or no sorting at all. * Directory listing can be paused at any time by pressing the spacebar. * A widescreen format (similar to DOS's DIR) is supported. * DR shows you file and directory attributes in an easy to understand format. See section titled "Sample Listing" below. * Output can be redirected to a file using DOS redirection. Example, DR >out.txt will redirect output to the filenamed OUT.TXT Sample Listing -------------- Here is a sample of a directory generated by DR:  Directory of K:\DIST\DR\*.*  Volume label [ !!COMPRESS! ] . n/a ....D. Mar 15,94 10:30:14 .. n/a ....D. Mar 15,94 10:30:14 Dcall Diz 293 .....A Mar 04,93 14:22:08 Dr Txt 10,574 .....A Nov 21,93 15:46:25 History Txt 4,008 .....A Nov 21,93 15:44:13 Out Txt 0 .....A Mar 15,94 10:51:20 þ 4 files totalling 14,875 bytes ( 0 sub-directories ) þ 21,143,552 bytes free ( 153,059,328 bytes total ) -------------------------- Notes: * The date is shown in a clear unambiguous manner (so you don't have to worry whether "12/11/94" means Dec 11, 94 or Nov 12, 94) * The attributes for each file and directory are shown after the file size, and can take on the following possible values: RHSVDA where, R means ReadOnly H means Hidden S means System V means volume D means Directory A means Archive example: RH...A means the file is ReadOnly, Hidden, and has the Archive attribute set. Command Line Options -------------------- Options supported: (note all options can be combined in any order) Usage: DR [name1...nameN] [ /W /P /Txx /H /? /Facedu /Onest ] where: [name1..nameN] are the filespecsor directories /W Use wide display mode /P Pause when screen full /Txx Transfer times (xx = 24, 48, 96, 14, 28) /H or /? Help screen /F Filter display a archive files c 'C' and 'C++' files e executable files u user defined filter d directories only (via TDZDR env variable) /O Sorted display n By name (default) e By extension s By size (smallest first) - Don't sort t By date/time (earliest first) Pausing ------- /P Causes DR to automatically pause when the screen is full. In addition, you can pause the display at any time by pressing the spacebar (after which DR will continue to pause automatically every screenfull). Transfer Times -------------- /Txx Will show you how long the displayed files would take to transfer by modem. The value xx specifies the type of modem: xx = 24 for 2400 baud xx = 48 for 4800 baud xx = 96 for 9600 baud xx = 14 for 14.4k baud * default xx = 28 for 28.8k baud If no value is specified for xx, 14.4k is assumed. Actually, for 4800, 9600, 14.4k you can get by specifying only the first number, however; for 2400 or 28.8k the second digit is necessary to distinguish the two. The following cps rates are assumed for the above baud rates, the program will display +- 5% of the following values as well: 2400 baud, 235 cps 4800 baud, 470 cps 9600 baud, 940 cps 14.4k baud, 1600 cps 28.8k baud, 3200 cps Most of these values are based on experience, but some are guesses :) Of course your results will vary depending on your brand of modem and the transfer protocol you use. This is only meant as a rough guide. Nevertheless, if you feel some of these values are way out of line, let me know. Filters ------- /fa Will show only "archive" files, i.e. files ending in the following extensions: ARJ, ARC, ZIP, LHA, PAK, ZOO, DWC, HYP, LZS /fe Will show only "executable" files, i.e. files ending in the following extensions: EXE, COM, BAT /fc Will show only "C/C++" files, i.e. files with extensions: C, CPP, H, HPP, PRJ /fd Will show only subdirectories, no files will be displayed. /fu User defined filter. By setting the environment variable TDZDR you can specify what file extensions you want to display. For example, if TDZDR is set to *.PAS *.TPU, then running DR /fu will only show files with *.PAS or *.TPU extensions. SET TDZDR=*.PAS *.TPU DR /fu ; will show files with PAS and TPU extensions If you plan on using this feature it is easiest to set the TDZDR environment variable in your AUTOEXEC.BAT file. Notes: ------ * Filters can be combined, for example, DR /fa /fe will show all archive files and all executable files. * DR does not actually know what an executable file or an archive file is, etc. It assumes the type of file based on the extension. So if you had a ZIP file named GAME.ZZZ, DR would not recognize it as a ZIP file. * You may disagree with my choice of file extensions to filter, and in some cases they were quite arbitrary (e.g. the C/C++ filter). If you think there is something important I've overlooked let me know and I'll see about including it. In the meantime you can use the user-defined filter. Sort Options ------------ /on Sort by filename /oe Sort by file extension /os Sort by file size /ot Sort by file date and time /o- Do no sort, display files in natural order Note: ----- * Only the output display is sorted, the directory structure itself is not modified. How much does it cost? ---------------------- This utility is FREE! If you like it you can continue to use it for as long as you like free of charge! Credits ------- The method of displaying file and directory attributes in the RHSVDA format was adapted from the public domain program LSD by Bob Stout. Other than that, DR is completely original material. Legal Stuff and Disclaimer -------------------------- "DR" refers to the executables and documentation in the original distribution archive. DR is copyrighted material by the author, Victor Magdic. All rights are reserved. The author grants you a licence to use this software free of charge. The program is provided "as is", without warranty or guarantee of any kind, either expressed or implied, as to its quality or performance. The author will not be held liable to you or anyone for any direct, indirect, incidental or consequential damages. The author is in no way obligated to provide future versions of this software. Your use of the program constitutes your agreement to these terms and to this disclaimer. Suggestions always welcome! --------------------------- If you have any suggestions for improvement or wish to report any bugs, you can reach me via netmail: Victor Magdic ( Magical Systems Software / TDZware ) FidoNet: 1:259/427 TeleNet Canada: 20:22/104 ------------------------------------------------------------------ end