home *** CD-ROM | disk | FTP | other *** search
/ PC Interdit / pc-interdit.iso / share / hexcalib / hcdoxt.txt < prev    next >
Text File  |  1994-09-20  |  62KB  |  1,451 lines
  1. With Hexcalibur, you can:
  2.  
  3. (1) Examine and change the contents of WordStar or other specially encoded
  4.     files.
  5.  
  6. (2) Filter incompatible codes out of files.
  7.  
  8. (3) Convert Unix or BTOS text files (line terminator = 0a) to MS-DOS format
  9.     (line terminator = 0d0a) or to MacIntosh format (line terminator = 0d),
  10.     or vice versa.
  11.  
  12. (4) Examine and change the printer codes in a file to be printed.
  13.  
  14. (5) Search game programs for clues in the text portion of the codefile.
  15.  
  16. (6) Examine and change soft font data files for laser printers.
  17.  
  18. (7) Examine incoming .COM and .EXE files for software virus patterns and,
  19.     possibly, eradicate them.
  20.  
  21. ...and much more!  New ideas for using this product come to mind every day!
  22.  
  23. The key to doing any of these things is THAT YOU KNOW WHAT YOU ARE DOING.
  24. Hexcalibur does not advise you or attempt to protect you from yourself. It will
  25. let you do anything to a file at the binary level.  If you change an executable
  26. codefile, you had better know what you are doing!  But for those who know,
  27. Hexcalibur provides a convenient tool for making the kind of changes that, until
  28. now, were extremely difficult to do!
  29.  
  30. An immediate use of Hexcalibur can be illustrated using this documentation file
  31. you are now reading.  This file is formatted for printing on any printer that
  32. uses the sequence "Form Feed/Carriage Return" ("0c0d" character sequence) as a
  33. page separator.  If your printer does not use that character sequence, but uses
  34. something else, you can easily change this file to print on your printer.
  35.  
  36. Suppose, for example, that your printer uses the hex character sequence "1f" as
  37. its form feed instruction.  You could change every "0c0d" in this file to "1f"
  38. by taking the following steps:
  39.  
  40. Beginning at the MS-DOS prompt, proceed as follows.  (The step numbers are for
  41. reference purposes only.  Do not type them in.  "Alt" refers to the "Alt key",
  42. and <ENTER> refers to the "ENTER key.")
  43.  
  44. 1. HC HCDOC.TXT
  45.  
  46. 2. press any key to leave the greeting screen
  47.  
  48. 3. Alt-R
  49.  
  50. 4. 0c0d <ENTER>
  51. 5. 1f <ENTER>
  52.  
  53. 6. when the confirm prompt appears, type:
  54.      r
  55.  
  56. 7. Alt-X
  57.  
  58. 8. y
  59.  
  60. 9. <ENTER>
  61.  
  62. Now print the file using the MS-DOS PRINT command, and you will find that it
  63. will eject pages properly on your printer that uses "1f" as a page eject
  64. instruction.
  65.  
  66.  
  67. The pages that follow provide instructions on how to use Hexcalibur. Hexcalibur
  68. has been designed for intuitive operation.  Most of the commands are accessed by
  69. different Alt keys.  (For example, Alt-B moves to the beginning of the file,
  70. Alt-E to the end, Alt-F is FIND, Alt-R is REPLACE, and so forth.) Wherever
  71. possible, standard DOS keys have been used for various paging functions.  (For
  72. example, the cursor arrows work as expected; if you move to a line off of the
  73. screen, the screen will scroll one line; Page Up and Page Down may be used to
  74. move through the file in 256-character blocks.)
  75.  
  76. An on-line summary of the commands is readily available by pressing function key
  77. F1.  Use this screen for quick reference to any command.
  78.  
  79. The screen colors are user-configurable.  If the appearance of the screen is not
  80. right for your computer, type Alt-C.  This will bring up the Color Menu. Once in
  81. the Color Menu, use the cursor arrows to change colors.  The Left and Right
  82. arrows change the foreground color, while the Up and Down arrows change the
  83. background color.  When you have your screen colors set as desired, press the
  84. ENTER key to save them.  They will be saved in a file called HC.FIL and will be
  85. available for all future runs of Hexcalibur.
  86.  
  87.  
  88.                                   Installation
  89.                                   ============
  90.  
  91. To install Hexcalibur onto a hard disk system, proceed as follows:
  92.  
  93. 1. Insert the floppy into a floppy drive.  (We will assume you are using
  94.    drive A.)
  95.  
  96. 2. Select the drive you want the program to run from.  For example, if you want
  97.    the program on drive C, enter:
  98.      C:
  99.  
  100. 3. Change to the directory you want the program to run from.  For example, to
  101.    put the program under the directory DOS, enter:
  102.      CD DOS
  103.    For best results, put Hexcalibur into a directory that is part of your
  104.    normal PATH.
  105.  
  106. 4. COPY A:*.*
  107.  
  108. 5. Set your screen colors.  To do this, enter:
  109.      HC SAMPLE1.TXT
  110.      Alt-C
  111.      Select your colors as described in "Color Selections" (later in this
  112.        document).
  113.      Exit the color menu by pressing the ENTER key.
  114.      Exit the program (if desired) by entering:
  115.        Alt-X
  116.  
  117.    Your screen color selections are now saved in a location that is visible
  118.    to your DOS PATH.  Hexcalibur will therefore find the color file every
  119.    time you run it.  (You can also make additional color files under other
  120.    directories if you wish to use different colors in different locations.)
  121.  
  122. 6. Mail in your Registration on the enclosed order form.  If possible, please
  123.    let us know to what use you plan to put this program to.
  124.  
  125. 7. Make a copy of the original diskette and give it to a friend.
  126.  
  127.                                    Hexcalibur
  128.                                    ==========
  129.  
  130.                               Command Summary List
  131.                               --------------------
  132. Function                                                        Key Sequence
  133. --------                                                        ------------
  134.  
  135. Move 1 character to the left. . . . . . . . . . . . . . . . . . Left Arrow
  136. Move 1 character to the right . . . . . . . . . . . . . . . . . Right Arrow
  137. Move Up 1 line; scroll 1 line if at top of screen . . . . . . . Up Arrow
  138. Move Down 1 line; scroll 1 line if a bottom of screen . . . . . Down Arrow
  139.   (Each line is 16 characters long.)
  140. Move Up 1 page. . . . . . . . . . . . . . . . . . . . . . . . . Page Up
  141. Move Down 1 page. . . . . . . . . . . . . . . . . . . . . . . . Page Down
  142.   (Each page is 256 characters in length.)
  143.  
  144. Beginning of line . . . . . . . . . . . . . . . . . . . . . . . Home
  145. End of line . . . . . . . . . . . . . . . . . . . . . . . . . . End
  146. Beginning of file . . . . . . . . . . . . . . . . . . . . . . . Alt-B or Alt-0
  147. Move in 10% of the file . . . . . . . . . . . . . . . . . . . . Alt-1
  148. Move in 20% of the file . . . . . . . . . . . . . . . . . . . . Alt-2
  149. Move in 30% of the file . . . . . . . . . . . . . . . . . . . . Alt-3
  150. Move in 40% of the file . . . . . . . . . . . . . . . . . . . . Alt-4
  151. Move in 50% of the file . . . . . . . . . . . . . . . . . . . . Alt-5
  152. Move in 60% of the file . . . . . . . . . . . . . . . . . . . . Alt-6
  153. Move in 70% of the file . . . . . . . . . . . . . . . . . . . . Alt-7
  154. Move in 80% of the file . . . . . . . . . . . . . . . . . . . . Alt-8
  155. Move in 90% of the file . . . . . . . . . . . . . . . . . . . . Alt-9
  156. End of file . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-E
  157.  
  158. Go to specific sector and byte. . . . . . . . . . . . . . . . . Alt-G
  159.   (Type in the desired sector and byte number and press ENTER.)
  160. Switch between Hex Window and Text Window . . . . . . . . . . . F2
  161.  
  162. Toggle Insert Mode/Overtype Mode. . . . . . . . . . . . . . . . Insert
  163. Delete Character. . . . . . . . . . . . . . . . . . . . . . . . Delete
  164.   (In the Hex window, both hexades are deleted at once.)
  165.  
  166. Begin Block . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-A
  167.   Initiate Copy of Selected Block . . . . . . . . . . . . . . . Alt-C
  168.   Initiate Move of Selected Block . . . . . . . . . . . . . . . Alt-M
  169.   Delete Selected Block . . . . . . . . . . . . . . . . . . . . Alt-D
  170. Retrieve most recently selected Block for Pasting . . . . . . . Alt-P
  171.  
  172. Find text . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-F
  173. Find and Replace text . . . . . . . . . . . . . . . . . . . . . Alt-R
  174.  
  175. Save File . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-S
  176. Exit Program (with option to save the file) . . . . . . . . . . Alt-X
  177. Quit Program (same as Alt-X). . . . . . . . . . . . . . . . . . Alt-Q
  178. Undo All Changes since the most recent Save . . . . . . . . . . Alt-U
  179.  
  180. Select Screen Colors. . . . . . . . . . . . . . . . . . . . . . Alt-C
  181. Toggle Display All/Display only Printables in the text Window . Alt-Z
  182. Display Product Information . . . . . . . . . . . . . . . . . . Alt-I
  183. View Command Summary. . . . . . . . . . . . . . . . . . . . . . F1
  184.  
  185. Cancel an operation in progress . . . . . . . . . . . . . . . . Esc
  186.  
  187.                               The Screen Layout
  188.                               === ====== ====== 
  189.  
  190.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  191.  
  192.     Sector: 000   Byte: 000                    F1  - HELP
  193.             0           0                      F2  - Switch Window
  194.     overtype                                   ESC - Cancel Operation
  195.  
  196.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  197. 00  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  00
  198. 10  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  10
  199. 20  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  20
  200. 30  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  30
  201. 40  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  40
  202. 50  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  50
  203. 60  00 00 00 00                      00 00 00 00 00   ..            ..  60
  204. 70  00 00 00 00    the hex window    00 00 00 00 00   ..  the text  ..  70
  205. 80  00 00 00 00                      00 00 00 00 00   ..   window   ..  80
  206. 90  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  90
  207. A0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  A0
  208. B0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  B0
  209. C0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  C0
  210. D0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  D0
  211. E0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  E0
  212. F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  F0
  213.  
  214.     Size of File: 65536    Available Memory: 365160
  215.  
  216. When first coming up in Hexcalibur, you will notice two large windows taking up
  217. the majority of the screen.  The smaller window on the right side is the text
  218. window, consisting of the character translations of all the bytes in the file. 
  219. The larger one on the left side is the hex window, containing two hex characters
  220. for every byte in the file, one for the lower four bits and one for the upper
  221. four bits.  Each character in the text window has a direct correspondence across
  222. in the hex window, and vice versa.  The screen is laid out so that corresponding
  223. hex and text characters are always visible when editing.  When editing in the
  224. hex window, the corresponding character in the text window is simultaneously
  225. updated; when editing in the text window, the corresponding hex character pair
  226. is also updated.  You may edit in one window at a time and use the F2 command to
  227. switch windows.
  228.  
  229. The top line of the screen consists of the title, HEXCALIBUR and the name of the
  230. workfile being edited, including the name of the path to that file.  Other
  231. features displayed on the screen include the exact location (in sectors and
  232. bytes) of the cursor in the file.  This is displayed in the upper left hand
  233. corner of the screen directly under the title, HEXCALIBUR, and it is updated as
  234. the cursor moves through the file.
  235.  
  236. Beneath the position display is the mode display.  There are three separate
  237. modes:  overtype, insert mode, and block mode.  Overtype and insert mode can by
  238. toggled by the insert key.  Block mode is started by an Alt-A command, and no
  239. editing can take place as in the other two.
  240.  
  241. The bottom line contains the size of the file and the remaining available memory
  242. the editor may use.  The size of the file is updated as editing takes place. 
  243. The available memory changes as blocks of space are assigned, which is typically
  244. in blocks of 8K bytes.
  245.  
  246.                               Color Selections
  247.                               ===== ========== 
  248.  
  249.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  250.  
  251.     Sector:       Byte:                        F1  - HELP
  252.                                                F2  - Switch Window
  253.     overtype                                   ESC - Cancel Operation
  254.  
  255.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  256. 00                  Color Selections                  ...-------------  00
  257. 10                                                    ------||||||||||  10
  258. 20               ......................               ||||||||||||||||  20
  259. 30               .   Current Field:   .               ||||||||||||||||  30
  260. 40               .        TEXT        .               |||||-----------  40
  261. 50               ......................               ----------------  50
  262. 60                                                    ----------------  60
  263. 70    Left/Right cursors   Change text color          ----------------  70
  264. 80    Up/Down cursors      Change background color    ----------------  80
  265. 90                                                    ----------------  90
  266. A0    TAB                  Move to next field         ----------------  A0
  267. B0    Shift-TAB            Move to previous field     ----------------  B0
  268. C0                                                    ----------------  C0
  269. D0    Alt-D                Load default colors        ----------------  D0
  270. E0    ENTER                Return and save changes    ----------------  E0
  271. F0    ESC                  Return without save        ----------------  F0
  272.  
  273.     Size of File:          Available Memory:       
  274.  
  275.  
  276. All color selections are saved in a file named HC.FIL.  If this file is not
  277. found when the program begins running, the editor will come up with its default
  278. colors.  Another indication that it has not been found the HC.FIL file is that
  279. the bottom of the title screen will display "To set screen colors, type Alt-C".
  280.  
  281. To enter the color selection menu once in the editor, use the Alt-C key. 
  282.  
  283. In response to the Alt-C command, the color selections screen will come up.  You
  284. will be able to edit one color field at a time.  The field that is currently
  285. being edited is displayed at the top center of the screen.  There are six
  286. different color fields that you may edit.
  287.  
  288. While editing colors, the functions of the keyboard are redefined thusly:
  289.  
  290.  
  291. Left/Right arrows
  292. -----------------
  293.  
  294. Use the left and right arrow keys to change the current field's foreground text
  295. color.
  296.  
  297.  
  298. Up/Down arrows
  299. --------------
  300.  
  301. Use the up and down arrow keys to change the current field's background color.
  302.  
  303.  
  304. TAB
  305. ---
  306.  
  307. The TAB key shifts the editor to the next field.
  308.  
  309.  
  310. Shift-TAB
  311. ---------
  312.  
  313. The Shift-TAB key shifts the editor to the previous field.
  314.  
  315.  
  316. Alt-D
  317. -----
  318.  
  319. Loads and displays the default colors of Hexcalibur.
  320.  
  321.  
  322. ENTER
  323. -----
  324.  
  325. Returns to Hexcalibur and saves the colors displayed on the screen to the HC.FIL
  326. file.  These color selections are now permanently saved for all future runs of
  327. Hexcalibur.
  328.  
  329.  
  330. ESC
  331. ---
  332.  
  333. Returns to Hexcalibur without saving the displayed colors. 
  334.  
  335.                                    Tutorial
  336.                                    ======== 
  337.  
  338.  
  339. To begin running Hexcalibur from a DOS prompt, enter the command:
  340.  
  341. hc [filename]
  342.  
  343. where the filename is the name of the file to be edited.  Although the filename
  344. is optional, if it is not provided, Hexcalibur will immediately prompt you for a
  345. file name.
  346.  
  347. Note:  If you have no file to start with, begin editing using the file named
  348. SAMPLE1 supplied on the disk.
  349.  
  350. As you load Hexcalibur, the title screen will first appear on the screen.  As
  351. the program loads the file, a counter at the bottom left hand corner of the
  352. screen displays how many bytes are currently loaded.  As soon as the file is
  353. loaded, press any key to enter the editor.
  354.  
  355. IF THIS IS THE FIRST TIME YOU ARE RUNNING HEXCALIBUR, you may want to change the
  356. screen colors.  To do so, type Alt-C.  You may then change your screen colors as
  357. described on the Color Selection Menu.  (For additional information on color
  358. selection, see the section on "Custom Color Settings".)
  359.  
  360. As the editor comes up, your cursor will be located at the top left hand corner
  361. of the hex window.  To begin, use the arrow keys to move the cursor around the
  362. hex window.  Move to the end of a line and notice that the cursor wraps around
  363. to the next line of the hex window instead of moving over to the text window.
  364. To change windows use the F2 key.  This will move you to the corresponding
  365. character in the text window.  Now move to the bottom of the screen and you will
  366. see the file scroll up while the cursor holds its position. If you press the
  367. home key, the cursor will move to the beginning of the line of the current
  368. window.  The end key will move the cursor to the end of the line of the current
  369. window.  Try a few page up and page downs.  The entire file will shift a page
  370. (half of a sector) up or down.  For larger jumps through the file you will want
  371. to use the Alt-(0..9) keys.  Try pressing Alt-3.  The cursor will move to a
  372. position 30% of the way through the file.
  373.  
  374.  
  375. Editing in Overtype Mode
  376. ------------------------
  377.  
  378. To start this sample editing session, do the following:
  379.  
  380. 1. Press the insert key to change the program into Overtype mode.
  381. 2. Press function key F2 to switch to the text window.
  382.  
  383. Now begin typing some text characters.  You will notice that the characters you
  384. are typing are overwriting the existing characters.  Also notice that the
  385. corresponding characters in the hex window have changed their values in
  386. accordance with the changes you are making in the text window.
  387.  
  388. Now press function key F2 again, and you will move to the hex window.  While you
  389. are in the hex window, you can only use hexadecimal characters:  0-9 and A-F. 
  390. As you type, you will notice that, as in the text window, the characters you
  391. type will overwrite the character which the cursor sits on.  The corresponding
  392. text characters are updated as well.
  393.  
  394.  
  395. Editing in Insert Mode
  396. ----------------------
  397.  
  398. Now press the insert key and you will notice that, at the upper left hand corner
  399. of the screen, it now says "insert mode" where it used to say "overtype."  Press
  400. the F2 key so that your cursor is in the text window.  Begin typing, and you
  401. will notice that the text from the cursor forward gets shifted forward, and the
  402. typed character is inserted at the cursor.  The cursor is also shifted one space
  403. to the right.  Again, the characters in the hex window are adjusted.
  404.  
  405. Move over to the hex window (by pressing F2) and try typing there.  You will
  406. notice that insert mode in the hex window works a bit differently.  Move the
  407. cursor to the left hex character of a pair.  Type a number and watch all of the
  408. pairs of hex characters shift forward, from the cursor on.  The number pressed
  409. will be inserted into the right hex character and the left hex character will
  410. turn to 0.  The cursor is moved to the right hex character where the typed
  411. number sits.  If you type another number, the right hex character will shift to
  412. become the left hex character, and the character keyed becomes the right hex
  413. character.  The cursor then moves another character to the right.
  414.  
  415.  
  416.  
  417. Working with Blocks
  418. -------------------
  419.  
  420. In order to work with blocks you must always begin by pressing Alt-A (begin
  421. block).  When you do so, you will notice that the mode indicator towards the
  422. upper-left hand corner of the screen is flashing "block mode" and the character
  423. your cursor sits on is now highlighted with a block mode color setting.  You are
  424. now in block mode.  Note: You cannot edit text in block mode, but you can switch
  425. freely between the hex and text window with F2.  Try moving the cursor around
  426. the screen and you will see that the text between the start of the block and the
  427. current position is highlighted.  Now hit F2 to switch to the opposite window
  428. and notice that the block has remained the same.  When you have decided on a
  429. block, look directly above the windows to see the block options:
  430.   Alt-C = copy block   Alt-M = move block   Alt-D = delete block
  431.  
  432. First try a block copy by pressing Alt-C.  The block highlight will disappear,
  433. not the text, and above the windows it will say "Move cursor to destination,
  434. press ENTER." Do as the instructions say and you will see the formerly
  435. highlighted text reappear where the cursor sits.  The cursor will appear at the
  436. end of the copied block.
  437.  
  438. Try the same procedure with move block (Alt-M) this time. You must start a new
  439. block again with Alt-A.  Notice that when you actually press Alt-M, the
  440. highlighted text disappears instead of remaining as with an Alt-C.  Pressing
  441. Enter at the destination will act the same as with an Alt-C.
  442.  
  443. Now try the procedure with delete block (Alt-D) after starting another block
  444. with Alt-A.  When pressing Alt-D, the highlighted block is removed and you are
  445. no longer in block mode.
  446.  
  447. Using Paste Block
  448. -----------------
  449.  
  450. Now imagine that you accidentally deleted the wrong block.  It will be easy to
  451. recover this deleted block with Paste Block (Alt-P).  When pasting a block you
  452. must NOT be in block mode.  The last block used in block mode is automatically
  453. saved in a block buffer and can be retrieved with Alt-P.  Press Alt-P now and
  454. above the windows it will say "Move cursor to destination, press ENTER."  If the
  455. cursor still sits in the same place when the delete was made, you do not need to
  456. move it.  Press Enter and the block will be replaced.  If you wish to do another
  457. Paste block with the same block, you may.  The block remains in the buffer until
  458. it is replaced, when block mode is used.
  459.  
  460.                             Basic Editing Features
  461.                             ===== ======= ======== 
  462.  
  463. Overtype
  464. --------
  465.  
  466. In overtype mode, anything typed on to the screen will overwrite existing
  467. characters on the screen.  In the hex window, the overwrite will take place over
  468. the character which the cursor is on, as in the text window.  In the hex window,
  469. it edits only the upper or lower eight bits of the corresponding text character
  470. in the text window.  The insert key toggles overtype and insert mode.
  471.  
  472.  
  473. Insert
  474. ------
  475.  
  476. In insert mode, anything typed on to the screen will cause all text, from the
  477. cursor forward, to move up a space, and the typed character to be placed at the
  478. cursor.  When typing in the hex window, the first character typed will be
  479. inserted as the rightmost 4 bits and prefixed by a zero; the second key typed
  480. will cause the first character to be shifted to the left and then the second
  481. character will become the lower 4 bits.  For example, if we have: 
  482.  
  483. 90 91 92 93 94 95 96 97 98 99 9a 9b 9c 9d 9e 9f
  484.  
  485. and we are in insert mode with the cursor over the "9" of "98" and we type a
  486. "6", the display will change to read:
  487.  
  488. 90 91 92 93 94 95 96 97 06 98 99 9a 9b 9c 9d 9e
  489.  
  490. Now the cursor will be over the "6" of the "06" and the characters from "98" up
  491. will have been shifted one full position to the right.  If (note we're still in
  492. insert mode) we now (while over the "6") type "7", the "6" will be moved to the
  493. left and the "7" inserted after it.  The display will then read:
  494.  
  495. 90 91 92 93 94 95 96 97 67 98 99 9a 9b 9c 9d 9e
  496.  
  497. The cursor will be left over the "9" of the "98", which is the next available
  498. position on the screen.
  499.  
  500. The insert key toggles overtype and insert mode.
  501.  
  502.  
  503. Delete
  504. ------
  505.  
  506. When deleting a character, all text beyond that character is shifted back to
  507. fill the void.  In the hex window, both hex characters are deleted with one
  508. keystroke.
  509.  
  510.  
  511. Change Display (Alt-Z)
  512. ----------------------
  513.  
  514. This will change the text window to display either all printable characters or
  515. just ASCII characters.
  516.  
  517.  
  518. Switch Between Hex and Character Edit (F2)
  519. ------------------------------------------
  520.  
  521. This will shift windows to the corresponding character in the other window. 
  522. This allows you to edit using either hex characters or ASCII characters.
  523.  
  524.  
  525. Color Selection (Alt-C)
  526. -----------------------
  527.  
  528. Alt-C will bring up the color selection help screen.  There are six different
  529. color fields to edit: text, background, special characters, help screens, block
  530. characters, and non-printable characters (hex character who have no printable
  531. translation).  The current field being edited is displayed in the top half of
  532. the help screen, and the cursor is located at one of the characters of that
  533. field.  The arrow keys change the color of the current field and the Tab keys
  534. shift fields.  ESC will cancel all color changes and ENTER will save them.
  535.  
  536.  
  537.  
  538.  
  539.                           Moving Around in the File
  540.                           ====== ====== == === ==== 
  541.  
  542. Arrow Keys
  543. ---------- 
  544.  
  545. Using the arrow keys will move the cursor throughout the file.  When reaching
  546. the end of a line or a page, the screen and cursor will automatically wrap. 
  547. Note: The arrow keys will not move the cursor from one window to another.
  548.  
  549.  
  550. Page Up, Page Down
  551. ------------------
  552.  
  553. Paging up and down will shift the file exactly one screen page (256 bytes)
  554. accordingly.
  555.  
  556.  
  557. Home
  558. ---- 
  559.  
  560. Moves the cursor to the beginning of the line of the current window.
  561.  
  562.  
  563. End
  564. --- 
  565.  
  566. Moves the cursor to the end of the line of the current window.
  567.  
  568.  
  569. Beginning of File (Alt-B)
  570. -------------------------
  571.  
  572. Moves the cursor to the beginning of the file.
  573.  
  574.  
  575. End of File (Alt-E)
  576. -------------------
  577.  
  578. Moves the cursor to the end of the file.
  579.  
  580.  
  581. Move to x% of file (Alt-0..9)
  582. -----------------------------
  583.  
  584. Moves to a certain percentage of the file (i.e., Alt-3 moves the cursor to a
  585. position at 30% of the file size).
  586.  
  587.  
  588. Goto (Alt-G)
  589. ------------ 
  590.  
  591. Lets you specify exactly where in the file you want to move to, using sector and
  592. byte values.
  593.  
  594.  
  595. Find (Alt-F)
  596. ------------
  597.  
  598. Searches for a given string in hex or text, depending on the current window, and
  599. then moves the cursor to the position of the string if found.
  600.  
  601.  
  602. Find and Replace (Alt-R)
  603. ------------------------
  604.  
  605. Alt-R prompts for two strings:  a target string and a replacement string.  Each
  606. time the target string is found in the file, you are asked if you want the
  607. replacement to be done.  The possible responses are:
  608.  
  609.   y -- yes:  replace this one occurrence of the target string with the
  610.              replacement string.
  611.   n -- no:   skip this occurrence of the target string but continue searching
  612.              for the next occurrence of the target.
  613.   r -- replace all:  replace all remaining occurrences of the target string
  614.              without prompting again.
  615.  
  616. The ESC key may be used to cancel the Replace operation.
  617.  
  618. Any time while a Find or Replace is in progress, pressing any key on the
  619. keyboard will stop the operation, and the prompt 
  620.  
  621. ENTER = continue / ESC = break
  622.  
  623. will appear.  When this happens, press the ENTER key to continue the operation. 
  624. To abort the operation, press the Escape key.
  625.  
  626.  
  627.                              Block Mode Editing
  628.                              ===== ==== ======= 
  629.  
  630. Block Mode
  631. ----------
  632.  
  633. Block mode is initiated by executing an Alt-A.  In block mode, blocks of text
  634. may be copied, moved, or deleted, regardless of which window you are in.  Both
  635. windows will be updated to the change.  Text cannot be edited in block mode.
  636.  
  637. Begin Block (Alt-A)
  638. -------------------
  639.  
  640. Turns block mode on and places a marker at the current position of the cursor. 
  641. The cursor then should be moved to the position at the end of a desired block
  642. before executing a block action, i.e. copy block.
  643.  
  644. Delete Block (Alt-D)
  645. --------------------
  646.  
  647. To execute a delete block, you must be in block mode.  When the desired block to
  648. remove is highlighted, an Alt-D will delete it.
  649.  
  650. Note:  In case of accidental delete, the block is still available in memory.  It
  651. may be retrieved by typing Alt-P.  After typing Alt-P, move the cursor to the
  652. location where you would like to put the accidentally deleted block, and press
  653. ENTER.  The block will be inserted back into the file.
  654.  
  655. Blocks are only saved to one level deep.  Once a new block has been selected,
  656. the previous block is no longer retrievable.
  657.  
  658. Copy Block (Alt-C)
  659. ------------------
  660.  
  661. To execute a copy block, you must be in block mode.  When the desired block to
  662. copy is highlighted, press Alt-C.  The highlighting of the text will disappear. 
  663. Move the cursor to the desired location where the block is to be copied and
  664. press Enter.
  665.  
  666. Move Block (Alt-M)
  667. ------------------
  668.  
  669. To move a block, you must be in block mode.  When the desired block to move is
  670. highlighted, press Alt-M.  The highlighted text will be removed.  Move the
  671. cursor to the desired destination location and press Enter.
  672.  
  673. Paste Block (Alt-P)
  674. -------------------
  675.  
  676. Alt-P will paste the most recently selected block to any position in the file. 
  677. Alt-P is pressed OUTSIDE of block mode.  It causes the program to retrieve the
  678. most recently selected block and make it available for insertion into the file. 
  679. This may be a block that was previously deleted, moved, or copied.  As with move
  680. block and copy block, after pressing Alt-P, move the cursor to the location in
  681. the file where you desire the block to be inserted, and press ENTER.
  682.  
  683.                                  File Options
  684.                                  ==== ======= 
  685.  
  686. Undo changes (Alt-U)
  687. --------------------
  688.  
  689. Undoes changes in the file since the last save was made. 
  690.  
  691.  
  692. Save File (Alt-S)
  693. -----------------
  694.  
  695. Alt-S causes a small menu to appear in the Hex window.  You are given the option
  696. to rename the file and then save it.  To actually save the file, you must press
  697. the ENTER key in the last box on the menu.  To cancel the save operation, press
  698. the Escape key at any time.
  699.  
  700. If there already exists a file with the name you are attempting to use, you will
  701. be given the option of making a backup file (with the .BAK extension) when the
  702. save takes place.
  703.  
  704. Upon completion of the save, the program returns to normal operation.
  705.  
  706.  
  707. Exit Program (Alt-Q)
  708. --------------------
  709.  
  710. Same as Alt-X.
  711.  
  712.  
  713. Exit Program with Optional Save (Alt-X)
  714. ---------------------------------------
  715.  
  716. Alt-X exits the program and gives an option to save the file.  ESC may used to
  717. escape the exit altogether.
  718.  
  719. Once you have moved to the Save menu via Alt-X, it is impossible to get back to
  720. the program.  Pressing ESC while in the Save menu will exit the program, and the
  721. file will NOT be saved.  (A notice to this effect is posted at the bottom of the
  722. Save menu when Save is entered via Alt-X.)
  723.  
  724.  
  725.  
  726. With Hexcalibur, you can:
  727.  
  728. (1) Examine and change the contents of WordStar or other specially encoded
  729.     files.
  730.  
  731. (2) Filter incompatible codes out of files.
  732.  
  733. (3) Convert Unix or BTOS text files (line terminator = 0a) to MS-DOS format
  734.     (line terminator = 0d0a) or to MacIntosh format (line terminator = 0d),
  735.     or vice versa.
  736.  
  737. (4) Examine and change the printer codes in a file to be printed.
  738.  
  739. (5) Search game programs for clues in the text portion of the codefile.
  740.  
  741. (6) Examine and change soft font data files for laser printers.
  742.  
  743. (7) Examine incoming .COM and .EXE files for software virus patterns and,
  744.     possibly, eradicate them.
  745.  
  746. ...and much more!  New ideas for using this product come to mind every day!
  747.  
  748. The key to doing any of these things is THAT YOU KNOW WHAT YOU ARE DOING.
  749. Hexcalibur does not advise you or attempt to protect you from yourself. It will
  750. let you do anything to a file at the binary level.  If you change an executable
  751. codefile, you had better know what you are doing!  But for those who know,
  752. Hexcalibur provides a convenient tool for making the kind of changes that, until
  753. now, were extremely difficult to do!
  754.  
  755. An immediate use of Hexcalibur can be illustrated using this documentation file
  756. you are now reading.  This file is formatted for printing on any printer that
  757. uses the sequence "Form Feed/Carriage Return" ("0c0d" character sequence) as a
  758. page separator.  If your printer does not use that character sequence, but uses
  759. something else, you can easily change this file to print on your printer.
  760.  
  761. Suppose, for example, that your printer uses the hex character sequence "1f" as
  762. its form feed instruction.  You could change every "0c0d" in this file to "1f"
  763. by taking the following steps:
  764.  
  765. Beginning at the MS-DOS prompt, proceed as follows.  (The step numbers are for
  766. reference purposes only.  Do not type them in.  "Alt" refers to the "Alt key",
  767. and <ENTER> refers to the "ENTER key.")
  768.  
  769. 1. HC HCDOC.TXT
  770.  
  771. 2. press any key to leave the greeting screen
  772.  
  773. 3. Alt-R
  774.  
  775. 4. 0c0d <ENTER>
  776. 5. 1f <ENTER>
  777.  
  778. 6. when the confirm prompt appears, type:
  779.      r
  780.  
  781. 7. Alt-X
  782.  
  783. 8. y
  784.  
  785. 9. <ENTER>
  786.  
  787. Now print the file using the MS-DOS PRINT command, and you will find that it
  788. will eject pages properly on your printer that uses "1f" as a page eject
  789. instruction.
  790.  
  791.  
  792. The pages that follow provide instructions on how to use Hexcalibur. Hexcalibur
  793. has been designed for intuitive operation.  Most of the commands are accessed by
  794. different Alt keys.  (For example, Alt-B moves to the beginning of the file,
  795. Alt-E to the end, Alt-F is FIND, Alt-R is REPLACE, and so forth.) Wherever
  796. possible, standard DOS keys have been used for various paging functions.  (For
  797. example, the cursor arrows work as expected; if you move to a line off of the
  798. screen, the screen will scroll one line; Page Up and Page Down may be used to
  799. move through the file in 256-character blocks.)
  800.  
  801. An on-line summary of the commands is readily available by pressing function key
  802. F1.  Use this screen for quick reference to any command.
  803.  
  804. The screen colors are user-configurable.  If the appearance of the screen is not
  805. right for your computer, type Alt-C.  This will bring up the Color Menu. Once in
  806. the Color Menu, use the cursor arrows to change colors.  The Left and Right
  807. arrows change the foreground color, while the Up and Down arrows change the
  808. background color.  When you have your screen colors set as desired, press the
  809. ENTER key to save them.  They will be saved in a file called HC.FIL and will be
  810. available for all future runs of Hexcalibur.
  811.  
  812.  
  813.                                   Installation
  814.                                   ============
  815.  
  816. To install Hexcalibur onto a hard disk system, proceed as follows:
  817.  
  818. 1. Insert the floppy into a floppy drive.  (We will assume you are using
  819.    drive A.)
  820.  
  821. 2. Select the drive you want the program to run from.  For example, if you want
  822.    the program on drive C, enter:
  823.      C:
  824.  
  825. 3. Change to the directory you want the program to run from.  For example, to
  826.    put the program under the directory DOS, enter:
  827.      CD DOS
  828.    For best results, put Hexcalibur into a directory that is part of your
  829.    normal PATH.
  830.  
  831. 4. COPY A:*.*
  832.  
  833. 5. Set your screen colors.  To do this, enter:
  834.      HC SAMPLE1.TXT
  835.      Alt-C
  836.      Select your colors as described in "Color Selections" (later in this
  837.        document).
  838.      Exit the color menu by pressing the ENTER key.
  839.      Exit the program (if desired) by entering:
  840.        Alt-X
  841.  
  842.    Your screen color selections are now saved in a location that is visible
  843.    to your DOS PATH.  Hexcalibur will therefore find the color file every
  844.    time you run it.  (You can also make additional color files under other
  845.    directories if you wish to use different colors in different locations.)
  846.  
  847. 6. Mail in your Registration on the enclosed order form.  If possible, please
  848.    let us know to what use you plan to put this program to.
  849.  
  850. 7. Make a copy of the original diskette and give it to a friend.
  851.  
  852.                                    Hexcalibur
  853.                                    ==========
  854.  
  855.                               Command Summary List
  856.                               --------------------
  857. Function                                                        Key Sequence
  858. --------                                                        ------------
  859.  
  860. Move 1 character to the left. . . . . . . . . . . . . . . . . . Left Arrow
  861. Move 1 character to the right . . . . . . . . . . . . . . . . . Right Arrow
  862. Move Up 1 line; scroll 1 line if at top of screen . . . . . . . Up Arrow
  863. Move Down 1 line; scroll 1 line if a bottom of screen . . . . . Down Arrow
  864.   (Each line is 16 characters long.)
  865. Move Up 1 page. . . . . . . . . . . . . . . . . . . . . . . . . Page Up
  866. Move Down 1 page. . . . . . . . . . . . . . . . . . . . . . . . Page Down
  867.   (Each page is 256 characters in length.)
  868.  
  869. Beginning of line . . . . . . . . . . . . . . . . . . . . . . . Home
  870. End of line . . . . . . . . . . . . . . . . . . . . . . . . . . End
  871. Beginning of file . . . . . . . . . . . . . . . . . . . . . . . Alt-B or Alt-0
  872. Move in 10% of the file . . . . . . . . . . . . . . . . . . . . Alt-1
  873. Move in 20% of the file . . . . . . . . . . . . . . . . . . . . Alt-2
  874. Move in 30% of the file . . . . . . . . . . . . . . . . . . . . Alt-3
  875. Move in 40% of the file . . . . . . . . . . . . . . . . . . . . Alt-4
  876. Move in 50% of the file . . . . . . . . . . . . . . . . . . . . Alt-5
  877. Move in 60% of the file . . . . . . . . . . . . . . . . . . . . Alt-6
  878. Move in 70% of the file . . . . . . . . . . . . . . . . . . . . Alt-7
  879. Move in 80% of the file . . . . . . . . . . . . . . . . . . . . Alt-8
  880. Move in 90% of the file . . . . . . . . . . . . . . . . . . . . Alt-9
  881. End of file . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-E
  882.  
  883. Go to specific sector and byte. . . . . . . . . . . . . . . . . Alt-G
  884.   (Type in the desired sector and byte number and press ENTER.)
  885. Switch between Hex Window and Text Window . . . . . . . . . . . F2
  886.  
  887. Toggle Insert Mode/Overtype Mode. . . . . . . . . . . . . . . . Insert
  888. Delete Character. . . . . . . . . . . . . . . . . . . . . . . . Delete
  889.   (In the Hex window, both hexades are deleted at once.)
  890.  
  891. Begin Block . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-A
  892.   Initiate Copy of Selected Block . . . . . . . . . . . . . . . Alt-C
  893.   Initiate Move of Selected Block . . . . . . . . . . . . . . . Alt-M
  894.   Delete Selected Block . . . . . . . . . . . . . . . . . . . . Alt-D
  895. Retrieve most recently selected Block for Pasting . . . . . . . Alt-P
  896.  
  897. Find text . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-F
  898. Find and Replace text . . . . . . . . . . . . . . . . . . . . . Alt-R
  899.  
  900. Save File . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-S
  901. Exit Program (with option to save the file) . . . . . . . . . . Alt-X
  902. Quit Program (same as Alt-X). . . . . . . . . . . . . . . . . . Alt-Q
  903. Undo All Changes since the most recent Save . . . . . . . . . . Alt-U
  904.  
  905. Select Screen Colors. . . . . . . . . . . . . . . . . . . . . . Alt-C
  906. Toggle Display All/Display only Printables in the text Window . Alt-Z
  907. Display Product Information . . . . . . . . . . . . . . . . . . Alt-I
  908. View Command Summary. . . . . . . . . . . . . . . . . . . . . . F1
  909.  
  910. Cancel an operation in progress . . . . . . . . . . . . . . . . Esc
  911.  
  912.                               The Screen Layout
  913.                               === ====== ====== 
  914.  
  915.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  916.  
  917.     Sector: 000   Byte: 000                    F1  - HELP
  918.             0           0                      F2  - Switch Window
  919.     overtype                                   ESC - Cancel Operation
  920.  
  921.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  922. 00  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  00
  923. 10  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  10
  924. 20  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  20
  925. 30  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  30
  926. 40  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  40
  927. 50  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  50
  928. 60  00 00 00 00                      00 00 00 00 00   ..            ..  60
  929. 70  00 00 00 00    the hex window    00 00 00 00 00   ..  the text  ..  70
  930. 80  00 00 00 00                      00 00 00 00 00   ..   window   ..  80
  931. 90  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  90
  932. A0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  A0
  933. B0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  B0
  934. C0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  C0
  935. D0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  D0
  936. E0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  E0
  937. F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  F0
  938.  
  939.     Size of File: 65536    Available Memory: 365160
  940.  
  941. When first coming up in Hexcalibur, you will notice two large windows taking up
  942. the majority of the screen.  The smaller window on the right side is the text
  943. window, consisting of the character translations of all the bytes in the file. 
  944. The larger one on the left side is the hex window, containing two hex characters
  945. for every byte in the file, one for the lower four bits and one for the upper
  946. four bits.  Each character in the text window has a direct correspondence across
  947. in the hex window, and vice versa.  The screen is laid out so that corresponding
  948. hex and text characters are always visible when editing.  When editing in the
  949. hex window, the corresponding character in the text window is simultaneously
  950. updated; when editing in the text window, the corresponding hex character pair
  951. is also updated.  You may edit in one window at a time and use the F2 command to
  952. switch windows.
  953.  
  954. The top line of the screen consists of the title, HEXCALIBUR and the name of the
  955. workfile being edited, including the name of the path to that file.  Other
  956. features displayed on the screen include the exact location (in sectors and
  957. bytes) of the cursor in the file.  This is displayed in the upper left hand
  958. corner of the screen directly under the title, HEXCALIBUR, and it is updated as
  959. the cursor moves through the file.
  960.  
  961. Beneath the position display is the mode display.  There are three separate
  962. modes:  overtype, insert mode, and block mode.  Overtype and insert mode can by
  963. toggled by the insert key.  Block mode is started by an Alt-A command, and no
  964. editing can take place as in the other two.
  965.  
  966. The bottom line contains the size of the file and the remaining available memory
  967. the editor may use.  The size of the file is updated as editing takes place. 
  968. The available memory changes as blocks of space are assigned, which is typically
  969. in blocks of 8K bytes.
  970.  
  971.                               Color Selections
  972.                               ===== ========== 
  973.  
  974.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  975.  
  976.     Sector:       Byte:                        F1  - HELP
  977.                                                F2  - Switch Window
  978.     overtype                                   ESC - Cancel Operation
  979.  
  980.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  981. 00                  Color Selections                  ...-------------  00
  982. 10                                                    ------||||||||||  10
  983. 20               ......................               ||||||||||||||||  20
  984. 30               .   Current Field:   .               ||||||||||||||||  30
  985. 40               .        TEXT        .               |||||-----------  40
  986. 50               ......................               ----------------  50
  987. 60                                                    ----------------  60
  988. 70    Left/Right cursors   Change text color          ----------------  70
  989. 80    Up/Down cursors      Change background color    ----------------  80
  990. 90                                                    ----------------  90
  991. A0    TAB                  Move to next field         ----------------  A0
  992. B0    Shift-TAB            Move to previous field     ----------------  B0
  993. C0                                                    ----------------  C0
  994. D0    Alt-D                Load default colors        ----------------  D0
  995. E0    ENTER                Return and save changes    ----------------  E0
  996. F0    ESC                  Return without save        ----------------  F0
  997.  
  998.     Size of File:          Available Memory:       
  999.  
  1000.  
  1001. All color selections are saved in a file named HC.FIL.  If this file is not
  1002. found when the program begins running, the editor will come up with its default
  1003. colors.  Another indication that it has not been found the HC.FIL file is that
  1004. the bottom of the title screen will display "To set screen colors, type Alt-C".
  1005.  
  1006. To enter the color selection menu once in the editor, use the Alt-C key. 
  1007.  
  1008. In response to the Alt-C command, the color selections screen will come up.  You
  1009. will be able to edit one color field at a time.  The field that is currently
  1010. being edited is displayed at the top center of the screen.  There are six
  1011. different color fields that you may edit.
  1012.  
  1013. While editing colors, the functions of the keyboard are redefined thusly:
  1014.  
  1015.  
  1016. Left/Right arrows
  1017. -----------------
  1018.  
  1019. Use the left and right arrow keys to change the current field's foreground text
  1020. color.
  1021.  
  1022.  
  1023. Up/Down arrows
  1024. --------------
  1025.  
  1026. Use the up and down arrow keys to change the current field's background color.
  1027.  
  1028.  
  1029. TAB
  1030. ---
  1031.  
  1032. The TAB key shifts the editor to the next field.
  1033.  
  1034.  
  1035. Shift-TAB
  1036. ---------
  1037.  
  1038. The Shift-TAB key shifts the editor to the previous field.
  1039.  
  1040.  
  1041. Alt-D
  1042. -----
  1043.  
  1044. Loads and displays the default colors of Hexcalibur.
  1045.  
  1046.  
  1047. ENTER
  1048. -----
  1049.  
  1050. Returns to Hexcalibur and saves the colors displayed on the screen to the HC.FIL
  1051. file.  These color selections are now permanently saved for all future runs of
  1052. Hexcalibur.
  1053.  
  1054.  
  1055. ESC
  1056. ---
  1057.  
  1058. Returns to Hexcalibur without saving the displayed colors. 
  1059.  
  1060.                                    Tutorial
  1061.                                    ======== 
  1062.  
  1063.  
  1064. To begin running Hexcalibur from a DOS prompt, enter the command:
  1065.  
  1066. hc [filename]
  1067.  
  1068. where the filename is the name of the file to be edited.  Although the filename
  1069. is optional, if it is not provided, Hexcalibur will immediately prompt you for a
  1070. file name.
  1071.  
  1072. Note:  If you have no file to start with, begin editing using the file named
  1073. SAMPLE1 supplied on the disk.
  1074.  
  1075. As you load Hexcalibur, the title screen will first appear on the screen.  As
  1076. the program loads the file, a counter at the bottom left hand corner of the
  1077. screen displays how many bytes are currently loaded.  As soon as the file is
  1078. loaded, press any key to enter the editor.
  1079.  
  1080. IF THIS IS THE FIRST TIME YOU ARE RUNNING HEXCALIBUR, you may want to change the
  1081. screen colors.  To do so, type Alt-C.  You may then change your screen colors as
  1082. described on the Color Selection Menu.  (For additional information on color
  1083. selection, see the section on "Custom Color Settings".)
  1084.  
  1085. As the editor comes up, your cursor will be located at the top left hand corner
  1086. of the hex window.  To begin, use the arrow keys to move the cursor around the
  1087. hex window.  Move to the end of a line and notice that the cursor wraps around
  1088. to the next line of the hex window instead of moving over to the text window.
  1089. To change windows use the F2 key.  This will move you to the corresponding
  1090. character in the text window.  Now move to the bottom of the screen and you will
  1091. see the file scroll up while the cursor holds its position. If you press the
  1092. home key, the cursor will move to the beginning of the line of the current
  1093. window.  The end key will move the cursor to the end of the line of the current
  1094. window.  Try a few page up and page downs.  The entire file will shift a page
  1095. (half of a sector) up or down.  For larger jumps through the file you will want
  1096. to use the Alt-(0..9) keys.  Try pressing Alt-3.  The cursor will move to a
  1097. position 30% of the way through the file.
  1098.  
  1099.  
  1100. Editing in Overtype Mode
  1101. ------------------------
  1102.  
  1103. To start this sample editing session, do the following:
  1104.  
  1105. 1. Press the insert key to change the program into Overtype mode.
  1106. 2. Press function key F2 to switch to the text window.
  1107.  
  1108. Now begin typing some text characters.  You will notice that the characters you
  1109. are typing are overwriting the existing characters.  Also notice that the
  1110. corresponding characters in the hex window have changed their values in
  1111. accordance with the changes you are making in the text window.
  1112.  
  1113. Now press function key F2 again, and you will move to the hex window.  While you
  1114. are in the hex window, you can only use hexadecimal characters:  0-9 and A-F. 
  1115. As you type, you will notice that, as in the text window, the characters you
  1116. type will overwrite the character which the cursor sits on.  The corresponding
  1117. text characters are updated as well.
  1118.  
  1119.  
  1120. Editing in Insert Mode
  1121. ----------------------
  1122.  
  1123. Now press the insert key and you will notice that, at the upper left hand corner
  1124. of the screen, it now says "insert mode" where it used to say "overtype."  Press
  1125. the F2 key so that your cursor is in the text window.  Begin typing, and you
  1126. will notice that the text from the cursor forward gets shifted forward, and the
  1127. typed character is inserted at the cursor.  The cursor is also shifted one space
  1128. to the right.  Again, the characters in the hex window are adjusted.
  1129.  
  1130. Move over to the hex window (by pressing F2) and try typing there.  You will
  1131. notice that insert mode in the hex window works a bit differently.  Move the
  1132. cursor to the left hex character of a pair.  Type a number and watch all of the
  1133. pairs of hex characters shift forward, from the cursor on.  The number pressed
  1134. will be inserted into the right hex character and the left hex character will
  1135. turn to 0.  The cursor is moved to the right hex character where the typed
  1136. number sits.  If you type another number, the right hex character will shift to
  1137. become the left hex character, and the character keyed becomes the right hex
  1138. character.  The cursor then moves another character to the right.
  1139.  
  1140.  
  1141.  
  1142. Working with Blocks
  1143. -------------------
  1144.  
  1145. In order to work with blocks you must always begin by pressing Alt-A (begin
  1146. block).  When you do so, you will notice that the mode indicator towards the
  1147. upper-left hand corner of the screen is flashing "block mode" and the character
  1148. your cursor sits on is now highlighted with a block mode color setting.  You are
  1149. now in block mode.  Note: You cannot edit text in block mode, but you can switch
  1150. freely between the hex and text window with F2.  Try moving the cursor around
  1151. the screen and you will see that the text between the start of the block and the
  1152. current position is highlighted.  Now hit F2 to switch to the opposite window
  1153. and notice that the block has remained the same.  When you have decided on a
  1154. block, look directly above the windows to see the block options:
  1155.   Alt-C = copy block   Alt-M = move block   Alt-D = delete block
  1156.  
  1157. First try a block copy by pressing Alt-C.  The block highlight will disappear,
  1158. not the text, and above the windows it will say "Move cursor to destination,
  1159. press ENTER." Do as the instructions say and you will see the formerly
  1160. highlighted text reappear where the cursor sits.  The cursor will appear at the
  1161. end of the copied block.
  1162.  
  1163. Try the same procedure with move block (Alt-M) this time. You must start a new
  1164. block again with Alt-A.  Notice that when you actually press Alt-M, the
  1165. highlighted text disappears instead of remaining as with an Alt-C.  Pressing
  1166. Enter at the destination will act the same as with an Alt-C.
  1167.  
  1168. Now try the procedure with delete block (Alt-D) after starting another block
  1169. with Alt-A.  When pressing Alt-D, the highlighted block is removed and you are
  1170. no longer in block mode.
  1171.  
  1172. Using Paste Block
  1173. -----------------
  1174.  
  1175. Now imagine that you accidentally deleted the wrong block.  It will be easy to
  1176. recover this deleted block with Paste Block (Alt-P).  When pasting a block you
  1177. must NOT be in block mode.  The last block used in block mode is automatically
  1178. saved in a block buffer and can be retrieved with Alt-P.  Press Alt-P now and
  1179. above the windows it will say "Move cursor to destination, press ENTER."  If the
  1180. cursor still sits in the same place when the delete was made, you do not need to
  1181. move it.  Press Enter and the block will be replaced.  If you wish to do another
  1182. Paste block with the same block, you may.  The block remains in the buffer until
  1183. it is replaced, when block mode is used.
  1184.  
  1185.                             Basic Editing Features
  1186.                             ===== ======= ======== 
  1187.  
  1188. Overtype
  1189. --------
  1190.  
  1191. In overtype mode, anything typed on to the screen will overwrite existing
  1192. characters on the screen.  In the hex window, the overwrite will take place over
  1193. the character which the cursor is on, as in the text window.  In the hex window,
  1194. it edits only the upper or lower eight bits of the corresponding text character
  1195. in the text window.  The insert key toggles overtype and insert mode.
  1196.  
  1197.  
  1198. Insert
  1199. ------
  1200.  
  1201. In insert mode, anything typed on to the screen will cause all text, from the
  1202. cursor forward, to move up a space, and the typed character to be placed at the
  1203. cursor.  When typing in the hex window, the first character typed will be
  1204. inserted as the rightmost 4 bits and prefixed by a zero; the second key typed
  1205. will cause the first character to be shifted to the left and then the second
  1206. character will become the lower 4 bits.  For example, if we have: 
  1207.  
  1208. 90 91 92 93 94 95 96 97 98 99 9a 9b 9c 9d 9e 9f
  1209.  
  1210. and we are in insert mode with the cursor over the "9" of "98" and we type a
  1211. "6", the display will change to read:
  1212.  
  1213. 90 91 92 93 94 95 96 97 06 98 99 9a 9b 9c 9d 9e
  1214.  
  1215. Now the cursor will be over the "6" of the "06" and the characters from "98" up
  1216. will have been shifted one full position to the right.  If (note we're still in
  1217. insert mode) we now (while over the "6") type "7", the "6" will be moved to the
  1218. left and the "7" inserted after it.  The display will then read:
  1219.  
  1220. 90 91 92 93 94 95 96 97 67 98 99 9a 9b 9c 9d 9e
  1221.  
  1222. The cursor will be left over the "9" of the "98", which is the next available
  1223. position on the screen.
  1224.  
  1225. The insert key toggles overtype and insert mode.
  1226.  
  1227.  
  1228. Delete
  1229. ------
  1230.  
  1231. When deleting a character, all text beyond that character is shifted back to
  1232. fill the void.  In the hex window, both hex characters are deleted with one
  1233. keystroke.
  1234.  
  1235.  
  1236. Change Display (Alt-Z)
  1237. ----------------------
  1238.  
  1239. This will change the text window to display either all printable characters or
  1240. just ASCII characters.
  1241.  
  1242.  
  1243. Switch Between Hex and Character Edit (F2)
  1244. ------------------------------------------
  1245.  
  1246. This will shift windows to the corresponding character in the other window. 
  1247. This allows you to edit using either hex characters or ASCII characters.
  1248.  
  1249.  
  1250. Color Selection (Alt-C)
  1251. -----------------------
  1252.  
  1253. Alt-C will bring up the color selection help screen.  There are six different
  1254. color fields to edit: text, background, special characters, help screens, block
  1255. characters, and non-printable characters (hex character who have no printable
  1256. translation).  The current field being edited is displayed in the top half of
  1257. the help screen, and the cursor is located at one of the characters of that
  1258. field.  The arrow keys change the color of the current field and the Tab keys
  1259. shift fields.  ESC will cancel all color changes and ENTER will save them.
  1260.  
  1261.  
  1262.  
  1263.  
  1264.                           Moving Around in the File
  1265.                           ====== ====== == === ==== 
  1266.  
  1267. Arrow Keys
  1268. ---------- 
  1269.  
  1270. Using the arrow keys will move the cursor throughout the file.  When reaching
  1271. the end of a line or a page, the screen and cursor will automatically wrap. 
  1272. Note: The arrow keys will not move the cursor from one window to another.
  1273.  
  1274.  
  1275. Page Up, Page Down
  1276. ------------------
  1277.  
  1278. Paging up and down will shift the file exactly one screen page (256 bytes)
  1279. accordingly.
  1280.  
  1281.  
  1282. Home
  1283. ---- 
  1284.  
  1285. Moves the cursor to the beginning of the line of the current window.
  1286.  
  1287.  
  1288. End
  1289. --- 
  1290.  
  1291. Moves the cursor to the end of the line of the current window.
  1292.  
  1293.  
  1294. Beginning of File (Alt-B)
  1295. -------------------------
  1296.  
  1297. Moves the cursor to the beginning of the file.
  1298.  
  1299.  
  1300. End of File (Alt-E)
  1301. -------------------
  1302.  
  1303. Moves the cursor to the end of the file.
  1304.  
  1305.  
  1306. Move to x% of file (Alt-0..9)
  1307. -----------------------------
  1308.  
  1309. Moves to a certain percentage of the file (i.e., Alt-3 moves the cursor to a
  1310. position at 30% of the file size).
  1311.  
  1312.  
  1313. Goto (Alt-G)
  1314. ------------ 
  1315.  
  1316. Lets you specify exactly where in the file you want to move to, using sector and
  1317. byte values.
  1318.  
  1319.  
  1320. Find (Alt-F)
  1321. ------------
  1322.  
  1323. Searches for a given string in hex or text, depending on the current window, and
  1324. then moves the cursor to the position of the string if found.
  1325.  
  1326.  
  1327. Find and Replace (Alt-R)
  1328. ------------------------
  1329.  
  1330. Alt-R prompts for two strings:  a target string and a replacement string.  Each
  1331. time the target string is found in the file, you are asked if you want the
  1332. replacement to be done.  The possible responses are:
  1333.  
  1334.   y -- yes:  replace this one occurrence of the target string with the
  1335.              replacement string.
  1336.   n -- no:   skip this occurrence of the target string but continue searching
  1337.              for the next occurrence of the target.
  1338.   r -- replace all:  replace all remaining occurrences of the target string
  1339.              without prompting again.
  1340.  
  1341. The ESC key may be used to cancel the Replace operation.
  1342.  
  1343. Any time while a Find or Replace is in progress, pressing any key on the
  1344. keyboard will stop the operation, and the prompt 
  1345.  
  1346. ENTER = continue / ESC = break
  1347.  
  1348. will appear.  When this happens, press the ENTER key to continue the operation. 
  1349. To abort the operation, press the Escape key.
  1350.  
  1351.  
  1352.                              Block Mode Editing
  1353.                              ===== ==== ======= 
  1354.  
  1355. Block Mode
  1356. ----------
  1357.  
  1358. Block mode is initiated by executing an Alt-A.  In block mode, blocks of text
  1359. may be copied, moved, or deleted, regardless of which window you are in.  Both
  1360. windows will be updated to the change.  Text cannot be edited in block mode.
  1361.  
  1362. Begin Block (Alt-A)
  1363. -------------------
  1364.  
  1365. Turns block mode on and places a marker at the current position of the cursor. 
  1366. The cursor then should be moved to the position at the end of a desired block
  1367. before executing a block action, i.e. copy block.
  1368.  
  1369. Delete Block (Alt-D)
  1370. --------------------
  1371.  
  1372. To execute a delete block, you must be in block mode.  When the desired block to
  1373. remove is highlighted, an Alt-D will delete it.
  1374.  
  1375. Note:  In case of accidental delete, the block is still available in memory.  It
  1376. may be retrieved by typing Alt-P.  After typing Alt-P, move the cursor to the
  1377. location where you would like to put the accidentally deleted block, and press
  1378. ENTER.  The block will be inserted back into the file.
  1379.  
  1380. Blocks are only saved to one level deep.  Once a new block has been selected,
  1381. the previous block is no longer retrievable.
  1382.  
  1383. Copy Block (Alt-C)
  1384. ------------------
  1385.  
  1386. To execute a copy block, you must be in block mode.  When the desired block to
  1387. copy is highlighted, press Alt-C.  The highlighting of the text will disappear. 
  1388. Move the cursor to the desired location where the block is to be copied and
  1389. press Enter.
  1390.  
  1391. Move Block (Alt-M)
  1392. ------------------
  1393.  
  1394. To move a block, you must be in block mode.  When the desired block to move is
  1395. highlighted, press Alt-M.  The highlighted text will be removed.  Move the
  1396. cursor to the desired destination location and press Enter.
  1397.  
  1398. Paste Block (Alt-P)
  1399. -------------------
  1400.  
  1401. Alt-P will paste the most recently selected block to any position in the file. 
  1402. Alt-P is pressed OUTSIDE of block mode.  It causes the program to retrieve the
  1403. most recently selected block and make it available for insertion into the file. 
  1404. This may be a block that was previously deleted, moved, or copied.  As with move
  1405. block and copy block, after pressing Alt-P, move the cursor to the location in
  1406. the file where you desire the block to be inserted, and press ENTER.
  1407.  
  1408.                                  File Options
  1409.                                  ==== ======= 
  1410.  
  1411. Undo changes (Alt-U)
  1412. --------------------
  1413.  
  1414. Undoes changes in the file since the last save was made. 
  1415.  
  1416.  
  1417. Save File (Alt-S)
  1418. -----------------
  1419.  
  1420. Alt-S causes a small menu to appear in the Hex window.  You are given the option
  1421. to rename the file and then save it.  To actually save the file, you must press
  1422. the ENTER key in the last box on the menu.  To cancel the save operation, press
  1423. the Escape key at any time.
  1424.  
  1425. If there already exists a file with the name you are attempting to use, you will
  1426. be given the option of making a backup file (with the .BAK extension) when the
  1427. save takes place.
  1428.  
  1429. Upon completion of the save, the program returns to normal operation.
  1430.  
  1431.  
  1432. Exit Program (Alt-Q)
  1433. --------------------
  1434.  
  1435. Same as Alt-X.
  1436.  
  1437.  
  1438. Exit Program with Optional Save (Alt-X)
  1439. ---------------------------------------
  1440.  
  1441. Alt-X exits the program and gives an option to save the file.  ESC may used to
  1442. escape the exit altogether.
  1443.  
  1444. Once you have moved to the Save menu via Alt-X, it is impossible to get back to
  1445. the program.  Pressing ESC while in the Save menu will exit the program, and the
  1446. file will NOT be saved.  (A notice to this effect is posted at the bottom of the
  1447. Save menu when Save is entered via Alt-X.)
  1448.  
  1449.  
  1450.  
  1451.