Directory lister / File finder / File viewer
With Hebrew support !
Version 2.71 / 1 Aug, 95
Software and documentation are: Copyright (C) 1995, Oren Souroujon
DISCLAIMER OF WARRANTY
USERS OF THIS SOFTWARE MUST ACCEPT THIS DISCLAIMER OF WARRANTY:
1. THIS PROGRAM AND DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT
WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES
WHETHER EXPRESSED OR IMPLIED.
2. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH
THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR
PURPOSE IS OFFERED.
3. GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY
TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
4. THE USER MUST ASSUME THE ENTIRE RISK OF USING THIS PROGRAM.
THE AUTHOR WILL NOT TAKE ANY RESPONSIBILITY FOR ANY KIND OF DAMAGE,
DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PROGRAM,
OR THE INFORMATION SUPPLIED IN THE DOCUMENTATION.
TABLE OF CONTENTS:
1. Program description
6. Program use and options:
C. Command line options
D. The detailed display
1) Files' attributes
2) Scrolling of the screen
3) Changing the sort order
4) Changing drives
5) Hebrew filename support
6) Subdirectory browsing
7) Archive directory viewing
8) File viewer
9) Online help
E. Display colors
H. Exit codes
Appendix A: Version notes and additions
Appendix B: Contacting the author
1. PROGRAM DESCRIPTION:
Deluxe Dir (DDIR) started as an experimental Pascal program which
turned out to be quite a useful utility. It now serves as a directory
lister which can be used as a replacement for the DIR command, as a file
finder and as a file viewer (reader). Its main advantage is that it lists
long directories in three columns of text instead of the one column used
by the 'dir' command, yet showing the file sizes, which are usually quite
important and are not shown by the 'dir /w' command.
In addition, DDIR contains many features such as: highlighting all
the executable and compressed files, sorting the files by name, extension,
size or date, moving all the subdirectory files to the beginning of the
directory, ignoring the period-directory files, showing all the hidden
and system files, showing Hebrew filenames in Hebrew characters and
interpreting wildcards more efficiently.
DDIR has a detailed display which allows interactive browsing through
sub-directories, viewing of archive file directories, file viewing and
more. DDIR can also create report files such as a list of all files of
a selected drive, sorted by size.
A. A CGA or better graphics adapter
B. An 80286 or better CPU
C. A hard disk
D. MS-DOS Ver. 3.1 or later
* Directory is listed in three columns separated by two vertical lines.
* Executable files are highlighted.
* Compressed archive files appear in a different color.
* Hidden and system files are shown along with the regular files.
* The directory can be sorted primarily by filename, extension, size
or date, and the files are displayed in vertical order.
* Hebrew filenames can be shown in Hebrew characters !
* Subdirectory sizes can be scanned for and displayed !
* Wildcards are handled better than in the DIR command.
* The following info is displayed when available:
- The volume name
- The volume serial number
- The path being shown
- The selected wildcards
- The number of files in the subdirectory
- The size of the subdirectory
- The number of bytes free
- The current time, date and day of the week
* DDIR can be used as a file-finder that:
- sorts filenames
- searches inside: ARC/ARJ/DWC/HAP/HYP/ICE/LBR/LHA
* DDIR contains a file viewer with Hebrew support !
* File sizes may be shown in kilobytes.
* The '.' and '..' subdirectory files are ignored.
* The subdirectory files are pushed to the beginning or end of the list.
* The file sizes contain optional commas.
* Zero length files are made to blink for easy detection.
* DDIR contains an interactive detailed display option that allows
browsing through subdirectories, and shows:
- File attributes
- File dates & times
- Directories of archive files
- The size of the drive being listed
- The actual total size of the files on the list
- The total wasted/conserved space of the list
* Output can be redirected to a file or to the printer.
* Contains a built-in screen-saver !
What DDIR does NOT do:
DDIR doesn't support any routines which write to the devices it reads
from, and that is because it was developed to be a SAFE program.
For this reason, DDIR does not have copying, deleting, renaming or
attribute changing options at all.
In order to ensure that the file has not been altered, I'm including the
info that would be provided by McAfee's VALIDATE Ver. 2.00 program:
DDIR EXE 34320 08-01-95 0:00a 3526 6EC7
DDIR.EXE is the only file needed for the operation of DDIR. However,
In order for DDIR to be able to run from any path, one of two methods
must be used:
A. The PATH method:
1. Copying DDIR.EXE to a subdirectory on the hard disk.
For example, if the source is drive a: and the target is the
'utils' subdirectory, type the following line from the DOS prompt:
'copy a:ddir.exe c:\utils'
2. Including the subdirectory in the PATH environment variable.
For example, include the following line in your AUTOEXEC.BAT:
B. The ALIAS method (recommended):
1. Copying DDIR.EXE to a subdirectory on the hard disk. (as above)
2. Running an alias program like DOSKEY, giving DDIR a very short
alias like '-'. (The alias could also include default command
For example, include the following line in your AUTOEXEC.BAT:
'c:\dos\doskey -=c:\utils\ddir.exe /e $*'
6. PROGRAM USE AND OPTIONS:
The command line syntax for DDIR is:
>ddir [/opt] [/opt] [path][wildcards] [/opt] [/opt]
(In case the alias method is being used, use '-' instead of 'ddir',
or whichever alias has been installed.)
DDIR's default wildcards are the same as DOS's default
wildcards (they are *.* , and in this program they are equal to *).
The acceptable wildcards are asterisks and question marks. Asterisks
represent (as usual) a sequence of zero or more letters, but question
marks stand for EXACTLY one character (which is different from DOS's).
Both commands will show all EXE files.
>ddir *a.* /x
The command will NOT show all files whose filename ends with an 'A'.
DDIR also accepts multiple wildcards. Each set of wildcards must be
separated from then next by a semicolon, without any spaces between them.
Up to ten different sets are allowed.
This command will show BOTH *.obj and *.tpu files.
This command will show all files in the subdirectory 'demo' which
1. Have a three letter word filename,
2. Contain the word 'hello',
3. Start with the letters 'abc'.
C. Command line parameters:
All of the parameters of DDIR are optional, and when a parameter is not
specified, DDIR automatically chooses its default option. All the parameters
must be preceded by a slash or a hyphen, and separated by spaces. Each time
a parameter is specified, it inverts the last state of the option it stands
for. Therefore, a parameter has to be specified an odd number of times in
order to be effective. (All sort options override any other sort options
specified earlier. Only the last sort option specified will take effect)
The default drive and path for DDIR are the current drive and the current
These are the parameters that represent the options of DDIR:
/A - Shows the actual size occupied by files. The actual size a file
occupies on a drive is affected by the cluster size of the drive.
When this option is active, DDIR calculates file sizes by
multiplying the cluster size by the number of clusters they
/B - This mode was made for finding programs on new disks.
It will show only the executable files and directories on the
(*bat, *com, and *exe)
/C - This option allows the omission of commas in the file sizes and
the bottom statistics. It is mainly made for slow computer users
who need faster speed.
/D - Detailed Display. As this option contains many features, it is
described separately in the next section.
/E - Sorts the files primarily by their extension. Please note that the
default option sorts the files primarily by name, but sorts their
extension too. This option sorts files of the same extension by
/F - File finder. When this option is enabled, DDIR displays files in
subdirectories of the chosen path, thus allowing to search for
all files matching specified wildcards.
Using this option forces the /S option and the detailed display
in order to have room for the path display.
'ddir /f /m c:\pictures\*gif;*jpg;*pcx'
will show all GIF, JPG, and PCX files on drive C's subdirectory
'pictures' and all the subdirectories below it, sorted by
date of modification.
/G - Like the /F option described above, but will also search inside
the following archive files:
1. ARC 7. LBR * 13. RAR
2. ARJ 8. LHA 14. SQZ *
3. DWC * 9. LZH 15. ZIP
4. HAP * 10. LZS 16. ZOO
5. HYP 11. PAK
6. ICE 12. PKA
1. Files found inside archives cannot be viewed.
2. The archives with the asterisk contain non-MS-DOS dates
& times, which are not supported by this program.
3. This option forces the /F option.
/H - This option was made for Israeli users who use Einstein
HebrewWriter, Qtext, IriWord, Wordmill, Alef-Bet or any other
program that makes pseudo Hebrew filenames using the same methods
as the programs mentioned above. When this switch is active, the
program will translate these characters to Hebrew characters.
1. DDIR will attempt to show the regular files in English, but
in some cases it may display English filenames in Hebrew
characters. This happens because the program analyses these
files only according to their names.
2. Hebrew characters can be seen only on PC's with a Hebrew
ROM BIOS installed on their graphics adapters, or with a
Hebrew software font installed in their memory.
/I - Allows redirection to a device. The device may be a file, a
printer, or any other device that can be accessed by DOS.
Redirection is done by the usual DOS rules.
'ddir /i > test.txt'
will redirect output to a file called test.txt.
'ddir /i > PRN'
will redirect output to a printer.
Redirection is an operation which WRITES to a device, and can
can cause loss of data when used incorrectly. For instance,
if the program redirects to an existing filename, the file is
overwritten. Being an external DOS service, this operation
cannot be controlled by the program and therefore it should
be used with care !
The redirection switch can also be used for creating reports on
certain drives or directories.
'ddir c:\ -f -i -z > hardisk.rpt'
will create a report file named 'hardisk.rpt' containing all
files on the C: drive sorted by size.
/J - This option forces current time and date display instead of
the "help" message on the corner of the screen, in case no other
option has been specified. When used in conjunction with other
options, this option is bypassed.
/K - Shows the file sizes in kilobytes instead of bytes. (The size in
bytes is always rounded upwards). This option helps figure out the
proportions between sizes of files.
/L - Displays files in capital letters, just like the DIR command
/M - Sorts files by their modification date, from newest to oldest.
/N - Shows only pathnames (bare format). This option will show
only the pathname of each matching file in a separate line.
The /i option will be turned on automatically, so the output
can be redirected into a list-file, and used by other programs.
/O - Skips sorting of files and shows them by the original DOS order.
This option is needed only when greater speed is desired, or when
the actual order of the files of a certain directory needs to be
shown. When this option is selected, all the other sorting options
/P - Pushes subdirectory files to the end of the list: Sometimes it is
more convenient to see the directories while typing a command, by
moving them to the end of a long list of files. This option is
active only when sorting is active.
/Q - Quiet mode: makes no sound effects during errors, or the help
/R - Reverses the order of sort to descending sort.
/S - Scans subdirectories recursively in order to display their sizes.
This also affects the bottom statistics. This is very effective
for showing how much disk space is being used by the larger
directories. All subdirectory files are shown and analyzed when
using wildcards with this option.
'ddir c:\ /s /z'
will show all subdirectories on the root directory of drive C,
sorted by their size.
'ddir c:\ -s *txt'
will show the total size of all TXT files in each subdirectory.
/T - This option enables a text mode change at the beginning and end
of program execution. Use it only if the screen becomes garbled,
or when blinking characters appear strangely.
/U - Shows only user files. (Ignores hidden and system files.) This
option was added in order to protect areas with hidden files
and directories from being exposed to unwanted personnel. It
could also be used for beginner users who would like to get
a minimal display of their directories.
/V - Enables snow checking for old video adapters: Some old CGA's and
other graphics adapters produce an effect called "snow" when
characters are output directly to the screen. If such a "snowing"
effect occurs, this option should be specified to prevent it.
/W - Swaps the position of the day and the month in the detailed
option's file dates and the current date display for country
compatibility. The month is displayed by letters.
/X - Excludes files matching the specified wildcards.
'ddir /x *.tmp'
will show all files EXCEPT those with a TMP extension.
Note: Using this option requires a specification of wildcards.
/Z - Sorts files by their size from large to small.
/? - This option shows a title screen and a summary of the allowed
options. It overrides any other options specified.
/1 - This option is similar to the /? option, but will skip the
/2 - This option will generate a pause after the program finishes to
run. It was made in order to be able to use the program in
an OS/2 session, or any other environment that would mistakenly
clear the last screen. Whenever this switch is active, the program
"remembers" the screen that was active before execution, and
restores that screen at the end of execution.
D. The Detailed Display:
The detailed display shows the files in one column, thus allowing to
add display of files' attributes and dates and the size of the drive
being listed. The first file in the list will be highlighted in a blue
bar, which will be referred to as the selection bar.
1) Files' attributes will be shown using these abbreviations:
D . . . . - Directory
. H . . . - Hidden
. . R . . - Read-only
. . . S . - System
. . . . A - Archive
2) Scrolling of the screen is performed by the following keys: - Scroll one page up.
- Scroll one page down.
- Scroll one line up.
- Scroll one line down.
- Jumps to the beginning of the list.
- Jumps to the end of the list.
3) Changing the sort order:
While in the detailed display, the file sort order can be changed
interactively by the following keys:
F5 - Sort by file name
F6 - Sort by file extension
F7 - Sort by file size
F8 - Sort by file date
F9 - Reverse the sort direction
An indicator at the buttom right of the screen will show the
active sort order whenever sort has been performed.
4) Changing drives:
When the detailed display is active, the path can be changed to the
current path of a certain drive, by pressing the key and the
drive letter simultaneously. DDIR will then show the new directory,
according to all the other options specified at the command line.
This feature can also be used for viewing multiple floppy disks, by
repeating the same -drive combination after exchanging disks.
5) Hebrew filename support:
Pressing F3 will toggle the Hebrew filename display. An indicator
at the buttom left will show whether Hebrew support is active.
6) Subdirectory browsing:
The files of a certain subdirectory in the list can be viewed by
moving the selection bar towards it and pressing . In order
to return to the parent subdirectory, press or <->.
7) Archive directory viewing:
The directory of several archive file types can be viewed by moving
the selection bar towards them and pressing . In order to
return to the current subdirectory, press or <->.
When DDIR does not recognize a file as an archive file, it will
automatically treat it as a normal file, and activate the file viewer.
While viewing an archive directory, the compressed size of every file
is shown next to its original size. The percent ratio between the
compressed file size and the original file size is shown in
parentheses to the right of the compressed size.
8) File Viewer:
While in the detailed display, files can be selected for viewing.
This is done by moving the selection bar to the desired filename
and pressing .
Plase note: Zero-length files, subdirectory files, and files inside
archives cannot be viewed at all.
The file viewer display has a title, showing the pathname of the file
being viewed, three indicators and a scroll bar. The scroll bar shows
which part of the file is currently being displayed, and it will not
appear at all if the file is smaller than one screen page.
The three indicators are described below:
1. The 'Filter' indicator, which informs whether the text filter is
active. The filter can be toggled by pressing . When active,
the filter will show only alpha-numeric characters on the screen,
and any other characters will be converted to spaces.
2. The 'Hebrew' indicator, which informs whether Hebrew screen
direction mode is active. This mode can be toggled by the
key. When active, the screen display will be flipped horizontally
to allow reading Hebrew documents which were saved in a reversed
While the Hebrew direction mode is active, some high ASCII
characters will be converted to Hebrew characters, just like in
the /H option. This will allow even more Hebrew support (for
instance, it enables reading Hebrew Word documents.)
3. The 'Reading ...' indicator, which tells when the program is
reading a file. While this indicator is active, the user should
wait until the program turns it off.
While in the file viewer, scrolling of the screen is performed
by the following keys:
- Scroll one page up.
- Scroll one page down.
- Scroll two columns to the right.
- Scroll two columns to the left.
- Jumps to the beginning of the file.
- Jumps to the end of the file.
Pressing , or <-> will exit the file viewer and
return to the detailed display mode.
9) Online help:
While in the detailed display or the file viewer, pressing will
display an online help screen, showing the valid keys that can be
used in each mode.
The only ways to exit the detailed display are pressing or aborting
the program, like described in the section F.
E. Display Colors:
DDIR uses the color display for showing different types of files. It
recognizes the files only by their extension, attributes and location,
and not by their content.
DDIR uses the following colors:
Executables - White
Archive files - Light Magenta
Files inside archives - Magenta
Subdirectory files - Light Cyan
Any other files - Cyan
Zero-length files - Blink
DDIR can be interrupted almost any time by pressing the -
combination or the - combination.
Whenever the program is left running for about 3 minutes without any
key being pressed, it will automatically run a screen-saver, which will
protect the screen from "burning". Any key pressed while the program is
in that mode will restore the screen that was previously displayed,
and the program will continue as usual.
H. Exit codes:
DDIR uses the following exit codes:
100 or more - if a run-time error occurs (not supposed to happen at all)
3 - when a standard error occurs
2 - when DDIR has been interrupted
1 - when help has been requested
0 - otherwise
* I would like to thank the following people:
for using this program addictively since it was created,
and for thoroughly beta-testing its earlier versions.
for beta-testing and giving me original advice for the
developement of this program.
* Any suggestions or comments about the program will be gratefully
(Please include the version number when reporting bugs etc.)
* If you are pleased with this program, please:
A. Send me a minimal donation of $10 to the address below,
B. E-mail me a note,
C. Send me a postcard.
I would very much like to know where this program gets to !
* The programmer disclaims responsibility for any damage caused by this
program, though the program does not write on or change the contents of
any device it reads from (except when redirecting, and that's an
external DOS service), and does not stay resident in memory.
* This program may be distributed as long as its contents are not
changed and no fee is charged. (The ZIP form is more recommended
* Version updates of this program are most likely to appear in the
SimTel Software Repository sites:
The Internet FTP site of SimTel is: ftp.coast.net
The primary mirror FTP site of SimTel is: oak.oakland.edu
Or in the Garbo Archives FTP site: garbo.uwasa.fi
APP. A: VERSION NOTES AND ADDITIONS:
2.71: * Added file finder support for DWC/HAP/HYP/LBR/RAR/SQZ
and for the compatible LZS/ICE/LHA/PKA
* Added a 'bare format' option
* Added immediate sort in the detailed display
* Added Alef-Bet Hebrew support
* Added online help for detailed display and file viewer
* Improved colors
* Fixed bugs concerning:
- linefeed in file viewer,
- totals with /g,
- the switch character '-' which is legal in filenames.
2.70: * File finder searches inside ARC/ARJ/LZH/PAK/ZIP/ZOO files
* Multiple wildcards are supported
* Viewer supports binary files
* Improved viewer's vertical scroll, and a partial horizontal
* Improved Hebrew support for viewer
* Shows Volume Serial Number
* Shows active DOS version number
* Shows percent of used drive space
* Shows the current day of the week
* Doesn't erase the screen before abortion with Ctrl-Break
* Title statistics are shown immediately after they've been read
* Search path is displayed while being scanned
* Rewritten 'file_id.diz' more according to standards
* Handles run-time errors better
* Fixed bugs concerning:
- fileview with /a
- invalid dates
- Hebrew Einstein filenames
2.60: * Added a file-finder option
* Added a text file viewer
* Handles up to 5000 files instead of 1800
* Added subdirectory browsing
* Actual space occupation display has been added
* Wasted space display in the detailed screen added
* Better long path display
* Better display of file sizes larger than 1 MB
* Backwards scroll during regular display
* Statistics are shown in all pages of the regular display
* Subdirectory files are highlighted
* AIN, ARI, ARX, AMG, CRU, HA, HPK, LIM, MD, PUT, Q and SAR are
recognized as compressed extensions.
* Program can be aborted with Ctrl-C or Ctrl-Break
* Time & date are displayed in a redirected detailed output
2.52: * HYP, LHA, LZS, UC2, HAP and RAR files are recognized as compressed
* A screen-saver was installed
* Ctrl-Drive bug in the detailed option was fixed
* Other display bugs were fixed
* All the subdirectory files are evaluated when using wildcards
with the /S option
* The screen can be restored from the detailed display too
* Drives in the detailed display are changed by the key,
not the key
2.51: * Allows redirection
* Improved wildcard parsing routine
* Improved error handling
* Better help screens
* Added OS/2 pause which can also restore the screen
* Added Wordmill Hebrew support
* DWC, LBR, and ICE files are recognized as compressed
* Skipping the text mode change became a default option
* Sort by size has been reversed to large first by default
* Added /F and /J switches
* Current date and time are displayed
* A small time display bug was fixed
2.50: * Wildcards are entered as part of the path,
just like in the DIR command
* Subdirectories are scanned for sizes
* Added Hebrew support for Qtext and IriWord files
* Added /U and /Q switches
* Color added to the detailed display
* Added sort by date
* PKA files and multiple volume ARJ files are
recognized as compressed files
* Attributes of directory files are shown in the detailed display
* Better error display
* Hyphens can be used as option prefixes
* Last drive has been changed from E: to Z:
* Small letter display became a default option
2.43: * Improves comma additions for large file sizes
* Improves coloring
* Highlights compressed archives
* Fixes a bug in wildcard parsing
* Improves Ctrl-C / Break detection
2.42: * Allows using both /L and /H
* Speeds up the /L routine
* Has a better help screen
* Improves parameter parsing method
* Has a wider display
* Better error handling
* Different drives can be viewed by a CTRL-key command
2.41: Improves the detailed option:
* Displays files' month in letters
* Adds page-leap scroll
* Fixes display bugs in version 2.40
2.40: * Introduces its own wildcard parsing routine,
instead of DOS's routine, which doesn't work correctly
* Adds title containing path and wildcard selection
* Displays subdirectory filenames' extensions in parentheses
2.31: * Improves Hebrew display
* Blinks zero length files
* Adds an option for lower case characters
* No longer highlights .COM .BAT and .EXE files which are also
system files, as they are not executable from the command line
2.30: * Adds sort by size
* Adds descending sort
* Improved display
* Adds abortion with
* Fixes a bug when a color graphics adapter is not present
* Stricter parameter checking
2.24: * Adds time display
* Allows swapping the day and month position of the dates
(all in the detailed option)
2.23: * Allows canceling of program text mode changes
2.22: * Returns to original text mode
* Allows snow checking
2.21: * Adds an option to omit commas
* Fixes some bugs which occurred only in Ver. 2.20
2.20: * Improved screen usage in small directories
* Adds extension sort
* Allows skipping sort
* Adds an option for pushing subdirectory files to the end of the
* Adds commas to file sizes
2.12: * Improved path and current path handling
2.11: * Fixes a little bug with empty disks which have no volume label
* Improves error messages
2.10: * Adds Hebrew support to Einstein HebrewWriter style filenames
2.00: * Sorts filenames and enhances executable ones
APP. B: CONTACTING THE AUTHOR:
38 Hanasi Harishon St.
I S R A E L
E-Mail Internet address:
Oren Souroujon < [email protected] >