*** DDIR 9.5 *** Directory lister,
flags system, hidden and read-only
files; highlights new files; shows DOS
file size, true file size and file
"dead space". Full sort/resort.
Delete/copy files, interface to text
and graphics file viewers and
user-defined function.

DDIR

Version 9.5



Note: this package contains the following files, zipped with PKZIP 2.04g:

DDIR.EXE
DD95FG.COM
DDIR95.DOC
UPGRADE.TXT
FILE_ID.DIZ
DISTRIB.DOC



DDIR


Purpose: gives a forward/backward scrollable double-column directory display.
Protected files are flagged with a "+", system files with a "$",
hidden files with a "*". Files created today are shown in a
different color.

Toggles w, x, y and z allow rapid on-screen display of file size
in different ways - the file size reported by DOS, the total space
ACTUALLY required to store the file, the dead space "wasted" by the
file, and the file "storage efficiency" which is simply the ratio
of file size to space actually required for storing the file.
(Depending on your DOS version and/or hard drive type, a certain
minimum amount of space is required for all files. For example, a
10 byte batch file may actually use 512 bytes on a floppy disk and
32kb of your network drive! The dead space is the amount of disk
space wasted by a file.)

DDIR allows to mark files for deletion, and delete them and re-list.
You can view files using the author's VIEW utility and Vernon Buerg's
LIST utility. There is also a link to a graphics viewer. I recommend
Bob Montgomery's excellent VPIC.

You can also change directories from within the file list and exit
either to the starting drive/directory or to the currently displayed
drive/directory.

DDIR reports as a summary total file size, total space actually
for the file(s) specified. TAKE A LOOK AT THE STORAGE EFFICIENCY FOR
THOSE SMALL BATCH FILES!!

DDIR allows you to sort directory listings alphabetically,
by size, extension, age, attribute or storage efficiency, and to
instantly (well, almost!) resort or reverse the sort order.
For lists that require more than one screen, you can also scroll
back and forth.

You can toggle write-protect on and off for files (i.e. make them
read-only or read-and-write).

You can copy files from the current list to another location.

Please note that DDIR reports the count of files and
subdirectories separately, unlike the DOS dir command.




USAGE


Notes: Use the same way as the DOS dir command. Wild-card characters are
allowed.

Usage: ddir [d:][path][file.ext]

Examples: directory of current drive and directory ddir
list of .COM files on drive a - ddir a:*.com
list of files of directory "one', drive c - ddir c:\one


Keys:

F1 - help screen

Esc - exit to home drive and directory
q - exit to currently displayed drive and directory.

t - mark/unmark files for deletion
Del - delete any marked files and re-list.

Tab - change bottom display (file count summary or quick help)

a - sort by file attribute (system, hidden, directory etc.)
b - back up highlighted file
c - toggle upper/lower case display
d - sort by file date
e - sort by extension
f - sort by file "storage efficiency"
g - view graphics file with viewer VPIC
l - view highlighted file with LIST (by Vernon Buerg)
n - sort by file name
p - print directory listing
r - reverse sort order
s - sort by size
v - view highlighted file with VIEW (for WordPerfect 5.0-6.0,
DOS Word 4-5.5, WinWord 1-2, Win Write, Ami Pro, ASCII, Wordstar)
w - show file "wasted space"
x - show file total space
y - show DOS file size, wasted space and individual storage efficiency
z - show file size reported by DOS

+ - toggle file protect/unprotect (i.e. read-only or read and write)

u - interface to user-defined batch file DDIRCUST.BAT. When you press u
the directory listing is copied to a file called DDIRUSER.FIL. You can
process this file via DDIRUSER.BAT. The recommended use is to print
the directory list in two columns, compressed print, using Tony
Caine's excellent 2COL or JETCOL programs. For example, to use JETCOL
the DDIRCUST.BAT might look like:

c:\jetcol\jetcol ddiruser.fil

When processing is completed the DDIR display is restored and
DDIRUSER.FIL is deleted.

Up arrow - scroll up one file
Down arrow - scroll down one file
PgDn - next screen
PgUp - previous screen
Home - go to beginning of list
End - go to end of list

Right arrow - move down current screen list to select "active" file
Left arrow - move up current screen list to select "active" file
Enter - change to highlighted directory


