home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR13
/
4UTILS76.ZIP
/
4UTILS.DOC
< prev
next >
Wrap
Text File
|
1993-10-31
|
23KB
|
734 lines
31Oct93
4 U U TTTTT I L SSSSS
4 4 U U T I L S
4 4 U U T I L S
4 4 U U T I L SSS
44444 U U T I L S
4 U U T I L S
4 U U T I L S
4 UUUUU T I LLLLL SSSSS
4UTILS - A small 4DOS Utility Collection
Code created using Turbo Pascal 7.0 (c) Borland International 1992
Note: This document has been formatted and is ready for printing.
(60 lines per page, up to 75 characters per line.)
Table of contents:
──────────────────
0. Legal Status, Warranty ............................... 2
1. Distribution Policy .................................. 2
2. Introduction ......................................... 3
3. Getting started ...................................... 4
4. 4DESC - a simple 4DOS-description editor ............. 5
4.1 Command line switches and parameters ................ 5
4.2 Editing and changing descriptions ................... 5
5. 4FF - a simple file finder ......................... 6
5.1 Command line switches and parameters ................ 6
6. Customizing 4DESC and 4FF - the 4UTILS.INI file ...... 8
7. (Re)Compiling 4DESC or 4FF............................11
8. Bugs and Comments.....................................11
9. How to reach the authors..............................12
10. Acknowledgements......................................12
4UTILS - A small 4DOS Utility Collection Page 1
0. Legal Status, Warranty
─────────────────────────────────────────────────────────────────────────
╔══════════════════════════════════════════════════════════════════════╗
║ ║
║ Since 4UTILS is licensed free of charge, the authors, David Frey ║
║ and Tom Bowden, provide absolutely no warranty of any kind, either ║
║ expressed or implied, including, but not limited to, the implied ║
║ warranties of fitness for a particular purpose. ║
║ ║
║ 4UTILS is provided "as is"; the entire risk as to the quality and ║
║ performance of the program is with you. Should the program prove ║
║ defective, you assume the cost of all necessary servicing, repair ║
║ or correction. ║
║ ║
║ In no event will any copyright holder, or any other party who may ║
║ modify and/or redistribute the program as permitted below, be liable ║
║ to you for damages, including any general, special, incidental ║
║ or consequential damages arising out of the use or inability to use ║
║ the program (including but not limited to loss of data or data being ║
║ rendered inaccurate or losses sustained by you or third parties or a ║
║ failure of the program to operate with any other programs), even if ║
║ such holder or other party has been advised of the possibility of ║
║ such damages. ║
║ ║
╚══════════════════════════════════════════════════════════════════════╝
These programs are freeware: you are allowed to use, copy and change them
free of charge, when the following conditions are met:
* 4DESC or 4FF may not be sold or hired.
* Never change copyright statements: the copyright remains in our hands.
* If you make any (considerable) changes to the source code, please let
us know (send us a copy or a listing). We would like to see what you
have done.
1. Distribution Policy
────────────────────────────────────────────────────────────────────────
You can distribute these utilities under the following conditions:
* You ask no contribution from the receiver of this package except
from a nominal copying charge not to exceed US $6. (SFr. 10).
4UTILS - A small 4DOS Utility Collection Page 2
* This archive must be left intact. (repacking allowed). That means the
receiver of this package must receive the following files:
Archive: 4utils76.zip 133525 bytes 24 files
,,rw, 1.1 dos 40144 b- i8:2 31-Oct-93 16:00 4DESC.EXE
,,rw, 1.1 dos 29923 b- i8:3 31-Oct-93 16:00 4DESC.PAS
,,rw, 1.1 dos 1803 b- i4:3 31-Oct-93 18:48 PACKING.LST
,,rw, 1.1 dos 40176 b- i8:2 31-Oct-93 16:00 4DESC86.EXE
,,rw, 1.1 dos 36544 b- i8:2 31-Oct-93 17:00 4FF.EXE
,,rw, 1.1 dos 14585 b- i8:3 31-Oct-93 17:00 4FF.PAS
,,rw, 1.1 dos 1139 b- i4:3 31-Oct-93 17:00 4FF.TXT
,,rw, 1.1 dos 36544 b- i8:2 31-Oct-93 17:00 4FF86.EXE
,,rw, 1.1 dos 22888 b- i8:3 31-Oct-93 16:00 4UTILS.DOC
,,rw, 1.1 dos 2511 b- i4:3 31-Oct-93 16:00 4UTILS.SMP
,,rw, 1.1 dos 1968 b- i4:3 31-Oct-93 16:00 DESC.BTM
,,rw, 1.1 dos 13804 b- i8:3 31-Oct-93 16:00 DESCRIPT.PAS
,,rw, 1.1 dos 11938 b- i8:3 31-Oct-93 16:00 DISPLAYK.PAS
,,rw, 1.1 dos 2995 b- i4:3 31-Oct-93 16:00 DMOUSE.PAS
,,rw, 1.1 dos 331 b- shrk 31-Oct-93 16:00 FILE_ID.DIZ
,,rw, 1.1 dos 5632 b- i8:3 31-Oct-93 17:14 GLOBALS.PAS
,,rw, 1.1 dos 6277 b- i8:3 31-Oct-93 16:00 HANDLEIN.PAS
,,rw, 1.1 dos 9811 b- i8:3 31-Oct-93 17:00 SCANARJF.PAS
,,rw, 1.1 dos 6641 b- i8:3 31-Oct-93 17:00 SCANLZHF.PAS
,,rw, 1.1 dos 9332 b- i8:3 31-Oct-93 17:00 SCANZIPF.PAS
,,rw, 1.1 dos 13327 b- i8:3 31-Oct-93 16:00 STRINGDA.PAS
,,rw, 1.1 dos 993 b- i4:3 31-Oct-93 20:50 TEST286.PAS
,,rw, 1.1 dos 723 b- i4:3 31-Oct-93 16:00 WHATS.NEW
,,rw, 1.1 dos 1042 b- i4:3 31-Oct-93 16:00 4DESC.TXT
24 files, 311071 bytes uncompressed, 131193 bytes compressed: 58%
2. Introduction
─────────────────────────────────────────────────────────────────────────
4UTILS is a small collection of 4DOS *) utilities. I have created
them for my needs and I'm releasing them as freeware.
*) 4DOS is a trademark of JP Software Inc,
PO Box 1470
E. Arlington
MA 02174
USA
I'm a happy (and registered) user of 4DOS and I could not return to plain
COMMAND.COM. In course of time I began to write tools which were aware of
an important 4DOS feature: file descriptions.
These file descriptions are very handy; when I was searching some files
(with `FF read.me' for example) I've often missed them. So I decided to
write a 4DOS aware file finder.
Then, I wrote 4DESC because 4DOS's `describe' is not able of cutting and
pasting. I need this feature, since I'm programming:
The programs and their corresponding source code often get similar
descriptions. Getting bored of retyping similar descriptions I wrote
4DESC.
4UTILS - A small 4DOS Utility Collection Page 3
3. Getting started
─────────────────────────────────────────────────────────────────────────
Installing 4UTILS is simple. Do the following:
(In this example I assume you install the 4UTILS package in C:\4UTILS;
please change the directory name if this does not apply.)
i) create a new directory where 4UTILS should reside,
and change into it:
CDD C:\
MKDIR 4UTILS (or MD 4UTILS)
CD 4UTILS
ii) unzip the contents of 4UTILSx.ZIP:
UNZIP C:\TEMP\4UTILSxy.ZIP
^^^^ ^^^^^^^^ ^
| | |
| | The newest version of 4UTILS, the version
| | number is coded in the last letters,
| | e.g. 4UTILS76.ZIP
| |
| The directory where 4UTILSxy.ZIP resides
|
UNZIP is the unzipper you are using. You can either use UNZIP
from the InfoZip Group (free) or original PKUNZIP.
iii) Append the directory 4UTILS to your path.
ESET PATH
Press <End> and type ';C:\4UTILS'
or
SET path=%path%;C:\4UTILS
iv) Run DESC.BTM to describe your newly extracted files.
v) Adapt (or create) a suitable 4UTILS.INI file, if needed.
(see section `Customizing')
A sample 4UTILS.INI file has been provided, it's name is
4UTILS.SMP.
(It contains the default values 4DESC / 4FF would use.)
4UTILS - A small 4DOS Utility Collection Page 4
4. 4DESC - a simple 4DOS-description editor
─────────────────────────────────────────────────────────────────────────
4.1 Command line switches and parameters
─────────────────────────────────────────
Syntax of 4DESC is : 4DESC [/help] [/mono] [d:][\path]
There are two command line switches:
/help switches directly into the help screen, pressing a key leads
into description edit mode.
/mono 4DESC automatically detects on startup whether you are using a
monochrome or a color monitor. This switch is intended to override
the detection and to switch directly into monochrome mode.
(useful on EGA/VGA displays only).
When supplying a path specification, 4DESC will read the description file
residing in the path you have specified.
4.2 Editing and changing descriptions
──────────────────────────────────────
The following keys have special meanings:
UpArr, DnArr, PgUp, PgDn: Move highlight bar
LtArr, RtArr, Home, End : Move cursor
Ctrl-PgUp, Ctrl-PgDn : Move to first or last line
Ctrl-Left, Ctrl-Right : Move a to previous/next word
Backspace : Delete the character before the cursor
DEL : Delete the character under the cursor
Ctrl-End : Delete from cursor to end of line
INS : Toggle from insert mode (default) to overwrite
mode
Alt-D : Delete current description 1)
Alt-C : Copy current description to buffer 1) 2)
Alt-M, Alt-T : Move current description to buffer 1) 2)
Alt-P : Paste buffer to current description 1)
Alt-V, F3 : View highlighted file
Alt-S, Shift-F10 : Shell to (4)DOS
Alt-X, ESC : Exit program
F4 or ENTER on dir : Change to highlighted directory
F5 or ENTER on .. : Change to parent directory
F6 or Alt-L : Change drive
1) A "Edit" flag will appear on the bottom right side of the screen
2) " "Cut" " " " " " " " " " " "
Remark: When changing directories/drives the question
"Descriptions have been edited. Shall they be saved (Y/N) ?"
will appear; you need therefore not to worry about your
description's actuality.
4UTILS - A small 4DOS Utility Collection Page 5
5. 4FF - a simple file finder
─────────────────────────────────────────────────────────────────────────
5.1 Command line switches and parameters
─────────────────────────────────────────
Syntax of 4FF is:
4FF [/a:[[+|]-]rash][/l][/z][/s][/b][/d][/n][/p][/?] [dir] {filenames}
This time there is a bunch of command line switches, but they are rather
simple.
/a followed by a combination of
r (read only), -r (not read only)
a (archive) , -a (not archived)
s (system) or -s (not system)
h (hidden) -h (not hidden)
searches for files which have these attributes set resp. reset.
Examples:
. 4ff /a:-r *.exe *.com
searches for executable, writeable files.
. 4ff /a:a *.*
searches for files which have not been backed up yet.
/l do not search in .lzh archive files.
/z do not search in .zip archive files.
/j do not search in .arj archive files.
By default 4FF scans .lzh, .zip and .arj archives, using /l, /z or
/j will speed 4FF up.
Example: 4FF /z /l *.bak
Searching for *.bak files in archives is not very intelligent !
/s scan only subdirectories of given path `start-dir'
4FF will begin scanning the subdirectory you specified in start dir
and will recurse to the deeper levels. This will speed your search
up, if you roughly know where your files reside.
/b bare listing (omits size, date, and descriptions)
This switch is intended for producing "bare" file listing (file
names only) for batch files.
4UTILS - A small 4DOS Utility Collection Page 6
/d scan all hard disks (floppy drives not included)
Example: 4FF /d *.bak *.swp *.tmp
Locates backup, swap and temporary files, which generally may be
deleted before backing up your hard disk.
Remark: Floppy drives must be addressed explicitly.
Otherwise (if 4FF would scan all drives from A to Z)
you had to insert floppy disks into your drives, even
if you wouldn't be interested in their contents.
/m:nn set right margin to nn.
When printing direct to your line printer, you can set the printer
width by this switch.
Example: 4FF /m:132 *.pas > prn:
[Note: Putting your printer in 132 column mode is your duty!]
NOTE: If you are a lucky owner of a e.g. 132 column mode VGA card
(everything above 80 characters) you will use this switch
too; 4FF's internal default screen width is 80 characters.
/p page output
pages the output, i.e. prints a "-- more --" message and waits for
key to be pressed.
/? this help display.
4UTILS - A small 4DOS Utility Collection Page 7
6. Customizing 4DESC and 4FF - the 4UTILS.INI file
─────────────────────────────────────────────────────────────────────────
This section is only for people interested in customizing 4FF or 4DESC.
You need not to worry about all the options described below if you "just"
want to use 4FF / 4DESC and if you are happy with the country settings
and the colors.
If you are familiar with the SSTOOLS.INI file (If you are a FRACTINT or
PICLAB user) or if the WIN.INI or 4DOS.INI has already been changed by
you, you shouldn't have problems with the 4UTILS.INI file too.
A 4UTILS.INI file consists of several sections, enclosed in square
brackets ([ and ]).
Remark: The following examples have been taken out of 4UTILS.SMP - a
sample 4UTILS.INI file.
[Date & Time formats]
The following entries are possible:
DateFormat = mmddyy | ddmmyy | yymmdd | ddMMMyy
7.10.92, 10-07-92, 92/10/7, 7Oct92.
DateSep = -
Date separator is a hyphen (mm-dd-yy)
TimeFormat= 12
valid entries are: 12 (am/pm) or 24 (24 hours).
TimeSep = :
Time separator is a colon (hh:mm). Fill in what you like.
MilleSep = '
Fill in what you like for the thousands separator.
NOTE: 4DESC / 4FF detect on startup where you live. (provided that
your COUNTRY= settings in CONFIG.SYS has been properly set.
The switches above are merely cosmetic.
4UTILS - A small 4DOS Utility Collection Page 8
[ColorDisplay]
That is the place where you may change the colors!
The following colors are available (case not significant)
Black , DarkGray
Blue , LightBlue
Green , LightGreen
Cyan , LightCyan
Red , LightRed
Magenta , LightMagenta
Brown , Yellow
LightGray, White
StatusFg = Blue ; Status line foreground color
StatusBg = Cyan ; " " background "
DirFg = LightBlue ; Directories are shown in DirFg on NormBg
SelectFg = Blue ; Select bar foreground color
SelectBg = Cyan ; " " background "
HighFg = LightRed ; Highlighted foreground,
used for "Edit" and "Cut" marks
NormFg = LightGray ; normal foreground color
NormBg = Blue ; " background "
WarnFg = Yellow ; foreground for warning messages.
WarnBg = Cyan ; background " " "
[MonoDisplay]
The same for monochrome displays...
StatusFg = Black
StatusBg = LightGray
DirFg = White
SelectFg = Black
SelectBg = LightGray
HighFg = LightGray;
NormFg = LightGray
NormBg = Black
WarnFg = Black
WarnBg = White
[GeneralDisplay]
LeftJust = Yes | No | Y | N
If you want the filenames justified to left side (xxxxxx.xxx) set
LeftJust = Y, otherwise they are justified in the "normal" way
(xxxxxx .xxx).
FullSize = Yes | No | Y | N
Set FullSize=Y to get the `full' size display (x'xxx'xxx [Bytes])
instead of (xxxK).
Viewer = any-viewer-you like
Let Viewer point to your favorite viewer (defaulting to list).
4UTILS - A small 4DOS Utility Collection Page 9
Hidden = Yes | No | Y | N
Setting Hidden=Y enables display of hidden files.
[Misc]
Delimiters=<list of separators>
Delimiters=,.();:-!?/[]{}+*='`"@%&$_£
This separator list is used by the Ctrl-Left, Ctrl-Right algorithm.
[Mouse]
VMickeysPerKeyPress = 2
HMickeysPerKeyPress = 2
These 2 parameters control the "jumpiness" of the cursor when using the
mouse. The cursor follows the mouse movements in x- or y-direction when
more than VMickeysPerKeypress in x resp HMickeysPerKeypress in y direction
were made.
NOTE: These two parameters are _hardware-dependent_, strictly speaking
speed dependent. Play around with these values till you get a
smooth scrolling.
[4FF]
These options concern only 4FF.
DoPage = Yes | No | Y | N
Set DoPage = Y if you want to have permanent paging.
(Remark: Redirecting output is still allowed, in this case the paging
parameter will be ignored.)
HilightMore = Yes | No | Y | N
Choose whether to hilights the "-- more --" message (Y) or not (N).
4UTILS - A small 4DOS Utility Collection Page 10
7. (Re)Compiling 4DESC or 4FF
─────────────────────────────────────────────────────────────────────────
Some hints about (re)compiling 4DESC or 4FF:
(Recompiling 4DESC might be useful if you want to change the default
colors *and* want to save the space a 4UTILS.INI file would occupy.)
. 4DESC and 4FF have been written in Turbo Pascal 7.0 (6.0)
. They use the features Turbo Pascal 6.0 (7.0) provides, i.e.
* Inline Assembling ( ASM ... END )
If you don't have an inline assembler, recode the parts containing
ASM-statements.
* 4FF uses the FormatStr-procedures, that implies the following:
Although 4FF isn't object-oriented at all, it uses the Objects and the
Drivers-Unit shipped with Turbo Pascal 6.0 (Reason: The FormatStr
procedure is hidden in the Drivers unit, which needs the unit Object
in order to work :-( ).
If you neither have OBJECTS.TPU, nor DRIVERS.TPU you are urged to re-
write the screen output of 4FF.
* 4DESC has an object oriented part: the DESCRIPT.PAS unit.
A TCollection is used to get a sorted list of files with their
corresponding descriptions.
8. Bugs and Comments
─────────────────────────────────────────────────────────────────────────
Known bugs resp. deficiencies:
. Non-standard VGA-modes (e.g. 132x60) are not supported by 4DESC.
If you were using a non-standard VGA mode it will be lost when
returning to DOS and must be reset. This deficiency originates from
Turbo Pascal's CRT unit and will not go away in the near future. Sorry.
. Diacritics in filenames are not handled in a logical way: they are not
down-cased. This is necessary for DOS; if they were down-cased (in the
description file) DOS/4DOS would not find the corresponding description
line anymore! This deficiency is not relevant for english-speaking people,
and it should not be relevant for the others too; special characters in
DOS filenames are not a good idea, anyway. (It is not guaranteed how
DOS treats special-characters in filenames, legal DOS filenames consist
of the letters A-Z plus the characters "!#$%&'()-@^_`{}" and "~".
4DOS (and other programs) use "%^@()" and "`" internally, so they should
be avoided.)
If you find any bugs not listed above please drop us a note. Please
describe your system you are working on (which CPU, 4DOS version
specialities etc).
Should you have any comments or suggestions, don't hesitate and send
them to us.
4UTILS - A small 4DOS Utility Collection Page 11
9. How to reach the authors
─────────────────────────────────────────────────────────────────────────
Our addresses are:
David Frey, & Tom Bowden
Urdorferstrasse 30 1575 Canberra Drive
8952 Schlieren ZH Stone Mountain, GA 30088-3629
Switzerland USA
eMail: eMail:
frey@ezinfo.vsmail.ethz.ch 73247.3571@compuserve.com
10. Acknowledgements
─────────────────────────────────────────────────────────────────────────
We have received a lot of valuable suggestions, bug reports and hints how
to improve 4DESC resp. 4FF. We would like to thank those people who
dropped a note for this precious feedback. Especially
Andreas Tranquillini's suggestions and his extensive testing have been
very useful.
4UTILS - A small 4DOS Utility Collection Page 12