You are encouraged to copy and/or distribute these programs freely,
provided that :
1) No fee (beyond the actual cost of disk copying) shall be charged
for copying and distribution.
2) This package is to be distributed ONLY in its original,
unmodified state.
If you find this package useful and plan to use it, then we encourage
you to become a registered user ($15 fee). Registered users enjoy
the following benefits :
1) The latest version of The Programmers Toolbox.
2) Printed documentation for The Programmers Toolbox.
3) The warm honest feeling that you have supported the
"Shareware" concept.
To register your copy of The Programmers Toolbox please send $15 to:
Silicon Systems
5217 Millsprings Dr.
Arlington, TX 76017
Silicon Systems has taken due care in developing and testing the utilities
contained in The Programmer's ToolBox, and makes no expressed or implied
warranty of any kind with regard to these utilities. In no event shall
Silicon Systems be liable for the incidental or consequential damages
in connection with or arising out of the use of these utilities.
Registered users may, at any time, obtain the latest version of the
Programmer's ToolBox (documentation included) by sending their name, registration number, and a $5 fee to Silicon Systems.
Information on other products offered by Silicon Systems can also be
requested by writing to the above address.
INTRODUCTION
============
This document is by no means intended to be a comprehensive manual for operation of The Programmers Toolbox. It is intended only to allow the user to familiarize himself/herself with the utilities. A complete printed
manual can be obtained by registering your copy of the Programmers
Toolbox (see above).
The Programmers Toolbox (Version 1.0) contains (2) utilities :
DUMP.EXE --> File Dump Utility
HEXEDIT.EXE --> Hexadecimal Edit Utility
DUMP Utility
============
The DUMP utility allows the user to analyze the contents of any file or
memory in both hexadecimal and ASCII formats.
The user may enter the filename to display (at the "File >" prompt), or
the user can enter the starting address of memory to display by using
the command format :
File >@XXXX:YYYY
where
XXXX --> HEX segment address
YYYY --> HEX offset address
When dumping from memory, the DUMP utility always displays from the
entered HEX offset address (YYYY) to HEX offset address "FFFF".
The user can dump portions of the display to a file (DUMP.DAT)
by pressing <F9>. The user can dump various portions of the display
by toggling <F9> on and off to capture specific portions of the dump.
The user can also use the <F10> key to hold the display (<F10> acts as
the CNTRL-S CNTRL-Q key combination).
The user can also turn the display off by using the <F8> key (this
key acts like the CNTRL-O option for a terminal). This allows the
user to speed through a long file without having to examine the screen
display (the File Dump option can be enabled while the Screen Display
is off).
A Program Status Line is displayed at the bottom of the screen. It
displays the currently selected DUMP options, as well as a file position
indicator.
HEXEDIT Utility
===============
The HEXEDIT utility allows the user to edit binary files (although it can
be used to edit any type of file, editing binary files is the primary
purpose for this utility).
After entering the filename to edit, the user will be a display similar
to that of the DUMP screen from the DUMP utility. The user can use
the cursor keys and page keys to traverse through the file (the cursor
keys will move the user through the current page, while the page keys
allow the user to go from page to page). The user can also use <F7> to
go to the top of the file, and <F8> to go to the bottom of the file, and
use <F9> to skip to a particular page (each page holds 384 bytes).
The user can display a HELP menu by pressing "H","h","?", or <F1>.
The user can search for a HEX pattern (up to 8 bytes) by pressing <F2>
and entering the desired HEX string. The utility will search for the next
occurence of the pattern starting from the current cursor position.
The user can also search for an ASCII pattern (up to 16 characters) by
pressing <F3> and entering the desired ASCII string. The utility
searches for ASCII patterns in the same manner as HEX patterns (see above).
The user can change the currently selected byte by pressing <F4> and
entering the desired new byte value.
<F10> will exit the user from the program. If the file has been edited,
the program will prompt the user to save the current file (the user has
the option to save or abandon the current changes).
If the program is exited from abnormally, some temporary files may exist