IMPORTANT NOTES

- To use v or l you must have the VIEW or LIST utilities in a directory
referenced in your AUTOEXEC.BAT PATH statement).

- To use g you must have a graphics file viewer called VPIC in your
path. If you use a different viewer, you should make a copy of
the executable file and call it vpic.exe (or vpic.com if it is
a COM file).

- When you press the right or left arrow keys, the up and down arrow
keys are disabled. To re-enable, press Spacebar, PgUp, PgDn, Home
or End


**** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****

DDIR is an EXE file. If you are upgrading from an earlier COM
version, be sure to delete DDIR.COM.

**** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


CUSTOMIZING DDIR WITH DD95FG.COM


Usage: dd95cfg [filename]
where filename is ddir.exe or a copy of ddir.exe
given some other .exe name (e.g. dd95.exe)

If you omit the filename, dd95cfg will assume you want to configure
ddir.exe.


What can you configure? (quick summary)

- the display color for the file list (old files)
- the display color for new files
- the display color for files marked for deletion
- the display color for scrolling through the file list
- the date and time format (date: US, UK or International; date: 12 or
24 hour clock)
- the way in which DDIR sorts the file list when you first run it
- the display speed (normal e.g. for CGA, 8088; fast e.g. for EGA/VGA,
80286 or better)
- whether or not DDIR automatically detects the number of display lines


NOTE: the customization now allows you to save your settings to a file
DDIR9CFG.SAV. You can have different versions of this file in different
directories if you wish; DDIR will use the settings it finds in the directory
it is run from, if a SAV file exists there. otherwise it will use its
customized default settings. You can also reconfigure the default
customization for DDIR from any SAV file you have previously created. This
feature will be maintained, if possible, in any future upgrades of DDIR,
so that you will be able to reconfigure future versions automatically using
the preferences you have established now.

The display colors, the date and time format and the default display (upper
or lower case) can be set automatically using the accompanying configuration
program DD95CFG.BEFORE CUSTOMIZING, MAKE SURE YOU HAVE BACKED UP THE ORIGINAL
DDIR.EXE TO A SAFE PLACE! Then from the directory where you have ddir.exe
simply type dd95cfg or dd95cfg ddir.exe (where ddir.exe can be replaced
with a copy of ddir.exe renamed to some other executable e.g. dd95.exe).
Follow instructions. If you choose to reconfigure ddir.exe (or the copy)
directly, a modified file called DDIRN.EXE, using your selected
customizations, will be created. Test this before using the DOS COPY
command to copy it to ddir.exe.

You can also just create a new DDIR9CFG.SAV configuration file, or reconfigure
ddir.exe from an existing DDIR9CFG.SAV file (including those created from
earlier versions).

If you choose to modify the executable, rather than just create a new
configuration file, DD95CFG will try to open the file you specify on the
command line, or, if none is given, will try to open DDIR.EXE.

The first set of customizations are for the display colors. You can then set
the mode of date display (e.g. dd.mm.yy, mm-dd-yy etc.) and the default sort
method when DDIR is run.

DDIR can, if your display adapter is appropriate, use fast screen display.
Unless you are using a CGA adapter or VGA in a slow computer, you should
be able to use this mode. However, because some adapters are non-standard
it is possible that running in fast display mode would lock your system.
DDIR therefore ships with the default normal display speed. You can modify
this through DD95CFG. If doing so causes no problems stay with it; if a
problem does arise, re-run DD95CFG and select normal display speed.

Some non-standard BIOSes do not correctly return the number of lines being
used on the display screen (25 on CGA; up to 60 on VGA displays). Although
DDIR tries to detect abnormal results, you can, as an added precaution, force
it to use only 25 lines. Normally, select "let DDIR choose", and force it
to 25 lines only if there is a problem with the display. IMPORTANT: If you
have selected "normal display speed" DDIR will run in 25 line mode ONLY.





THE LEGAL STUFF


The author makes no warranty that the software in this package
will work with your particular hardware configuration. You use the
programs entirely at your own risk, and the author will not be held
liable for any damage caused to your hardware or software through
use of this software, or for any other effects, direct or indirect,
of using the software.

Legalities aside, you should not run into difficulties with this
software.



SHAREWARE



