ELOPTAC HEX EDITOR Ver 1.00 DOCUMENTATION - PAGE 1 OF 6






(***************************************************************)
(* *)
(* ELOPTAC HEX EDITOR *)
(* *)
(***************************************************************)

(***************************************************************)
(* *)
(* (C) 1988 by Eloptac Enterprises *)
(* 2244 Chimney Springs Dr. *)
(* Marietta, GA 30062 *)
(* *)
(* *)
(* This program and related data files are released on *)
(* a "SHAREWARE" basis. The recipient is free to *)
(* examine and use the software with the *)
(* understanding that if it proves to be of use and *)
(* value, a $25.00 contribution to the author will be *)
(* made. *)
(* *)
(* While reasonable effort has been made to ensure the *)
(* reliability of this software, no warranty is given. *)
(* The recipient uses the programs at his own risk *)
(* and in no event shall the author be liable for *)
(* damages arising from its use. *)
(* *)
(***************************************************************)



This program and related files are supplied for personal,
private, non commercial use. Feel free to distribute them given
these restrictions:

o the program shall be supplied in its original, unmodified
form, which includes this documentation;

o no fee is charged;

o "commercial" use without a license is prohibited;

o the program may not be included - or bundled - with other
goods or services. Exceptions may be granted upon written
request only.





Commercial site license fee is $25.00 payable in U. S. funds to
Eloptac Enterprises


August 17, 1988 (C) 1988 by Eloptac Enterprises
ELOPTAC HEX EDITOR Ver 1.00 DOCUMENTATION - PAGE 2 OF 6


EHE version 1.00 reads the file specified on the command line and
displays that file for editing. file content is displayed in
both hexadecimal and ASCII formats. Changes to the file can be
made in either format. Data is displayed in 256 byte "pages."
Eloptac Hex Editor can handle any size file. However the address
displays and goto (F2) function are limited to files less than
8,388,352 bytes long.




Command Line Syntax:
EHE [d:][\path\]filename

Drive and path are optional parameters. If executed without
the required operand the program will display the proper
command line syntax.




System Requirements:

IBM PC/XT/AT or Compatible running PC-DOS or MS-DOS 2.00 or
higher with 128K available RAM.

EHE was developed and tested on a TeleVideo Tele-286 MOD II
running DOS 3.2. Beta Testing was done on a number of
different computers including PC compatible 8086 machines
running DOS 2.11.



Files included are:

EHE.EXE - Eloptac Hex Editor program.
EHE.DOC - This Documentation file.




Features and Operation of the Eloptac Hex Editor:

ELOPTAC HEX EDITOR reads data from the specified file and
displays it in 256 byte PAGES. Simply move the cursor to a
byte to be changed and key in the new data.

EHE displays information in five blocks.

The first block contains the name of the file being edited,
the size of the file in both decimal and hexadecimal, and
the current page (zero relative) being edited.

The second block contains the hex addresses of the current
page.


August 17, 1988 (C) 1988 by Eloptac Enterprises
ELOPTAC HEX EDITOR Ver 1.00 DOCUMENTATION - PAGE 3 OF 6



The third block displays in hex format the data in the
current page. Each character is displayed in the primary
color when it matches the original data. Each character is
display in highlighted color when the data does not match
the data as read.

The forth block displays in ASCII format the data in the
current page. The user has the option to display only
printable characters or display the IBM character set for
all 256 bytes. Each character is displayed in the primary
color when it matches the original data. Each character is
display in highlighted color when the data does not match
the data as read.

The fifth block displays command available or under special
circumstances error messages or requests for user input.

NOTE: As a byte is changed in the HEX mode it's display is
automatically updated in the ASCII display block. In a
similar manner as a byte is changed in the ASCII mode it's
display is automatically updated in the HEX display block.
If the data does not match the data as read it will be
highlighted.

Data is not written to the file until either F7 is keyed or
data has been modified and an attempt is made to move to
another page of data (PgUp, PgDn, Home, F2 (GOTO PAGE), F5
(SEARCH), F10 (exit), or Esc). Once a page has been written
to the file it becomes "original data" if reread by EHE.















CAUTION:
Eloptac Hex Editor modifies the file specified on the
command line. It does NOT create a backup file of the
original file being changed. If the original file is of a
critical nature it is strongly recommended that the user
make a backup copy prior to modification with EHE.







August 17, 1988 (C) 1988 by Eloptac Enterprises
ELOPTAC HEX EDITOR Ver 1.00 DOCUMENTATION - PAGE 4 OF 6


Notes on Key Function of Eloptac Hex Editor:



F1 HELP - Displays the various commands available while
using EHE.

F2 GOTO PAGE - allow direct access to a specific page
within the file. Page number requested is in
hexadecimal.

