home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR4
/
THEDIR.ZIP
/
THEDIR.DOC
< prev
next >
Wrap
Text File
|
1994-01-31
|
8KB
|
248 lines
═══════════════════════════════════════════════════════════════════════════════
TheDir Version 1.00 By Gil Gomes DXP Computer Services LTD
═══════════════════════════════════════════════════════════════════════════════
This ZIPPED Archive should include...
THEDIR.EXE ---------------------- The Executable program itself
THEDIR.CFG ---------------------- The Default Configuration file.
THEDIR.DOC ---------------------- This Documentation.
D.BAT ---------------------- Sample Batch file.
DD.BAT ---------------------- Sample Batch for date sort.
DDN.BAT ---------------------- Sample Batch for date sort, two column.
DE.BAT ---------------------- Sample Batch for extension sort.
DEN.BAT ---------------------- Sample Batch for extension sort, two column.
DS.BAT ---------------------- Sample Batch for size sort.
DSN.BAT ---------------------- Sample Batch for size sort, two column.
═══════════════════════════════════════════════════════════════════════════════
*** I M P O R T A N T *** P L E A S E R E A D T H E F O L L O W I N G
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
In order for this program to work properly, THEDIR.EXE has only to
be in your path. THEDIR.CFG, however, can be anywhere you wish to place it.
BUT...
You must first have this statement in your AUTOEXEC.BAT file, or
type it at the command line, before using TheDir...
SET THEDIR=DRIVE:\DIRECTORY\
Example SET THEDIR=C:\THEDIR\CONFIG\
*** NOTE *** That there are no spaces in the string, and that the final
character is a backslash.
When you type SET from the DOS prompt, there should be a line
that shows in the DOS environment display that includes SET THEDIR= followed
by the location of your configuration file.
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
═══════════════════════════════════════════════════════════════════════════════
The Dir is a utility that displays a wide directory listing that
can be color coded, by extension, to the user's taste. It can be configured
for two column or three column displays as well. What follows is a brief
over-view of TheDir's capabilities and the rules of the game. Enjoy...
═══════════════════════════════════════════════════════════════════════════════
Command line switches.
═══════════════════════════════════════════════════════════════════════════════
THEDIR
Will display the current directory in three column mode, sorted by
file name.
═══════════════════════════════════════════════════════════════════════════════
THEDIR DRIVE:\SUBDIR\FILENAME.EXT
Will display the filespec that you select on the command line. Any DOS
legal DIR command line, including wildcards will work. Such as THEDIR *.PRG,
or THEDIR D:\QMPRO\*.
═══════════════════════════════════════════════════════════════════════════════
/S /D /E /F *** Line One ***
/N /W *** Line Two ***
These command line switches can be either the first, second or third
command line parameter. The first line of switches are sort switches.
/S === Sort by File Size
/D === Sort by Date and Time
/E === Sort by Extension
/F === Sort by Filename >>>*** Default ***<<<
The second line of switches designate the number of colums with which
to display data to the screen.
/N === Display in Narrow mode (Two Columns)
/W === Display in Wide mode (Three Columns) >>>*** Default ***<<<
If two such switches are used, the first switch MUST be the display
switch. For instance... /S /N
If you were to reverse these switches at the command line, you
would invoke an error message. If there is only one switch at the command
line, then any switch is a legal switch. Just keep in mind that when using
two switches, the sort switch must be the first switch. And, of course, you
cannot specify two sort switches, or two display switches on the same command
line. There are batch files included with the program to show you how this
system works.
═══════════════════════════════════════════════════════════════════════════════
The Configuration File... THEDIR.CFG
═══════════════════════════════════════════════════════════════════════════════
The first line of the configuration file should include the word
YES, if you wish to have lines seperating the files in the display. If you
replace YES with NO, or leave the line totally blank, the lines will not
be displayed. This speeds things up a bit, but isn't quite as attractive.
YES MUST be the first three characters on the first line.
The second user configurable item in the CFG file is the ability
to change the color of the informational headings, such as Current View.
This section will also allow you to modify the color of the Border, the
color of the directory names, the color of the file size column and the
color of the word << DIR >>, that is used to denote a directory. The following
is taken from the default THEDIR.CFG file and is shown as an example.
BORDER: BG+/N
SIZE: GR+/N
DIRECT: BR+/N
HEADER: BG+/N
DATA: GR+/N
<< DIR >>: B+/N
END
The rules are fairly simple. The selections must remain as you see
them here, and as provided in the default THEDIR.CFG file. The ":" must be
directly after the selection. One space must follow the ":". The color
selection itself MUST be provided and follow on the same line, as shown.
Legal Foreground colors are as follows
R ------ RED
GR ----- BROWN
G ------ GREEN
B ------ BLUE
BG ----- CYAN
BR ----- PURPLE
R+ ----- LIGHT PURPLE
GR+ ---- YELLOW
G+ ----- LIGHT GREEN
B+ ----- LIGHT BLUE
BG+ ---- LIGHT CYAN
BR+ ---- LIGHT PURPLE
* ---- BLINKING
Legal Background colors are as follows
R ------ RED
GR ----- BROWN
G ------ GREEN
B ------ BLUE
BG ----- CYAN
BR ----- PURPLE
═══════════════════════════════════════════════════════════════════════════════
The final user configurable color selection is the EXTENSION
configuration.
These lines must consist of 10 characters. Not 9. Not 11. It is
extremely important to remember this when modifying this section. Any one,
two or three character extension is valid. The following is taken from the
default configuration file itself, and is shown here as an example.
EXE=GR+ /N < *** Note that all lines are ten characters long.
COM=G+ /N
BAT=R /GB
BAK=R+* /N
TXT=BG+ /B
DOC=BG+ /N
PRG=W+ /R
ARC=R+ /N < Any spacing that you find easy to understand may be utilized
ZIP=GR+ /B as long as the color values are legitimate.
LZH=W+ /B
DBF=W+ /B
DOC=W+ /R
GIF=GR+ /R
ICO=N /W
INI=B /W
C=B+ /R
ACT=B+ /B
SAV=W+* /B
GR=GR+* /B
═══════════════════════════════════════════════════════════════════════════════
Gil Gomes
DXP Computer Services LTD
23 Wynne Street
Seekonk, MA
02771
DATA (508)336-3868
FAX (508)643-1367
FIDO 1:323/108
We hope you enjoy this utility and feel free to feed us back any
information or critique. The source is available to interested parties
who may wish to enhance or modify the product to their taste.
═══════════════════════════════════════════════════════════════════════════════
This program is public domain and written in Clipper 5.2 with various assists
from Borland's C++, and many Clipper third party tools.
Copyright DXP Computer Services LTD 1994
═══════════════════════════════════════════════════════════════════════════════