These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.
(Editorial note: I don't support "crippleware" - I want to know
EXACTLY what I'm expected to pay for! Crippleware is, in my opinion,
like test driving a Mercedes that's been fitted with a two-stroke engine!
There, that's said - but each to his own.)

You do not have to register as a user, nor are you under any
obligation to buy the program(s). However, they are not free, and in
the spirit of shareware, you are requested to make a small
donation to the author if you find the software in this package useful,
and if you continue to use it after an evaluation period of 30 days. This
would both fulfil your moral obligation and help ensure the viability of
the shareware concept, from which we all benefit. If you choose not to pay,
you are asked to remove the program files from your computer.

The suggested contribution is $15 but less (or more!) would be fine. Pay what
you think the software is worth to you. If you pay the recommended amount PLUS
ADD $4 for shipping and handling, I will send you a 5 1/4" diskette with the
latest version plus a selection of other shareware (my own and the best from
other authors, including 2COL/JETCOL by Tony Caine). Alternatively, send a
blank diskette of your preferred size (5 1/4" 360kb or 1.2Mb, or 3 1/2" 720kb
or 1.4 Mb) plus $3 s&h.

Should you decide to make a contribution, please remit to:

Malcolm Drury
11 Adele Crescent
Nepean
ON K2J 2T7
Canada

Internet [email protected]
Compuserve 70574,3457

Bank notes would be fine! Thank you. Please tell me where you
got the software from (this helps me in knowing where to post updates), and,
most importantly, which version it is.


IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION - THANKS, AND
OF COURSE YOU ARE NOT EXPECTED TO PAY AGAIN. YOUR INPUT, COMMENTS
ETC. ARE ALWAYS WELCOME.

Please note that at the low contribution requested, I cannot provide direct
technical support, nor automatically send upgrades, should they
become available. If you have comments, questions, bug reports etc., please
leave a message at my Compuserve or INTERNET address, or write to me via
snail mail. I will endeavor to fix any problems you might encounter.

The software is supplied on an "as is" basis. You are free to distribute
this software package provided that you distribute the ENTIRE package,
including this documentation file. (This is necessary for others to be able
to use it properly. I've downloaded too many shareware packages that had
been posted without accompanying documentation!).

I hope you find this package useful.


Malcolm Drury
January 1st, 1994


HOW TO OBTAIN VIEW


VIEW is available on many BBS and on Compuserve/Ziffnet (VWFILE.ZIP
in ZNT:TIPS). If you wish to obtain a copy directly from me, please add $15
to your contribution. Alternatively, get it from your BBS and "try before you
buy" just as you are doing with DDIR. From your favorite BBS just do a search
on "VIEW??.*" As of this date the current version is 8.7.

********************************************************************************

Look for the following shareware on this BBS

VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
than 260,000 colors! (And see how many you can actually discern!).
One palette can be used to create a small (2k) TSR program that
maintains your chosen scheme. Alternatively, you can set any of
the palettes, or a grey-scale scheme, from a non-TSR if
memory or loading a TSR is a problem. (On Compuserve/Ziffnet
in ZNT:TIPS as vgacus.zip)
BBS search: vgapal??.zip


DSPACE63.ZIP - shows graphically hard disk space installed, used and free,
for all drives, and shows drive type (local, remote, RAM etc.);
second program shows graphically space on designated drive
(including floppy), and reports on installed and available
RAM, including XMS and EMS memory. (On Compuserve/Ziffnet
in ZNT:TIPS as dskspc.zip)
BBS search: dspace??.zip

VIEW87.ZIP - file viewer for WordPerfect 5.0 - 6.0, ASCII, Ami Pro and
Word (DOS 4/5 and Windows 1/2); includes text search,
printing full or partial file, etc. (On Compuserve as
VWFILE.ZIP in ZNT:TIPS). BBS search: view???.zip.

IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE! I'LL BE HAPPY TO SEND
THEM TO YOU, BUT IN THE INTERESTS OF CUTTING DOWN CONNECT TIME WOULD
PREFER TO USE INTERNET. THAT WOULD REQUIRE YOU TO HAVE THE UUDECODE.EXE
PROGRAM, WHICH SHOULD BE AVAILABLE ON ANY BBS YOU USE.

CIS 70574,3457
INTERNET [email protected]