F3 HEX/ASCII - default is HEX - toggles between editing
data in hex format or ascii format. Relative cursor
position is maintained when jumping from one format
to the other.

F4 DISPLAY IBM - default is off - When off displays only
printable ascii characters, non printable characters
are displayed as a single dot. When on displays the
IBM characters for all values.

F5 SEARCH - Will perform hex search for a single byte,
an ascii search for a string up to a maximum of 16
characters, or will repeat the previous search.
ASCII search is case sensitive.

Alt F5 REPEAT PREVIOUS SEARCH - Repetition of the previous
search can be achieved by pressing F5 twice or Alt
F5.

F6 RESTORE BYTE - returns the byte at the cursor
position to its original value. NOTE: If the current
page has been written to the file the "original
value" is defined as the value currently in the file.
This may differ from the value that existed when
program execution began.

F7 WRITE - Writes the current page to the file only if
changes have been made. A request to verify the
write is made before the actual write.

F8 RESTORE PAGE - returns all 256 bytes of the current
page to its original value. See the note under F6.

F9 Displays program credits and other information.

F10 EXIT - Ends execution of the program. If the data in
the current page has been changed the program will
query the user to write or abandon the changes.

Home Returns to the first page of data (page # 0x0000).

End Moves the cursor to the last byte on the current
page.



August 17, 1988 (C) 1988 by Eloptac Enterprises
ELOPTAC HEX EDITOR Ver 1.00 DOCUMENTATION - PAGE 5 OF 6


PgUp Read the previous page of data. If the data in the
current page has been changed the program will query
the user to write or abandon the changes.

PgDn Read the next page of data. If the data in the
current page has been changed the program will query
the user to write or abandon the changes.

Esc Similar to F10 or will abort a local procedure.



Customizing EHE.EXE
Beginning at address 0x4094 in the program file EHE.EXE are
eight bytes. Their functions are:

DEFAULT
ADDRESS VALUE FUNCTION
======= ===== ==========================================
0x4094 0E Primary Text Color (Yellow)
0x4095 01 Primary Background Color (Blue)
0x4096 00 Highlighted Screen Text Color (Black)
0x4097 07 Highlighted Screen Background Color (Gray)
0x4098 0F Special Text Color (White)
0x4099 04 Special Background Color (Red)
0x409A 01 Hex Edit boolean (on)
0x409B 00 Display IBM Characters boolean (off)

To modify these defaults execute EHE to modify EHE.EXE, goto
page (F2) 40, move the cursor to the proper bytes and change as
desired. Save the changes with F7.

Valid color chars are:
text & background: 00 = BLACK
01 = BLUE
02 = GREEN
03 = CYAN
04 = RED
05 = MAGENTA
06 = BROWN
07 = LIGHTGRAY
text only: 08 = DARKGRAY
09 = LIGHTBLUE
0A = LIGHTGREEN
0B = LIGHTCYAN
0C = LIGHTRED
0D = LIGHTMAGENTA
0E = YELLOW
0F = WHITE

Hex Edit Boolean = 00 = HEX Edit default
Hex Edit Boolean = 01 = ASCII Edit default
Display Boolean = 00 = Display ASCII using IBM Characters
Display Boolean = 01 = Display ASCII printable characters



August 17, 1988 (C) 1988 by Eloptac Enterprises
ELOPTAC HEX EDITOR Ver 1.00 DOCUMENTATION - PAGE 6 OF 6



IBM is a registered trademark of the IBM Corporation.
MS-DOS is a registered trademark of Microsoft Inc.



HISTORY OF REVISIONS:

EHE is written in Borland International Turbo C version 1.5.

A special thanks to my friends at;
Cogitate, Inc.
24000 Telegraph Rd.
Southfiled, MI 48034
(313) 352-2345
for their help and advise in creating, debugging, and beta
testing ELOPTAC HEX EDITOR.

Initial Release August 1988.











SOFTWARE FROM ELOPTAC

EHE100 - THE ELOPTAC HEX EDITOR - allows editing of file in
hex. Includes one key operation for most
functions and has the capability to search for
strings or individual bytes.

EHK110 - ELOPTAC HOUSE KEEPER - a program that helps clear
the junk files off the system, frees up space and
reduces backup time!

ESL100 - ELOPTAC SOURCE EDITOR - Is a program the creates a
listing of a C program. The user has the
capability to specify report format, customize
header and footer lines, customize printer init
and exit strings, and the printing of a cross
reference variable directory.

TFTD310 - THOUGHT FOR THE DAY - selects and displays at
random a quotation from a database of over 1600
quotations.


Support SHAREWARE - Send a contribution today



August 17, 1988 (C) 1988 by Eloptac Enterprises