978 lines
40 KiB
Plaintext
978 lines
40 KiB
Plaintext
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
H E X C A L I B U R
|
||
= = = = = = = = = =
|
||
|
||
|
||
The
|
||
|
||
Hex
|
||
|
||
Editor
|
||
|
||
|
||
Version 1.02
|
||
|
||
|
||
Reference Manual
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Gregory Publishing Company
|
||
333 Cobalt Way, Suite 107
|
||
Sunnyvale, California, 94086
|
||
(408) 727-4660
|
||
|
||
|
||
Copyright (c) 1989 Gregory Publishing Company
|
||
All Rights Reserved
|
||
|
||
LICENSE
|
||
=======
|
||
|
||
|
||
All versions of "HEXCALIBUR -- The Hex Editor" are NOT public domain software,
|
||
nor are they free software.
|
||
|
||
Non-registered users are granted a limited license to use Hexcalibur on a trial
|
||
basis for the purpose of determining whether or not it may be suitable to their
|
||
needs. Any use of Hexcalibur, except for this limited purpose, requires
|
||
registration. Any use of copies of Hexcalibur that are not registered by any
|
||
individual, corporation, private enterprise, governmental agency, or other
|
||
entity or institution is strictly forbidden.
|
||
|
||
Registration permits a user the license to use Hexcalibur on a single computer.
|
||
The registered user may use Hexcalibur on more than one computer, but it must
|
||
not be used on two or more computers at the same time.
|
||
|
||
No user may modify Hexcalibur in any way, including, but not limited to,
|
||
decompiling, disassembling, or otherwise reverse engineering the program.
|
||
|
||
All users are encouraged to copy Hexcalibur for the trial use of others subject
|
||
to the above mentioned restrictions and also subject to the following
|
||
conditions:
|
||
|
||
(1) Hexcalibur must be copied without modification, complete with the file
|
||
containing this license information.
|
||
|
||
(2) Verbal or written notice must be given the person receiving the copy that
|
||
use of Hexcalibur requires the payment of a $30.00 registration fee to
|
||
Gregory Publishing Company.
|
||
|
||
(3) All support files must be included with the copy. These files are:
|
||
HC.EXE -- The Hexcalibur program.
|
||
HCDOC.TXT -- This document.
|
||
SAMPLE1.TXT -- A sample file of data characters.
|
||
HCMONO.FIL -- The black and white colors file.
|
||
Any README or HEXNOTES files that may be on the original disk.
|
||
|
||
(4) Hexcalibur may not be distributed along with any other product.
|
||
|
||
Operators of electronic bulletin board systems (Sysops) may post Hexcalibur for
|
||
downloading by their users providing the above conditions are met.
|
||
|
||
Distributors of public domain or user supported software may distribute copies
|
||
of Hexcalibur subject to the above conditions.
|
||
|
||
An order form is included in this file which may be used to register your copy
|
||
of Hexcalibur.
|
||
|
||
|
||
THANK YOU FOR YOUR SUPPORT!
|
||
|
||
WARRANTY
|
||
========
|
||
|
||
|
||
Gregory Publishing Company makes no warranty of any kind, express or implied,
|
||
including without limitation, any warranties or merchantability and/or fitness
|
||
for a particular purpose. Gregory Publishing Company shall not be liable for
|
||
any damages, whether direct, indirect, special, or consequential arising from a
|
||
failure of this program to operate in the manner desired by the user. Gregory
|
||
Publishing Company shall not be liable for any damage to data or property which
|
||
may be caused directly or indirectly by use of this program.
|
||
|
||
IN NO EVENT SHALL GREGORY PUBLISHING COMPANY BE LIABLE TO YOU FOR ANY DAMAGES,
|
||
INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL
|
||
DAMAGES ARISING OUT OF YOUR USE OF OR INABILITY TO USE HEXCALIBUR, OR FOR ANY
|
||
CLAIM BY ANY OTHER PARTY.
|
||
|
||
|
||
ORDERING INFORMATION
|
||
======== ===========
|
||
|
||
|
||
Registration of Hexcalibur licenses you to use the product for any reasonable
|
||
purpose as you need. Users need only register one version of Hexcalibur.
|
||
Registration automatically includes licensed use of all upgrades.
|
||
|
||
The version of Hexcalibur on this disk is version 1.02, dated August, 1989.
|
||
Depending upon how long after August, 1989, you are reading this, there may be
|
||
later versions of Hexcalibur available. We have a large list of enhancements
|
||
already planned for future versions.
|
||
|
||
Upon receipt of your payment for registration, we will automatically ship you
|
||
(providing you supply a clearly written mailing address and phone number) the
|
||
most current version of the program. Additional updates are available to
|
||
registered users ONLY for a nominal fee of $10.00 per disk.
|
||
|
||
Please use the order form supplied on the next page when placing an order.
|
||
|
||
|
||
|
||
|
||
NOTICE TO CUSTOMERS OUTSIDE NORTH AMERICA:
|
||
Please send only checks that are drawn on a US Bank that are payable in
|
||
US Dollars. Please add an additional $1.50 to cover postage for the
|
||
mailing of the diskette outside the USA.
|
||
|
||
|
||
ORDER FORM
|
||
===== ====
|
||
Gregory Publishing Company
|
||
333 Cobalt Way, Suite 107, Dept. F1
|
||
Sunnyvale, California 94086
|
||
(408) 727-4660
|
||
Quantity Item
|
||
-------- ----
|
||
|
||
________ Registration for Hexcalibur ............. @ $30.00 ea $ ___________
|
||
(Includes one copy on disk of the most current version.)
|
||
|
||
________ Upgrade of Hexcalibur ................... @ $10.00 ea $ ___________
|
||
(For already registered users only.)
|
||
|
||
|
||
Recordings from Gregory Publishing Company on cassette tape:
|
||
------------------------------------------------------------
|
||
|
||
________ Synthesized Sullivan, volume I ........... @ $ 9.00 ea $ ___________
|
||
(Gilbert & Sullivan overtures orchestrated on a synthesizer.)
|
||
|
||
________ Synthesized Sullivan, volume II .......... @ $ 9.00 ea $ ___________
|
||
|
||
|
||
Documentation for Unisys A-Series Computer Systems:
|
||
---------------------------------------------------
|
||
|
||
________ The Complete CANDE Primer ................ @ $30.00 ea $ ___________
|
||
|
||
________ The Extended ALGOL Primer, volume I ...... @ $25.00 ea $ ___________
|
||
|
||
________ The Extended ALGOL Primer, volume II ..... @ $29.00 ea $ ___________
|
||
|
||
________ The Extended ALGOL Primer, volume III .... @ $31.00 ea $ ___________
|
||
|
||
________ A-Series DMSII Programming ............... @ $40.00 ea $ ___________
|
||
|
||
________ Gregory's A-Series Technical Journal ..... @$225.00 ea $ ___________
|
||
(Annual subscription, 10 issues per year.)
|
||
SUBTOTAL $ ___________
|
||
|
||
California Residents add applicable Sales Tax $ ___________
|
||
(No sales tax on Journal subscriptions)
|
||
|
||
TOTAL $ ___________
|
||
|
||
|
||
Name: _____________________________________________________________
|
||
|
||
Company: __________________________________________________________
|
||
|
||
Address: __________________________________________________________
|
||
|
||
__________________________________________________________
|
||
|
||
Phone: __________________________________________________________
|
||
|
||
Pre-paid orders only. Purchase orders o.k. if TOTAL amount exceeds $100.00.
|
||
|
||
Corporate/Government/Multiple Users
|
||
===================================
|
||
|
||
|
||
All corporate, business, government, and other commercial users of Hexcalibur
|
||
must register.
|
||
|
||
The registration fee for the first license of Hexcalibur is $30.00. This price
|
||
includes the delivery of an updated disk which will be mailed to the licensee.
|
||
|
||
Additional registration fees for users AT THE SAME ORGANIZATION are $25.00 each
|
||
for 2 - 20 users and $20.00 each per additional user after that. This fee is
|
||
for registration only. Users are expected to make their own copies of the
|
||
updated software from the disk sent the original licensee. NO DISK WILL BE
|
||
MAILED TO A CUSTOMER WHO AVAILS HIMSELF OF ANY DISCOUNTED REGISTRATION FEE.
|
||
|
||
Example: If your company has five users that want to use Hexcalibur, the
|
||
license fee for all five would be:
|
||
|
||
$30.00 (for the original license)
|
||
+ ($25.00 x 4) = $100.00 (for the other four users)
|
||
-------
|
||
$130.00 TOTAL registration fee
|
||
|
||
The first user would be sent an updated disk, and the other four would obtain
|
||
copies from that user.
|
||
|
||
If your company has 25 users, all of whom are going to use Hexcalibur, the
|
||
registration fee would be:
|
||
|
||
$30.00 (for the original license)
|
||
+ ($25.00 x 20) = $500.00 (for users #2 - 20)
|
||
+ ($20.00 x 5) = $100.00 (for users #21 -25)
|
||
-------
|
||
$630.00 TOTAL registration fee
|
||
|
||
Not all registrations need be made at once. After payment of the first
|
||
registration, you may take advantage of the discount schedule by adding new
|
||
users. Simply include your ORIGINAL LICENSE NUMBER (which is provided on the
|
||
disk mailed to you) with your order, and you will receive the discount.
|
||
|
||
|
||
|
||
NOTICE: YOU MAY NOT USE HEXCALIBUR WITHIN YOUR ORGANIZATION WITHOUT A PRIOR
|
||
PURCHASE OR LICENSE ARRANGEMENT.
|
||
|
||
Introduction
|
||
============
|
||
|
||
Hexcalibur is a high quality editor designed expressly for examining, modifying,
|
||
or otherwise manipulating disk files in their raw, or binary, format. You may
|
||
examine and change any part of a file using either hexadecimal characters (4-
|
||
bit characters) or standard ASCII characters. Hexcalibur is especially useful
|
||
for examining and editing files that standard ASCII editors either will not read
|
||
or will read but display in a format that is not terribly useful.
|
||
|
||
With Hexcalibur, you can:
|
||
|
||
(1) Examine and change the contents of WordStar or other specially encoded
|
||
files.
|
||
|
||
(2) Filter incompatible codes out of files.
|
||
|
||
(3) Convert Unix or BTOS text files (line terminator = 0a) to MS-DOS format
|
||
(line terminator = 0d0a) or to MacIntosh format (line terminator = 0d),
|
||
or vice versa.
|
||
|
||
(4) Examine and change the printer codes in a file to be printed.
|
||
|
||
(5) Search game programs for clues in the text portion of the codefile.
|
||
|
||
(6) Examine and change soft font data files for laser printers.
|
||
|
||
(7) Examine incoming .COM and .EXE files for software virus patterns and,
|
||
possibly, eradicate them.
|
||
|
||
...and much more! New ideas for using this product come to mind every day!
|
||
|
||
The key to doing any of these things is THAT YOU KNOW WHAT YOU ARE DOING.
|
||
Hexcalibur does not advise you or attempt to protect you from yourself. It will
|
||
let you do anything to a file at the binary level. If you change an executable
|
||
codefile, you had better know what you are doing! But for those who know,
|
||
Hexcalibur provides a convenient tool for making the kind of changes that, until
|
||
now, were extremely difficult to do!
|
||
|
||
An immediate use of Hexcalibur can be illustrated using this documentation file
|
||
you are now reading. This file is formatted for printing on any printer that
|
||
uses the sequence "Form Feed/Carriage Return" ("0c0d" character sequence) as a
|
||
page separator. If your printer does not use that character sequence, but uses
|
||
something else, you can easily change this file to print on your printer.
|
||
|
||
Suppose, for example, that your printer uses the hex character sequence "1f" as
|
||
its form feed instruction. You could change every "0c0d" in this file to "1f"
|
||
by taking the following steps:
|
||
|
||
Beginning at the MS-DOS prompt, proceed as follows. (The step numbers are for
|
||
reference purposes only. Do not type them in. "Alt" refers to the "Alt key",
|
||
and <ENTER> refers to the "ENTER key.")
|
||
|
||
1. HC HCDOC.TXT
|
||
|
||
2. press any key to leave the greeting screen
|
||
|
||
3. Alt-R
|
||
|
||
4. 0c0d <ENTER>
|
||
5. 1f <ENTER>
|
||
|
||
6. when the confirm prompt appears, type:
|
||
r
|
||
|
||
7. Alt-X
|
||
|
||
8. y
|
||
|
||
9. <ENTER>
|
||
|
||
Now print the file using the MS-DOS PRINT command, and you will find that it
|
||
will eject pages properly on your printer that uses "1f" as a page eject
|
||
instruction.
|
||
|
||
|
||
The pages that follow provide instructions on how to use Hexcalibur. Hexcalibur
|
||
has been designed for intuitive operation. Most of the commands are accessed by
|
||
different Alt keys. (For example, Alt-B moves to the beginning of the file,
|
||
Alt-E to the end, Alt-F is FIND, Alt-R is REPLACE, and so forth.) Wherever
|
||
possible, standard DOS keys have been used for various paging functions. (For
|
||
example, the cursor arrows work as expected; if you move to a line off of the
|
||
screen, the screen will scroll one line; Page Up and Page Down may be used to
|
||
move through the file in 256-character blocks.)
|
||
|
||
An on-line summary of the commands is readily available by pressing function key
|
||
F1. Use this screen for quick reference to any command.
|
||
|
||
The screen colors are user-configurable. If the appearance of the screen is not
|
||
right for your computer, type Alt-C. This will bring up the Color Menu. Once in
|
||
the Color Menu, use the cursor arrows to change colors. The Left and Right
|
||
arrows change the foreground color, while the Up and Down arrows change the
|
||
background color. When you have your screen colors set as desired, press the
|
||
ENTER key to save them. They will be saved in a file called HC.FIL and will be
|
||
available for all future runs of Hexcalibur.
|
||
|
||
|
||
Installation
|
||
============
|
||
|
||
To install Hexcalibur onto a hard disk system, proceed as follows:
|
||
|
||
1. Insert the floppy into a floppy drive. (We will assume you are using
|
||
drive A.)
|
||
|
||
2. Select the drive you want the program to run from. For example, if you want
|
||
the program on drive C, enter:
|
||
C:
|
||
|
||
3. Change to the directory you want the program to run from. For example, to
|
||
put the program under the directory DOS, enter:
|
||
CD DOS
|
||
For best results, put Hexcalibur into a directory that is part of your
|
||
normal PATH.
|
||
|
||
4. COPY A:*.*
|
||
|
||
5. Set your screen colors. To do this, enter:
|
||
HC SAMPLE1.TXT
|
||
Alt-C
|
||
Select your colors as described in "Color Selections" (later in this
|
||
document).
|
||
Exit the color menu by pressing the ENTER key.
|
||
Exit the program (if desired) by entering:
|
||
Alt-X
|
||
|
||
Your screen color selections are now saved in a location that is visible
|
||
to your DOS PATH. Hexcalibur will therefore find the color file every
|
||
time you run it. (You can also make additional color files under other
|
||
directories if you wish to use different colors in different locations.)
|
||
|
||
6. Mail in your Registration on the enclosed order form. If possible, please
|
||
let us know to what use you plan to put this program to.
|
||
|
||
7. Make a copy of the original diskette and give it to a friend.
|
||
|
||
Hexcalibur
|
||
==========
|
||
|
||
Command Summary List
|
||
--------------------
|
||
Function Key Sequence
|
||
-------- ------------
|
||
|
||
Move 1 character to the left. . . . . . . . . . . . . . . . . . Left Arrow
|
||
Move 1 character to the right . . . . . . . . . . . . . . . . . Right Arrow
|
||
Move Up 1 line; scroll 1 line if at top of screen . . . . . . . Up Arrow
|
||
Move Down 1 line; scroll 1 line if a bottom of screen . . . . . Down Arrow
|
||
(Each line is 16 characters long.)
|
||
Move Up 1 page. . . . . . . . . . . . . . . . . . . . . . . . . Page Up
|
||
Move Down 1 page. . . . . . . . . . . . . . . . . . . . . . . . Page Down
|
||
(Each page is 256 characters in length.)
|
||
|
||
Beginning of line . . . . . . . . . . . . . . . . . . . . . . . Home
|
||
End of line . . . . . . . . . . . . . . . . . . . . . . . . . . End
|
||
Beginning of file . . . . . . . . . . . . . . . . . . . . . . . Alt-B or Alt-0
|
||
Move in 10% of the file . . . . . . . . . . . . . . . . . . . . Alt-1
|
||
Move in 20% of the file . . . . . . . . . . . . . . . . . . . . Alt-2
|
||
Move in 30% of the file . . . . . . . . . . . . . . . . . . . . Alt-3
|
||
Move in 40% of the file . . . . . . . . . . . . . . . . . . . . Alt-4
|
||
Move in 50% of the file . . . . . . . . . . . . . . . . . . . . Alt-5
|
||
Move in 60% of the file . . . . . . . . . . . . . . . . . . . . Alt-6
|
||
Move in 70% of the file . . . . . . . . . . . . . . . . . . . . Alt-7
|
||
Move in 80% of the file . . . . . . . . . . . . . . . . . . . . Alt-8
|
||
Move in 90% of the file . . . . . . . . . . . . . . . . . . . . Alt-9
|
||
End of file . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-E
|
||
|
||
Go to specific sector and byte. . . . . . . . . . . . . . . . . Alt-G
|
||
(Type in the desired sector and byte number and press ENTER.)
|
||
Switch between Hex Window and Text Window . . . . . . . . . . . F2
|
||
|
||
Toggle Insert Mode/Overtype Mode. . . . . . . . . . . . . . . . Insert
|
||
Delete Character. . . . . . . . . . . . . . . . . . . . . . . . Delete
|
||
(In the Hex window, both hexades are deleted at once.)
|
||
|
||
Begin Block . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-A
|
||
Initiate Copy of Selected Block . . . . . . . . . . . . . . . Alt-C
|
||
Initiate Move of Selected Block . . . . . . . . . . . . . . . Alt-M
|
||
Delete Selected Block . . . . . . . . . . . . . . . . . . . . Alt-D
|
||
Retrieve most recently selected Block for Pasting . . . . . . . Alt-P
|
||
|
||
Find text . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-F
|
||
Find and Replace text . . . . . . . . . . . . . . . . . . . . . Alt-R
|
||
|
||
Save File . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-S
|
||
Exit Program (with option to save the file) . . . . . . . . . . Alt-X
|
||
Quit Program (same as Alt-X). . . . . . . . . . . . . . . . . . Alt-Q
|
||
Undo All Changes since the most recent Save . . . . . . . . . . Alt-U
|
||
|
||
Select Screen Colors. . . . . . . . . . . . . . . . . . . . . . Alt-C
|
||
Toggle Display All/Display only Printables in the text Window . Alt-Z
|
||
Display Product Information . . . . . . . . . . . . . . . . . . Alt-I
|
||
View Command Summary. . . . . . . . . . . . . . . . . . . . . . F1
|
||
|
||
Cancel an operation in progress . . . . . . . . . . . . . . . . Esc
|
||
|
||
The Screen Layout
|
||
=== ====== ======
|
||
|
||
HEXCALIBUR Workfile: C:\HEXCAL\NONAME.TXT
|
||
|
||
Sector: 000 Byte: 000 F1 - HELP
|
||
0 0 F2 - Switch Window
|
||
overtype ESC - Cancel Operation
|
||
|
||
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
|
||
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 00
|
||
10 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 10
|
||
20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 20
|
||
30 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 30
|
||
40 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 40
|
||
50 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 50
|
||
60 00 00 00 00 00 00 00 00 00 .. .. 60
|
||
70 00 00 00 00 the hex window 00 00 00 00 00 .. the text .. 70
|
||
80 00 00 00 00 00 00 00 00 00 .. window .. 80
|
||
90 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ 90
|
||
A0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ A0
|
||
B0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ B0
|
||
C0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ C0
|
||
D0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ D0
|
||
E0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ E0
|
||
F0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................ F0
|
||
|
||
Size of File: 65536 Available Memory: 365160
|
||
|
||
When first coming up in Hexcalibur, you will notice two large windows taking up
|
||
the majority of the screen. The smaller window on the right side is the text
|
||
window, consisting of the character translations of all the bytes in the file.
|
||
The larger one on the left side is the hex window, containing two hex characters
|
||
for every byte in the file, one for the lower four bits and one for the upper
|
||
four bits. Each character in the text window has a direct correspondence across
|
||
in the hex window, and vice versa. The screen is laid out so that corresponding
|
||
hex and text characters are always visible when editing. When editing in the
|
||
hex window, the corresponding character in the text window is simultaneously
|
||
updated; when editing in the text window, the corresponding hex character pair
|
||
is also updated. You may edit in one window at a time and use the F2 command to
|
||
switch windows.
|
||
|
||
The top line of the screen consists of the title, HEXCALIBUR and the name of the
|
||
workfile being edited, including the name of the path to that file. Other
|
||
features displayed on the screen include the exact location (in sectors and
|
||
bytes) of the cursor in the file. This is displayed in the upper left hand
|
||
corner of the screen directly under the title, HEXCALIBUR, and it is updated as
|
||
the cursor moves through the file.
|
||
|
||
Beneath the position display is the mode display. There are three separate
|
||
modes: overtype, insert mode, and block mode. Overtype and insert mode can by
|
||
toggled by the insert key. Block mode is started by an Alt-A command, and no
|
||
editing can take place as in the other two.
|
||
|
||
The bottom line contains the size of the file and the remaining available memory
|
||
the editor may use. The size of the file is updated as editing takes place.
|
||
The available memory changes as blocks of space are assigned, which is typically
|
||
in blocks of 8K bytes.
|
||
|
||
Color Selections
|
||
===== ==========
|
||
|
||
HEXCALIBUR Workfile: C:\HEXCAL\NONAME.TXT
|
||
|
||
Sector: Byte: F1 - HELP
|
||
F2 - Switch Window
|
||
overtype ESC - Cancel Operation
|
||
|
||
0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
|
||
00 Color Selections ...------------- 00
|
||
10 ------|||||||||| 10
|
||
20 ...................... |||||||||||||||| 20
|
||
30 . Current Field: . |||||||||||||||| 30
|
||
40 . TEXT . |||||----------- 40
|
||
50 ...................... ---------------- 50
|
||
60 ---------------- 60
|
||
70 Left/Right cursors Change text color ---------------- 70
|
||
80 Up/Down cursors Change background color ---------------- 80
|
||
90 ---------------- 90
|
||
A0 TAB Move to next field ---------------- A0
|
||
B0 Shift-TAB Move to previous field ---------------- B0
|
||
C0 ---------------- C0
|
||
D0 Alt-D Load default colors ---------------- D0
|
||
E0 ENTER Return and save changes ---------------- E0
|
||
F0 ESC Return without save ---------------- F0
|
||
|
||
Size of File: Available Memory:
|
||
|
||
|
||
All color selections are saved in a file named HC.FIL. If this file is not
|
||
found when the program begins running, the editor will come up with its default
|
||
colors. Another indication that it has not been found the HC.FIL file is that
|
||
the bottom of the title screen will display "To set screen colors, type Alt-C".
|
||
|
||
To enter the color selection menu once in the editor, use the Alt-C key.
|
||
|
||
In response to the Alt-C command, the color selections screen will come up. You
|
||
will be able to edit one color field at a time. The field that is currently
|
||
being edited is displayed at the top center of the screen. There are six
|
||
different color fields that you may edit.
|
||
|
||
While editing colors, the functions of the keyboard are redefined thusly:
|
||
|
||
|
||
Left/Right arrows
|
||
-----------------
|
||
|
||
Use the left and right arrow keys to change the current field's foreground text
|
||
color.
|
||
|
||
|
||
Up/Down arrows
|
||
--------------
|
||
|
||
Use the up and down arrow keys to change the current field's background color.
|
||
|
||
|
||
TAB
|
||
---
|
||
|
||
The TAB key shifts the editor to the next field.
|
||
|
||
|
||
Shift-TAB
|
||
---------
|
||
|
||
The Shift-TAB key shifts the editor to the previous field.
|
||
|
||
|
||
Alt-D
|
||
-----
|
||
|
||
Loads and displays the default colors of Hexcalibur.
|
||
|
||
|
||
ENTER
|
||
-----
|
||
|
||
Returns to Hexcalibur and saves the colors displayed on the screen to the HC.FIL
|
||
file. These color selections are now permanently saved for all future runs of
|
||
Hexcalibur.
|
||
|
||
|
||
ESC
|
||
---
|
||
|
||
Returns to Hexcalibur without saving the displayed colors.
|
||
|
||
Tutorial
|
||
========
|
||
|
||
|
||
To begin running Hexcalibur from a DOS prompt, enter the command:
|
||
|
||
hc [filename]
|
||
|
||
where the filename is the name of the file to be edited. Although the filename
|
||
is optional, if it is not provided, Hexcalibur will immediately prompt you for a
|
||
file name.
|
||
|
||
Note: If you have no file to start with, begin editing using the file named
|
||
SAMPLE1 supplied on the disk.
|
||
|
||
As you load Hexcalibur, the title screen will first appear on the screen. As
|
||
the program loads the file, a counter at the bottom left hand corner of the
|
||
screen displays how many bytes are currently loaded. As soon as the file is
|
||
loaded, press any key to enter the editor.
|
||
|
||
IF THIS IS THE FIRST TIME YOU ARE RUNNING HEXCALIBUR, you may want to change the
|
||
screen colors. To do so, type Alt-C. You may then change your screen colors as
|
||
described on the Color Selection Menu. (For additional information on color
|
||
selection, see the section on "Custom Color Settings".)
|
||
|
||
As the editor comes up, your cursor will be located at the top left hand corner
|
||
of the hex window. To begin, use the arrow keys to move the cursor around the
|
||
hex window. Move to the end of a line and notice that the cursor wraps around
|
||
to the next line of the hex window instead of moving over to the text window.
|
||
To change windows use the F2 key. This will move you to the corresponding
|
||
character in the text window. Now move to the bottom of the screen and you will
|
||
see the file scroll up while the cursor holds its position. If you press the
|
||
home key, the cursor will move to the beginning of the line of the current
|
||
window. The end key will move the cursor to the end of the line of the current
|
||
window. Try a few page up and page downs. The entire file will shift a page
|
||
(half of a sector) up or down. For larger jumps through the file you will want
|
||
to use the Alt-(0..9) keys. Try pressing Alt-3. The cursor will move to a
|
||
position 30% of the way through the file.
|
||
|
||
|
||
Editing in Overtype Mode
|
||
------------------------
|
||
|
||
To start this sample editing session, do the following:
|
||
|
||
1. Press the insert key to change the program into Overtype mode.
|
||
2. Press function key F2 to switch to the text window.
|
||
|
||
Now begin typing some text characters. You will notice that the characters you
|
||
are typing are overwriting the existing characters. Also notice that the
|
||
corresponding characters in the hex window have changed their values in
|
||
accordance with the changes you are making in the text window.
|
||
|
||
Now press function key F2 again, and you will move to the hex window. While you
|
||
are in the hex window, you can only use hexadecimal characters: 0-9 and A-F.
|
||
As you type, you will notice that, as in the text window, the characters you
|
||
type will overwrite the character which the cursor sits on. The corresponding
|
||
text characters are updated as well.
|
||
|
||
|
||
Editing in Insert Mode
|
||
----------------------
|
||
|
||
Now press the insert key and you will notice that, at the upper left hand corner
|
||
of the screen, it now says "insert mode" where it used to say "overtype." Press
|
||
the F2 key so that your cursor is in the text window. Begin typing, and you
|
||
will notice that the text from the cursor forward gets shifted forward, and the
|
||
typed character is inserted at the cursor. The cursor is also shifted one space
|
||
to the right. Again, the characters in the hex window are adjusted.
|
||
|
||
Move over to the hex window (by pressing F2) and try typing there. You will
|
||
notice that insert mode in the hex window works a bit differently. Move the
|
||
cursor to the left hex character of a pair. Type a number and watch all of the
|
||
pairs of hex characters shift forward, from the cursor on. The number pressed
|
||
will be inserted into the right hex character and the left hex character will
|
||
turn to 0. The cursor is moved to the right hex character where the typed
|
||
number sits. If you type another number, the right hex character will shift to
|
||
become the left hex character, and the character keyed becomes the right hex
|
||
character. The cursor then moves another character to the right.
|
||
|
||
|
||
|
||
Working with Blocks
|
||
-------------------
|
||
|
||
In order to work with blocks you must always begin by pressing Alt-A (begin
|
||
block). When you do so, you will notice that the mode indicator towards the
|
||
upper-left hand corner of the screen is flashing "block mode" and the character
|
||
your cursor sits on is now highlighted with a block mode color setting. You are
|
||
now in block mode. Note: You cannot edit text in block mode, but you can switch
|
||
freely between the hex and text window with F2. Try moving the cursor around
|
||
the screen and you will see that the text between the start of the block and the
|
||
current position is highlighted. Now hit F2 to switch to the opposite window
|
||
and notice that the block has remained the same. When you have decided on a
|
||
block, look directly above the windows to see the block options:
|
||
Alt-C = copy block Alt-M = move block Alt-D = delete block
|
||
|
||
First try a block copy by pressing Alt-C. The block highlight will disappear,
|
||
not the text, and above the windows it will say "Move cursor to destination,
|
||
press ENTER." Do as the instructions say and you will see the formerly
|
||
highlighted text reappear where the cursor sits. The cursor will appear at the
|
||
end of the copied block.
|
||
|
||
Try the same procedure with move block (Alt-M) this time. You must start a new
|
||
block again with Alt-A. Notice that when you actually press Alt-M, the
|
||
highlighted text disappears instead of remaining as with an Alt-C. Pressing
|
||
Enter at the destination will act the same as with an Alt-C.
|
||
|
||
Now try the procedure with delete block (Alt-D) after starting another block
|
||
with Alt-A. When pressing Alt-D, the highlighted block is removed and you are
|
||
no longer in block mode.
|
||
|
||
Using Paste Block
|
||
-----------------
|
||
|
||
Now imagine that you accidentally deleted the wrong block. It will be easy to
|
||
recover this deleted block with Paste Block (Alt-P). When pasting a block you
|
||
must NOT be in block mode. The last block used in block mode is automatically
|
||
saved in a block buffer and can be retrieved with Alt-P. Press Alt-P now and
|
||
above the windows it will say "Move cursor to destination, press ENTER." If the
|
||
cursor still sits in the same place when the delete was made, you do not need to
|
||
move it. Press Enter and the block will be replaced. If you wish to do another
|
||
Paste block with the same block, you may. The block remains in the buffer until
|
||
it is replaced, when block mode is used.
|
||
|
||
Basic Editing Features
|
||
===== ======= ========
|
||
|
||
Overtype
|
||
--------
|
||
|
||
In overtype mode, anything typed on to the screen will overwrite existing
|
||
characters on the screen. In the hex window, the overwrite will take place over
|
||
the character which the cursor is on, as in the text window. In the hex window,
|
||
it edits only the upper or lower eight bits of the corresponding text character
|
||
in the text window. The insert key toggles overtype and insert mode.
|
||
|
||
|
||
Insert
|
||
------
|
||
|
||
In insert mode, anything typed on to the screen will cause all text, from the
|
||
cursor forward, to move up a space, and the typed character to be placed at the
|
||
cursor. When typing in the hex window, the first character typed will be
|
||
inserted as the rightmost 4 bits and prefixed by a zero; the second key typed
|
||
will cause the first character to be shifted to the left and then the second
|
||
character will become the lower 4 bits. For example, if we have:
|
||
|
||
90 91 92 93 94 95 96 97 98 99 9a 9b 9c 9d 9e 9f
|
||
|
||
and we are in insert mode with the cursor over the "9" of "98" and we type a
|
||
"6", the display will change to read:
|
||
|
||
90 91 92 93 94 95 96 97 06 98 99 9a 9b 9c 9d 9e
|
||
|
||
Now the cursor will be over the "6" of the "06" and the characters from "98" up
|
||
will have been shifted one full position to the right. If (note we're still in
|
||
insert mode) we now (while over the "6") type "7", the "6" will be moved to the
|
||
left and the "7" inserted after it. The display will then read:
|
||
|
||
90 91 92 93 94 95 96 97 67 98 99 9a 9b 9c 9d 9e
|
||
|
||
The cursor will be left over the "9" of the "98", which is the next available
|
||
position on the screen.
|
||
|
||
The insert key toggles overtype and insert mode.
|
||
|
||
|
||
Delete
|
||
------
|
||
|
||
When deleting a character, all text beyond that character is shifted back to
|
||
fill the void. In the hex window, both hex characters are deleted with one
|
||
keystroke.
|
||
|
||
|
||
Change Display (Alt-Z)
|
||
----------------------
|
||
|
||
This will change the text window to display either all printable characters or
|
||
just ASCII characters.
|
||
|
||
|
||
Switch Between Hex and Character Edit (F2)
|
||
------------------------------------------
|
||
|
||
This will shift windows to the corresponding character in the other window.
|
||
This allows you to edit using either hex characters or ASCII characters.
|
||
|
||
|
||
Color Selection (Alt-C)
|
||
-----------------------
|
||
|
||
Alt-C will bring up the color selection help screen. There are six different
|
||
color fields to edit: text, background, special characters, help screens, block
|
||
characters, and non-printable characters (hex character who have no printable
|
||
translation). The current field being edited is displayed in the top half of
|
||
the help screen, and the cursor is located at one of the characters of that
|
||
field. The arrow keys change the color of the current field and the Tab keys
|
||
shift fields. ESC will cancel all color changes and ENTER will save them.
|
||
|
||
|
||
|
||
|
||
Moving Around in the File
|
||
====== ====== == === ====
|
||
|
||
Arrow Keys
|
||
----------
|
||
|
||
Using the arrow keys will move the cursor throughout the file. When reaching
|
||
the end of a line or a page, the screen and cursor will automatically wrap.
|
||
Note: The arrow keys will not move the cursor from one window to another.
|
||
|
||
|
||
Page Up, Page Down
|
||
------------------
|
||
|
||
Paging up and down will shift the file exactly one screen page (256 bytes)
|
||
accordingly.
|
||
|
||
|
||
Home
|
||
----
|
||
|
||
Moves the cursor to the beginning of the line of the current window.
|
||
|
||
|
||
End
|
||
---
|
||
|
||
Moves the cursor to the end of the line of the current window.
|
||
|
||
|
||
Beginning of File (Alt-B)
|
||
-------------------------
|
||
|
||
Moves the cursor to the beginning of the file.
|
||
|
||
|
||
End of File (Alt-E)
|
||
-------------------
|
||
|
||
Moves the cursor to the end of the file.
|
||
|
||
|
||
Move to x% of file (Alt-0..9)
|
||
-----------------------------
|
||
|
||
Moves to a certain percentage of the file (i.e., Alt-3 moves the cursor to a
|
||
position at 30% of the file size).
|
||
|
||
|
||
Goto (Alt-G)
|
||
------------
|
||
|
||
Lets you specify exactly where in the file you want to move to, using sector and
|
||
byte values.
|
||
|
||
|
||
Find (Alt-F)
|
||
------------
|
||
|
||
Searches for a given string in hex or text, depending on the current window, and
|
||
then moves the cursor to the position of the string if found.
|
||
|
||
|
||
Find and Replace (Alt-R)
|
||
------------------------
|
||
|
||
Alt-R prompts for two strings: a target string and a replacement string. Each
|
||
time the target string is found in the file, you are asked if you want the
|
||
replacement to be done. The possible responses are:
|
||
|
||
y -- yes: replace this one occurrence of the target string with the
|
||
replacement string.
|
||
n -- no: skip this occurrence of the target string but continue searching
|
||
for the next occurrence of the target.
|
||
r -- replace all: replace all remaining occurrences of the target string
|
||
without prompting again.
|
||
|
||
The ESC key may be used to cancel the Replace operation.
|
||
|
||
Any time while a Find or Replace is in progress, pressing any key on the
|
||
keyboard will stop the operation, and the prompt
|
||
|
||
ENTER = continue / ESC = break
|
||
|
||
will appear. When this happens, press the ENTER key to continue the operation.
|
||
To abort the operation, press the Escape key.
|
||
|
||
|
||
Block Mode Editing
|
||
===== ==== =======
|
||
|
||
Block Mode
|
||
----------
|
||
|
||
Block mode is initiated by executing an Alt-A. In block mode, blocks of text
|
||
may be copied, moved, or deleted, regardless of which window you are in. Both
|
||
windows will be updated to the change. Text cannot be edited in block mode.
|
||
|
||
Begin Block (Alt-A)
|
||
-------------------
|
||
|
||
Turns block mode on and places a marker at the current position of the cursor.
|
||
The cursor then should be moved to the position at the end of a desired block
|
||
before executing a block action, i.e. copy block.
|
||
|
||
Delete Block (Alt-D)
|
||
--------------------
|
||
|
||
To execute a delete block, you must be in block mode. When the desired block to
|
||
remove is highlighted, an Alt-D will delete it.
|
||
|
||
Note: In case of accidental delete, the block is still available in memory. It
|
||
may be retrieved by typing Alt-P. After typing Alt-P, move the cursor to the
|
||
location where you would like to put the accidentally deleted block, and press
|
||
ENTER. The block will be inserted back into the file.
|
||
|
||
Blocks are only saved to one level deep. Once a new block has been selected,
|
||
the previous block is no longer retrievable.
|
||
|
||
Copy Block (Alt-C)
|
||
------------------
|
||
|
||
To execute a copy block, you must be in block mode. When the desired block to
|
||
copy is highlighted, press Alt-C. The highlighting of the text will disappear.
|
||
Move the cursor to the desired location where the block is to be copied and
|
||
press Enter.
|
||
|
||
Move Block (Alt-M)
|
||
------------------
|
||
|
||
To move a block, you must be in block mode. When the desired block to move is
|
||
highlighted, press Alt-M. The highlighted text will be removed. Move the
|
||
cursor to the desired destination location and press Enter.
|
||
|
||
Paste Block (Alt-P)
|
||
-------------------
|
||
|
||
Alt-P will paste the most recently selected block to any position in the file.
|
||
Alt-P is pressed OUTSIDE of block mode. It causes the program to retrieve the
|
||
most recently selected block and make it available for insertion into the file.
|
||
This may be a block that was previously deleted, moved, or copied. As with move
|
||
block and copy block, after pressing Alt-P, move the cursor to the location in
|
||
the file where you desire the block to be inserted, and press ENTER.
|
||
|
||
File Options
|
||
==== =======
|
||
|
||
Undo changes (Alt-U)
|
||
--------------------
|
||
|
||
Undoes changes in the file since the last save was made.
|
||
|
||
|
||
Save File (Alt-S)
|
||
-----------------
|
||
|
||
Alt-S causes a small menu to appear in the Hex window. You are given the option
|
||
to rename the file and then save it. To actually save the file, you must press
|
||
the ENTER key in the last box on the menu. To cancel the save operation, press
|
||
the Escape key at any time.
|
||
|
||
If there already exists a file with the name you are attempting to use, you will
|
||
be given the option of making a backup file (with the .BAK extension) when the
|
||
save takes place.
|
||
|
||
Upon completion of the save, the program returns to normal operation.
|
||
|
||
|
||
Exit Program (Alt-Q)
|
||
--------------------
|
||
|
||
Same as Alt-X.
|
||
|
||
|
||
Exit Program with Optional Save (Alt-X)
|
||
---------------------------------------
|
||
|
||
Alt-X exits the program and gives an option to save the file. ESC may used to
|
||
escape the exit altogether.
|
||
|
||
Once you have moved to the Save menu via Alt-X, it is impossible to get back to
|
||
the program. Pressing ESC while in the Save menu will exit the program, and the
|
||
file will NOT be saved. (A notice to this effect is posted at the bottom of the
|
||
Save menu when Save is entered via Alt-X.)
|
||
|
||
|
||
|
||
|