								  ======== ======   =======
									  ==	  ==	 ==	  ===
									  ==	  ==	 ===	 ===
									  ==	  ==	 ==	===
									  ==	  ======   =======

											  [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
