home *** CD-ROM | disk | FTP | other *** search
/ PC Interdit / pc-interdit.iso / share / hexcalib / hcdoc.txt < prev    next >
Text File  |  1994-09-20  |  41KB  |  978 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 H E X C A L I B U R
  17.                                 = = = = = = = = = =
  18.  
  19.  
  20.                             The
  21.  
  22.                                       Hex
  23.  
  24.                                                  Editor
  25.  
  26.  
  27.                                    Version 1.02
  28.  
  29.  
  30.                             Reference            Manual
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                             Gregory Publishing Company
  50.                             333 Cobalt Way, Suite 107
  51.                             Sunnyvale, California, 94086
  52.                                   (408) 727-4660
  53.  
  54.  
  55.                      Copyright (c) 1989 Gregory Publishing Company
  56.                                  All Rights Reserved
  57.                                    LICENSE
  58.                                    =======
  59.  
  60.  
  61. All versions of "HEXCALIBUR -- The Hex Editor" are NOT public domain software,
  62. nor are they free software.
  63.  
  64. Non-registered users are granted a limited license to use Hexcalibur on a trial
  65. basis for the purpose of determining whether or not it may be suitable to their
  66. needs.  Any use of Hexcalibur, except for this limited purpose, requires
  67. registration.  Any use of copies of Hexcalibur that are not registered by any
  68. individual, corporation, private enterprise, governmental agency, or other
  69. entity or institution is strictly forbidden.
  70.  
  71. Registration permits a user the license to use Hexcalibur on a single computer. 
  72. The registered user may use Hexcalibur on more than one computer, but it must
  73. not be used on two or more computers at the same time.
  74.  
  75. No user may modify Hexcalibur in any way, including, but not limited to,
  76. decompiling, disassembling, or otherwise reverse engineering the program.
  77.  
  78. All users are encouraged to copy Hexcalibur for the trial use of others subject
  79. to the above mentioned restrictions and also subject to the following
  80. conditions:
  81.  
  82. (1) Hexcalibur must be copied without modification, complete with the file
  83.     containing this license information.
  84.  
  85. (2) Verbal or written notice must be given the person receiving the copy that
  86.     use of Hexcalibur requires the payment of a $30.00 registration fee to
  87.     Gregory Publishing Company.
  88.  
  89. (3) All support files must be included with the copy.  These files are:
  90.       HC.EXE        --   The Hexcalibur program.
  91.       HCDOC.TXT     --   This document.
  92.       SAMPLE1.TXT   --   A sample file of data characters.
  93.       HCMONO.FIL    --   The black and white colors file.
  94.       Any README or HEXNOTES files that may be on the original disk.
  95.  
  96. (4) Hexcalibur may not be distributed along with any other product.
  97.  
  98. Operators of electronic bulletin board systems (Sysops) may post Hexcalibur for
  99. downloading by their users providing the above conditions are met.
  100.  
  101. Distributors of public domain or user supported software may distribute copies
  102. of Hexcalibur subject to the above conditions.
  103.  
  104. An order form is included in this file which may be used to register your copy
  105. of Hexcalibur.
  106.  
  107.  
  108. THANK YOU FOR YOUR SUPPORT!
  109.                                    WARRANTY
  110.                                    ========
  111.  
  112.  
  113. Gregory Publishing Company makes no warranty of any kind, express or implied,
  114. including without limitation, any warranties or merchantability and/or fitness
  115. for a particular purpose.  Gregory Publishing Company shall not be liable for
  116. any damages, whether direct, indirect, special, or consequential arising from a
  117. failure of this program to operate in the manner desired by the user. Gregory
  118. Publishing Company shall not be liable for any damage to data or property which
  119. may be caused directly or indirectly by use of this program.
  120.  
  121. IN NO EVENT SHALL GREGORY PUBLISHING COMPANY BE LIABLE TO YOU FOR ANY DAMAGES,
  122. INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL
  123. DAMAGES ARISING OUT OF YOUR USE OF OR INABILITY TO USE HEXCALIBUR, OR FOR ANY
  124. CLAIM BY ANY OTHER PARTY.
  125.  
  126.                              ORDERING  INFORMATION
  127.                              ========  ===========
  128.  
  129.  
  130. Registration of Hexcalibur licenses you to use the product for any reasonable
  131. purpose as you need.  Users need only register one version of Hexcalibur. 
  132. Registration automatically includes licensed use of all upgrades.
  133.  
  134. The version of Hexcalibur on this disk is version 1.02, dated August, 1989.
  135. Depending upon how long after August, 1989, you are reading this, there may be
  136. later versions of Hexcalibur available.  We have a large list of enhancements
  137. already planned for future versions.
  138.  
  139. Upon receipt of your payment for registration, we will automatically ship you
  140. (providing you supply a clearly written mailing address and phone number) the
  141. most current version of the program.  Additional updates are available to
  142. registered users ONLY for a nominal fee of $10.00 per disk.
  143.  
  144. Please use the order form supplied on the next page when placing an order.
  145.  
  146.  
  147.  
  148.  
  149. NOTICE TO CUSTOMERS OUTSIDE NORTH AMERICA:
  150.    Please send only checks that are drawn on a US Bank that are payable in
  151.    US Dollars.  Please add an additional $1.50 to cover postage for the
  152.    mailing of the diskette outside the USA.
  153.  
  154.                                  ORDER      FORM
  155.                                  =====      ====
  156.                              Gregory Publishing Company
  157.                           333 Cobalt Way, Suite 107, Dept. F1
  158.                              Sunnyvale, California  94086
  159.                                    (408)  727-4660
  160. Quantity   Item
  161. --------   ----
  162.  
  163. ________   Registration for Hexcalibur ............. @ $30.00 ea  $ ___________
  164.              (Includes one copy on disk of the most current version.)
  165.  
  166. ________   Upgrade of Hexcalibur ................... @ $10.00 ea  $ ___________
  167.              (For already registered users only.)
  168.  
  169.  
  170. Recordings from Gregory Publishing Company on cassette tape:
  171. ------------------------------------------------------------
  172.  
  173. ________  Synthesized Sullivan, volume I ........... @ $ 9.00 ea  $ ___________
  174.             (Gilbert & Sullivan overtures orchestrated on a synthesizer.)
  175.  
  176. ________  Synthesized Sullivan, volume II .......... @ $ 9.00 ea  $ ___________
  177.  
  178.  
  179. Documentation for Unisys A-Series Computer Systems:
  180. ---------------------------------------------------
  181.  
  182. ________  The Complete CANDE Primer ................ @ $30.00 ea  $ ___________
  183.  
  184. ________  The Extended ALGOL Primer, volume I ...... @ $25.00 ea  $ ___________
  185.  
  186. ________  The Extended ALGOL Primer, volume II ..... @ $29.00 ea  $ ___________
  187.  
  188. ________  The Extended ALGOL Primer, volume III .... @ $31.00 ea  $ ___________
  189.  
  190. ________  A-Series DMSII Programming ............... @ $40.00 ea  $ ___________
  191.  
  192. ________  Gregory's A-Series Technical Journal ..... @$225.00 ea  $ ___________
  193.             (Annual subscription, 10 issues per year.)
  194.                                                        SUBTOTAL   $ ___________
  195.  
  196.                    California Residents add applicable Sales Tax  $ ___________
  197.                      (No sales tax on Journal subscriptions)
  198.  
  199.                                                           TOTAL   $ ___________
  200.  
  201.  
  202. Name: _____________________________________________________________
  203.  
  204. Company: __________________________________________________________
  205.  
  206. Address: __________________________________________________________
  207.  
  208.          __________________________________________________________
  209.  
  210. Phone:   __________________________________________________________
  211.  
  212. Pre-paid orders only.  Purchase orders o.k. if TOTAL amount exceeds $100.00.
  213.                       Corporate/Government/Multiple Users
  214.                       ===================================
  215.  
  216.  
  217. All corporate, business, government, and other commercial users of Hexcalibur
  218. must register.
  219.  
  220. The registration fee for the first license of Hexcalibur is $30.00. This price
  221. includes the delivery of an updated disk which will be mailed to the licensee.
  222.  
  223. Additional registration fees for users AT THE SAME ORGANIZATION are $25.00 each
  224. for 2 - 20 users and $20.00 each per additional user after that.  This fee is
  225. for registration only.  Users are expected to make their own copies of the
  226. updated software from the disk sent the original licensee.  NO DISK WILL BE
  227. MAILED TO A CUSTOMER WHO AVAILS HIMSELF OF ANY DISCOUNTED REGISTRATION FEE.
  228.  
  229. Example:  If your company has five users that want to use Hexcalibur, the
  230. license fee for all five would be:
  231.  
  232.                   $30.00 (for the original license)
  233. + ($25.00 x 4) = $100.00 (for the other four users) 
  234.                  -------
  235.                  $130.00 TOTAL registration fee
  236.  
  237. The first user would be sent an updated disk, and the other four would obtain
  238. copies from that user.
  239.  
  240. If your company has 25 users, all of whom are going to use Hexcalibur, the
  241. registration fee would be:
  242.  
  243.                    $30.00 (for the original license)
  244. + ($25.00 x 20) = $500.00 (for users #2 - 20)
  245. + ($20.00 x 5)  = $100.00 (for users #21 -25)
  246.                   -------
  247.                   $630.00 TOTAL registration fee
  248.  
  249. Not all registrations need be made at once.  After payment of the first
  250. registration, you may take advantage of the discount schedule by adding new
  251. users.  Simply include your ORIGINAL LICENSE NUMBER (which is provided on the
  252. disk mailed to you) with your order, and you will receive the discount.
  253.  
  254.  
  255.  
  256. NOTICE:  YOU MAY NOT USE HEXCALIBUR WITHIN YOUR ORGANIZATION WITHOUT A PRIOR
  257. PURCHASE OR LICENSE ARRANGEMENT.
  258.                                   Introduction           
  259.                                   ============
  260.  
  261. Hexcalibur is a high quality editor designed expressly for examining, modifying,
  262. or otherwise manipulating disk files in their raw, or binary, format.  You may
  263. examine and change any part of a file using either hexadecimal characters (4-
  264. bit characters) or standard ASCII characters.  Hexcalibur is especially useful
  265. for examining and editing files that standard ASCII editors either will not read
  266. or will read but display in a format that is not terribly useful.
  267.  
  268. With Hexcalibur, you can:
  269.  
  270. (1) Examine and change the contents of WordStar or other specially encoded
  271.     files.
  272.  
  273. (2) Filter incompatible codes out of files.
  274.  
  275. (3) Convert Unix or BTOS text files (line terminator = 0a) to MS-DOS format
  276.     (line terminator = 0d0a) or to MacIntosh format (line terminator = 0d),
  277.     or vice versa.
  278.  
  279. (4) Examine and change the printer codes in a file to be printed.
  280.  
  281. (5) Search game programs for clues in the text portion of the codefile.
  282.  
  283. (6) Examine and change soft font data files for laser printers.
  284.  
  285. (7) Examine incoming .COM and .EXE files for software virus patterns and,
  286.     possibly, eradicate them.
  287.  
  288. ...and much more!  New ideas for using this product come to mind every day!
  289.  
  290. The key to doing any of these things is THAT YOU KNOW WHAT YOU ARE DOING.
  291. Hexcalibur does not advise you or attempt to protect you from yourself. It will
  292. let you do anything to a file at the binary level.  If you change an executable
  293. codefile, you had better know what you are doing!  But for those who know,
  294. Hexcalibur provides a convenient tool for making the kind of changes that, until
  295. now, were extremely difficult to do!
  296.  
  297. An immediate use of Hexcalibur can be illustrated using this documentation file
  298. you are now reading.  This file is formatted for printing on any printer that
  299. uses the sequence "Form Feed/Carriage Return" ("0c0d" character sequence) as a
  300. page separator.  If your printer does not use that character sequence, but uses
  301. something else, you can easily change this file to print on your printer.
  302.  
  303. Suppose, for example, that your printer uses the hex character sequence "1f" as
  304. its form feed instruction.  You could change every "0c0d" in this file to "1f"
  305. by taking the following steps:
  306.  
  307. Beginning at the MS-DOS prompt, proceed as follows.  (The step numbers are for
  308. reference purposes only.  Do not type them in.  "Alt" refers to the "Alt key",
  309. and <ENTER> refers to the "ENTER key.")
  310.  
  311. 1. HC HCDOC.TXT
  312.  
  313. 2. press any key to leave the greeting screen
  314.  
  315. 3. Alt-R
  316.  
  317. 4. 0c0d <ENTER> 5. 1f <ENTER>
  318.  
  319. 6. when the confirm prompt appears, type:
  320.      r
  321.  
  322. 7. Alt-X
  323.  
  324. 8. y
  325.  
  326. 9. <ENTER>
  327.  
  328. Now print the file using the MS-DOS PRINT command, and you will find that it
  329. will eject pages properly on your printer that uses "1f" as a page eject
  330. instruction.
  331.  
  332.  
  333. The pages that follow provide instructions on how to use Hexcalibur. Hexcalibur
  334. has been designed for intuitive operation.  Most of the commands are accessed by
  335. different Alt keys.  (For example, Alt-B moves to the beginning of the file,
  336. Alt-E to the end, Alt-F is FIND, Alt-R is REPLACE, and so forth.) Wherever
  337. possible, standard DOS keys have been used for various paging functions.  (For
  338. example, the cursor arrows work as expected; if you move to a line off of the
  339. screen, the screen will scroll one line; Page Up and Page Down may be used to
  340. move through the file in 256-character blocks.)
  341.  
  342. An on-line summary of the commands is readily available by pressing function key
  343. F1.  Use this screen for quick reference to any command.
  344.  
  345. The screen colors are user-configurable.  If the appearance of the screen is not
  346. right for your computer, type Alt-C.  This will bring up the Color Menu. Once in
  347. the Color Menu, use the cursor arrows to change colors.  The Left and Right
  348. arrows change the foreground color, while the Up and Down arrows change the
  349. background color.  When you have your screen colors set as desired, press the
  350. ENTER key to save them.  They will be saved in a file called HC.FIL and will be
  351. available for all future runs of Hexcalibur.
  352.  
  353.                                   Installation
  354.                                   ============
  355.  
  356. To install Hexcalibur onto a hard disk system, proceed as follows:
  357.  
  358. 1. Insert the floppy into a floppy drive.  (We will assume you are using
  359.    drive A.)
  360.  
  361. 2. Select the drive you want the program to run from.  For example, if you want
  362.    the program on drive C, enter:
  363.      C:
  364.  
  365. 3. Change to the directory you want the program to run from.  For example, to
  366.    put the program under the directory DOS, enter:
  367.      CD DOS
  368.    For best results, put Hexcalibur into a directory that is part of your
  369.    normal PATH.
  370.  
  371. 4. COPY A:*.*
  372.  
  373. 5. Set your screen colors.  To do this, enter:
  374.      HC SAMPLE1.TXT
  375.      Alt-C
  376.      Select your colors as described in "Color Selections" (later in this
  377.        document).
  378.      Exit the color menu by pressing the ENTER key.
  379.      Exit the program (if desired) by entering:
  380.        Alt-X
  381.  
  382.    Your screen color selections are now saved in a location that is visible
  383.    to your DOS PATH.  Hexcalibur will therefore find the color file every
  384.    time you run it.  (You can also make additional color files under other
  385.    directories if you wish to use different colors in different locations.)
  386.  
  387. 6. Mail in your Registration on the enclosed order form.  If possible, please
  388.    let us know to what use you plan to put this program to.
  389.  
  390. 7. Make a copy of the original diskette and give it to a friend.
  391.                                    Hexcalibur
  392.                                    ==========
  393.  
  394.                               Command Summary List
  395.                               --------------------
  396. Function                                                        Key Sequence
  397. --------                                                        ------------
  398.  
  399. Move 1 character to the left. . . . . . . . . . . . . . . . . . Left Arrow
  400. Move 1 character to the right . . . . . . . . . . . . . . . . . Right Arrow
  401. Move Up 1 line; scroll 1 line if at top of screen . . . . . . . Up Arrow
  402. Move Down 1 line; scroll 1 line if a bottom of screen . . . . . Down Arrow
  403.   (Each line is 16 characters long.)
  404. Move Up 1 page. . . . . . . . . . . . . . . . . . . . . . . . . Page Up
  405. Move Down 1 page. . . . . . . . . . . . . . . . . . . . . . . . Page Down
  406.   (Each page is 256 characters in length.)
  407.  
  408. Beginning of line . . . . . . . . . . . . . . . . . . . . . . . Home
  409. End of line . . . . . . . . . . . . . . . . . . . . . . . . . . End
  410. Beginning of file . . . . . . . . . . . . . . . . . . . . . . . Alt-B or Alt-0
  411. Move in 10% of the file . . . . . . . . . . . . . . . . . . . . Alt-1
  412. Move in 20% of the file . . . . . . . . . . . . . . . . . . . . Alt-2
  413. Move in 30% of the file . . . . . . . . . . . . . . . . . . . . Alt-3
  414. Move in 40% of the file . . . . . . . . . . . . . . . . . . . . Alt-4
  415. Move in 50% of the file . . . . . . . . . . . . . . . . . . . . Alt-5
  416. Move in 60% of the file . . . . . . . . . . . . . . . . . . . . Alt-6
  417. Move in 70% of the file . . . . . . . . . . . . . . . . . . . . Alt-7
  418. Move in 80% of the file . . . . . . . . . . . . . . . . . . . . Alt-8
  419. Move in 90% of the file . . . . . . . . . . . . . . . . . . . . Alt-9
  420. End of file . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-E
  421.  
  422. Go to specific sector and byte. . . . . . . . . . . . . . . . . Alt-G
  423.   (Type in the desired sector and byte number and press ENTER.)
  424. Switch between Hex Window and Text Window . . . . . . . . . . . F2
  425.  
  426. Toggle Insert Mode/Overtype Mode. . . . . . . . . . . . . . . . Insert
  427. Delete Character. . . . . . . . . . . . . . . . . . . . . . . . Delete
  428.   (In the Hex window, both hexades are deleted at once.)
  429.  
  430. Begin Block . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-A
  431.   Initiate Copy of Selected Block . . . . . . . . . . . . . . . Alt-C
  432.   Initiate Move of Selected Block . . . . . . . . . . . . . . . Alt-M
  433.   Delete Selected Block . . . . . . . . . . . . . . . . . . . . Alt-D
  434. Retrieve most recently selected Block for Pasting . . . . . . . Alt-P
  435.  
  436. Find text . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-F
  437. Find and Replace text . . . . . . . . . . . . . . . . . . . . . Alt-R
  438.  
  439. Save File . . . . . . . . . . . . . . . . . . . . . . . . . . . Alt-S
  440. Exit Program (with option to save the file) . . . . . . . . . . Alt-X
  441. Quit Program (same as Alt-X). . . . . . . . . . . . . . . . . . Alt-Q
  442. Undo All Changes since the most recent Save . . . . . . . . . . Alt-U
  443.  
  444. Select Screen Colors. . . . . . . . . . . . . . . . . . . . . . Alt-C
  445. Toggle Display All/Display only Printables in the text Window . Alt-Z
  446. Display Product Information . . . . . . . . . . . . . . . . . . Alt-I
  447. View Command Summary. . . . . . . . . . . . . . . . . . . . . . F1
  448.  
  449. Cancel an operation in progress . . . . . . . . . . . . . . . . Esc
  450.                               The Screen Layout
  451.                               === ====== ====== 
  452.  
  453.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  454.  
  455.     Sector: 000   Byte: 000                    F1  - HELP
  456.             0           0                      F2  - Switch Window
  457.     overtype                                   ESC - Cancel Operation
  458.  
  459.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  460. 00  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  00
  461. 10  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  10
  462. 20  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  20
  463. 30  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  30
  464. 40  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  40
  465. 50  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  50
  466. 60  00 00 00 00                      00 00 00 00 00   ..            ..  60
  467. 70  00 00 00 00    the hex window    00 00 00 00 00   ..  the text  ..  70
  468. 80  00 00 00 00                      00 00 00 00 00   ..   window   ..  80
  469. 90  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  90
  470. A0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  A0
  471. B0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  B0
  472. C0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  C0
  473. D0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  D0
  474. E0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  E0
  475. F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................  F0
  476.  
  477.     Size of File: 65536    Available Memory: 365160
  478.  
  479. When first coming up in Hexcalibur, you will notice two large windows taking up
  480. the majority of the screen.  The smaller window on the right side is the text
  481. window, consisting of the character translations of all the bytes in the file. 
  482. The larger one on the left side is the hex window, containing two hex characters
  483. for every byte in the file, one for the lower four bits and one for the upper
  484. four bits.  Each character in the text window has a direct correspondence across
  485. in the hex window, and vice versa.  The screen is laid out so that corresponding
  486. hex and text characters are always visible when editing.  When editing in the
  487. hex window, the corresponding character in the text window is simultaneously
  488. updated; when editing in the text window, the corresponding hex character pair
  489. is also updated.  You may edit in one window at a time and use the F2 command to
  490. switch windows.
  491.  
  492. The top line of the screen consists of the title, HEXCALIBUR and the name of the
  493. workfile being edited, including the name of the path to that file.  Other
  494. features displayed on the screen include the exact location (in sectors and
  495. bytes) of the cursor in the file.  This is displayed in the upper left hand
  496. corner of the screen directly under the title, HEXCALIBUR, and it is updated as
  497. the cursor moves through the file.
  498.  
  499. Beneath the position display is the mode display.  There are three separate
  500. modes:  overtype, insert mode, and block mode.  Overtype and insert mode can by
  501. toggled by the insert key.  Block mode is started by an Alt-A command, and no
  502. editing can take place as in the other two.
  503.  
  504. The bottom line contains the size of the file and the remaining available memory
  505. the editor may use.  The size of the file is updated as editing takes place. 
  506. The available memory changes as blocks of space are assigned, which is typically
  507. in blocks of 8K bytes.
  508.                               Color Selections
  509.                               ===== ========== 
  510.  
  511.     HEXCALIBUR             Workfile: C:\HEXCAL\NONAME.TXT
  512.  
  513.     Sector:       Byte:                        F1  - HELP
  514.                                                F2  - Switch Window
  515.     overtype                                   ESC - Cancel Operation
  516.  
  517.      0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F   0123456789ABCDEF 
  518. 00                  Color Selections                  ...-------------  00
  519. 10                                                    ------||||||||||  10
  520. 20               ......................               ||||||||||||||||  20
  521. 30               .   Current Field:   .               ||||||||||||||||  30
  522. 40               .        TEXT        .               |||||-----------  40
  523. 50               ......................               ----------------  50
  524. 60                                                    ----------------  60
  525. 70    Left/Right cursors   Change text color          ----------------  70
  526. 80    Up/Down cursors      Change background color    ----------------  80
  527. 90                                                    ----------------  90
  528. A0    TAB                  Move to next field         ----------------  A0
  529. B0    Shift-TAB            Move to previous field     ----------------  B0
  530. C0                                                    ----------------  C0
  531. D0    Alt-D                Load default colors        ----------------  D0
  532. E0    ENTER                Return and save changes    ----------------  E0
  533. F0    ESC                  Return without save        ----------------  F0
  534.  
  535.     Size of File:          Available Memory:       
  536.  
  537.  
  538. All color selections are saved in a file named HC.FIL.  If this file is not
  539. found when the program begins running, the editor will come up with its default
  540. colors.  Another indication that it has not been found the HC.FIL file is that
  541. the bottom of the title screen will display "To set screen colors, type Alt-C".
  542.  
  543. To enter the color selection menu once in the editor, use the Alt-C key. 
  544.  
  545. In response to the Alt-C command, the color selections screen will come up.  You
  546. will be able to edit one color field at a time.  The field that is currently
  547. being edited is displayed at the top center of the screen.  There are six
  548. different color fields that you may edit.
  549.  
  550. While editing colors, the functions of the keyboard are redefined thusly:
  551.  
  552.  
  553. Left/Right arrows
  554. -----------------
  555.  
  556. Use the left and right arrow keys to change the current field's foreground text
  557. color.
  558.  
  559.  
  560. Up/Down arrows
  561. --------------
  562.  
  563. Use the up and down arrow keys to change the current field's background color.
  564.  
  565. TAB
  566. ---
  567.  
  568. The TAB key shifts the editor to the next field.
  569.  
  570.  
  571. Shift-TAB
  572. ---------
  573.  
  574. The Shift-TAB key shifts the editor to the previous field.
  575.  
  576.  
  577. Alt-D
  578. -----
  579.  
  580. Loads and displays the default colors of Hexcalibur.
  581.  
  582.  
  583. ENTER
  584. -----
  585.  
  586. Returns to Hexcalibur and saves the colors displayed on the screen to the HC.FIL
  587. file.  These color selections are now permanently saved for all future runs of
  588. Hexcalibur.
  589.  
  590.  
  591. ESC
  592. ---
  593.  
  594. Returns to Hexcalibur without saving the displayed colors. 
  595.                                    Tutorial
  596.                                    ======== 
  597.  
  598.  
  599. To begin running Hexcalibur from a DOS prompt, enter the command:
  600.  
  601. hc [filename]
  602.  
  603. where the filename is the name of the file to be edited.  Although the filename
  604. is optional, if it is not provided, Hexcalibur will immediately prompt you for a
  605. file name.
  606.  
  607. Note:  If you have no file to start with, begin editing using the file named
  608. SAMPLE1 supplied on the disk.
  609.  
  610. As you load Hexcalibur, the title screen will first appear on the screen.  As
  611. the program loads the file, a counter at the bottom left hand corner of the
  612. screen displays how many bytes are currently loaded.  As soon as the file is
  613. loaded, press any key to enter the editor.
  614.  
  615. IF THIS IS THE FIRST TIME YOU ARE RUNNING HEXCALIBUR, you may want to change the
  616. screen colors.  To do so, type Alt-C.  You may then change your screen colors as
  617. described on the Color Selection Menu.  (For additional information on color
  618. selection, see the section on "Custom Color Settings".)
  619.  
  620. As the editor comes up, your cursor will be located at the top left hand corner
  621. of the hex window.  To begin, use the arrow keys to move the cursor around the
  622. hex window.  Move to the end of a line and notice that the cursor wraps around
  623. to the next line of the hex window instead of moving over to the text window. 
  624. To change windows use the F2 key.  This will move you to the corresponding
  625. character in the text window.  Now move to the bottom of the screen and you will
  626. see the file scroll up while the cursor holds its position. If you press the
  627. home key, the cursor will move to the beginning of the line of the current
  628. window.  The end key will move the cursor to the end of the line of the current
  629. window.  Try a few page up and page downs.  The entire file will shift a page
  630. (half of a sector) up or down.  For larger jumps through the file you will want
  631. to use the Alt-(0..9) keys.  Try pressing Alt-3.  The cursor will move to a
  632. position 30% of the way through the file.
  633.  
  634.  
  635. Editing in Overtype Mode
  636. ------------------------
  637.  
  638. To start this sample editing session, do the following:
  639.  
  640. 1. Press the insert key to change the program into Overtype mode.
  641. 2. Press function key F2 to switch to the text window.
  642.  
  643. Now begin typing some text characters.  You will notice that the characters you
  644. are typing are overwriting the existing characters.  Also notice that the
  645. corresponding characters in the hex window have changed their values in
  646. accordance with the changes you are making in the text window.
  647.  
  648. Now press function key F2 again, and you will move to the hex window.  While you
  649. are in the hex window, you can only use hexadecimal characters:  0-9 and A-F. 
  650. As you type, you will notice that, as in the text window, the characters you
  651. type will overwrite the character which the cursor sits on.  The corresponding
  652. text characters are updated as well.
  653.  
  654. Editing in Insert Mode
  655. ----------------------
  656.  
  657. Now press the insert key and you will notice that, at the upper left hand corner
  658. of the screen, it now says "insert mode" where it used to say "overtype."  Press
  659. the F2 key so that your cursor is in the text window.  Begin typing, and you
  660. will notice that the text from the cursor forward gets shifted forward, and the
  661. typed character is inserted at the cursor.  The cursor is also shifted one space
  662. to the right.  Again, the characters in the hex window are adjusted.
  663.  
  664. Move over to the hex window (by pressing F2) and try typing there.  You will
  665. notice that insert mode in the hex window works a bit differently.  Move the
  666. cursor to the left hex character of a pair.  Type a number and watch all of the
  667. pairs of hex characters shift forward, from the cursor on.  The number pressed
  668. will be inserted into the right hex character and the left hex character will
  669. turn to 0.  The cursor is moved to the right hex character where the typed
  670. number sits.  If you type another number, the right hex character will shift to
  671. become the left hex character, and the character keyed becomes the right hex
  672. character.  The cursor then moves another character to the right.
  673.  
  674.  
  675.  
  676. Working with Blocks
  677. -------------------
  678.  
  679. In order to work with blocks you must always begin by pressing Alt-A (begin
  680. block).  When you do so, you will notice that the mode indicator towards the
  681. upper-left hand corner of the screen is flashing "block mode" and the character
  682. your cursor sits on is now highlighted with a block mode color setting.  You are
  683. now in block mode.  Note: You cannot edit text in block mode, but you can switch
  684. freely between the hex and text window with F2.  Try moving the cursor around
  685. the screen and you will see that the text between the start of the block and the
  686. current position is highlighted.  Now hit F2 to switch to the opposite window
  687. and notice that the block has remained the same.  When you have decided on a
  688. block, look directly above the windows to see the block options:
  689.   Alt-C = copy block   Alt-M = move block   Alt-D = delete block
  690.  
  691. First try a block copy by pressing Alt-C.  The block highlight will disappear,
  692. not the text, and above the windows it will say "Move cursor to destination,
  693. press ENTER." Do as the instructions say and you will see the formerly
  694. highlighted text reappear where the cursor sits.  The cursor will appear at the
  695. end of the copied block.
  696.  
  697. Try the same procedure with move block (Alt-M) this time. You must start a new
  698. block again with Alt-A.  Notice that when you actually press Alt-M, the
  699. highlighted text disappears instead of remaining as with an Alt-C.  Pressing
  700. Enter at the destination will act the same as with an Alt-C.
  701.  
  702. Now try the procedure with delete block (Alt-D) after starting another block
  703. with Alt-A.  When pressing Alt-D, the highlighted block is removed and you are
  704. no longer in block mode.
  705. Using Paste Block
  706. -----------------
  707.  
  708. Now imagine that you accidentally deleted the wrong block.  It will be easy to
  709. recover this deleted block with Paste Block (Alt-P).  When pasting a block you
  710. must NOT be in block mode.  The last block used in block mode is automatically
  711. saved in a block buffer and can be retrieved with Alt-P.  Press Alt-P now and
  712. above the windows it will say "Move cursor to destination, press ENTER."  If the
  713. cursor still sits in the same place when the delete was made, you do not need to
  714. move it.  Press Enter and the block will be replaced.  If you wish to do another
  715. Paste block with the same block, you may.  The block remains in the buffer until
  716. it is replaced, when block mode is used. 
  717.                             Basic Editing Features
  718.                             ===== ======= ======== 
  719.  
  720. Overtype
  721. --------
  722.  
  723. In overtype mode, anything typed on to the screen will overwrite existing
  724. characters on the screen.  In the hex window, the overwrite will take place over
  725. the character which the cursor is on, as in the text window.  In the hex window,
  726. it edits only the upper or lower eight bits of the corresponding text character
  727. in the text window.  The insert key toggles overtype and insert mode.
  728.  
  729.  
  730. Insert
  731. ------
  732.  
  733. In insert mode, anything typed on to the screen will cause all text, from the
  734. cursor forward, to move up a space, and the typed character to be placed at the
  735. cursor.  When typing in the hex window, the first character typed will be
  736. inserted as the rightmost 4 bits and prefixed by a zero; the second key typed
  737. will cause the first character to be shifted to the left and then the second
  738. character will become the lower 4 bits.  For example, if we have: 
  739.  
  740. 90 91 92 93 94 95 96 97 98 99 9a 9b 9c 9d 9e 9f
  741.  
  742. and we are in insert mode with the cursor over the "9" of "98" and we type a
  743. "6", the display will change to read:
  744.  
  745. 90 91 92 93 94 95 96 97 06 98 99 9a 9b 9c 9d 9e
  746.  
  747. Now the cursor will be over the "6" of the "06" and the characters from "98" up
  748. will have been shifted one full position to the right.  If (note we're still in
  749. insert mode) we now (while over the "6") type "7", the "6" will be moved to the
  750. left and the "7" inserted after it.  The display will then read:
  751.  
  752. 90 91 92 93 94 95 96 97 67 98 99 9a 9b 9c 9d 9e
  753.  
  754. The cursor will be left over the "9" of the "98", which is the next available
  755. position on the screen.
  756.  
  757. The insert key toggles overtype and insert mode.
  758.  
  759.  
  760. Delete
  761. ------
  762.  
  763. When deleting a character, all text beyond that character is shifted back to
  764. fill the void.  In the hex window, both hex characters are deleted with one
  765. keystroke.
  766.  
  767.  
  768. Change Display (Alt-Z)
  769. ----------------------
  770.  
  771. This will change the text window to display either all printable characters or
  772. just ASCII characters.
  773.  
  774. Switch Between Hex and Character Edit (F2)
  775. ------------------------------------------
  776.  
  777. This will shift windows to the corresponding character in the other window. 
  778. This allows you to edit using either hex characters or ASCII characters.
  779.  
  780.  
  781. Color Selection (Alt-C)
  782. -----------------------
  783.  
  784. Alt-C will bring up the color selection help screen.  There are six different
  785. color fields to edit: text, background, special characters, help screens, block
  786. characters, and non-printable characters (hex character who have no printable
  787. translation).  The current field being edited is displayed in the top half of
  788. the help screen, and the cursor is located at one of the characters of that
  789. field.  The arrow keys change the color of the current field and the Tab keys
  790. shift fields.  ESC will cancel all color changes and ENTER will save them.
  791.  
  792.  
  793.  
  794.                           Moving Around in the File
  795.                           ====== ====== == === ==== 
  796.  
  797. Arrow Keys
  798. ---------- 
  799.  
  800. Using the arrow keys will move the cursor throughout the file.  When reaching
  801. the end of a line or a page, the screen and cursor will automatically wrap. 
  802. Note: The arrow keys will not move the cursor from one window to another.
  803.  
  804.  
  805. Page Up, Page Down
  806. ------------------
  807.  
  808. Paging up and down will shift the file exactly one screen page (256 bytes)
  809. accordingly.
  810.  
  811.  
  812. Home
  813. ---- 
  814.  
  815. Moves the cursor to the beginning of the line of the current window.
  816.  
  817.  
  818. End
  819. --- 
  820.  
  821. Moves the cursor to the end of the line of the current window.
  822.  
  823.  
  824. Beginning of File (Alt-B)
  825. -------------------------
  826.  
  827. Moves the cursor to the beginning of the file.
  828.  
  829.  
  830. End of File (Alt-E)
  831. -------------------
  832.  
  833. Moves the cursor to the end of the file.
  834.  
  835.  
  836. Move to x% of file (Alt-0..9)
  837. -----------------------------
  838.  
  839. Moves to a certain percentage of the file (i.e., Alt-3 moves the cursor to a
  840. position at 30% of the file size).
  841.  
  842.  
  843. Goto (Alt-G)
  844. ------------ 
  845.  
  846. Lets you specify exactly where in the file you want to move to, using sector and
  847. byte values.
  848.  
  849. Find (Alt-F)
  850. ------------
  851.  
  852. Searches for a given string in hex or text, depending on the current window, and
  853. then moves the cursor to the position of the string if found.
  854.  
  855.  
  856. Find and Replace (Alt-R)
  857. ------------------------
  858.  
  859. Alt-R prompts for two strings:  a target string and a replacement string.  Each
  860. time the target string is found in the file, you are asked if you want the
  861. replacement to be done.  The possible responses are:
  862.  
  863.   y -- yes:  replace this one occurrence of the target string with the
  864.              replacement string.
  865.   n -- no:   skip this occurrence of the target string but continue searching
  866.              for the next occurrence of the target.
  867.   r -- replace all:  replace all remaining occurrences of the target string
  868.              without prompting again.
  869.  
  870. The ESC key may be used to cancel the Replace operation.
  871.  
  872. Any time while a Find or Replace is in progress, pressing any key on the
  873. keyboard will stop the operation, and the prompt 
  874.  
  875. ENTER = continue / ESC = break
  876.  
  877. will appear.  When this happens, press the ENTER key to continue the operation. 
  878. To abort the operation, press the Escape key.
  879.  
  880.                              Block Mode Editing
  881.                              ===== ==== ======= 
  882.  
  883. Block Mode
  884. ----------
  885.  
  886. Block mode is initiated by executing an Alt-A.  In block mode, blocks of text
  887. may be copied, moved, or deleted, regardless of which window you are in.  Both
  888. windows will be updated to the change.  Text cannot be edited in block mode.
  889.  
  890. Begin Block (Alt-A)
  891. -------------------
  892.  
  893. Turns block mode on and places a marker at the current position of the cursor. 
  894. The cursor then should be moved to the position at the end of a desired block
  895. before executing a block action, i.e. copy block.
  896.  
  897. Delete Block (Alt-D)
  898. --------------------
  899.  
  900. To execute a delete block, you must be in block mode.  When the desired block to
  901. remove is highlighted, an Alt-D will delete it.
  902.  
  903. Note:  In case of accidental delete, the block is still available in memory.  It
  904. may be retrieved by typing Alt-P.  After typing Alt-P, move the cursor to the
  905. location where you would like to put the accidentally deleted block, and press
  906. ENTER.  The block will be inserted back into the file.
  907.  
  908. Blocks are only saved to one level deep.  Once a new block has been selected,
  909. the previous block is no longer retrievable.
  910.  
  911. Copy Block (Alt-C)
  912. ------------------
  913.  
  914. To execute a copy block, you must be in block mode.  When the desired block to
  915. copy is highlighted, press Alt-C.  The highlighting of the text will disappear. 
  916. Move the cursor to the desired location where the block is to be copied and
  917. press Enter.
  918.  
  919. Move Block (Alt-M)
  920. ------------------
  921.  
  922. To move a block, you must be in block mode.  When the desired block to move is
  923. highlighted, press Alt-M.  The highlighted text will be removed.  Move the
  924. cursor to the desired destination location and press Enter.
  925.  
  926. Paste Block (Alt-P)
  927. -------------------
  928.  
  929. Alt-P will paste the most recently selected block to any position in the file. 
  930. Alt-P is pressed OUTSIDE of block mode.  It causes the program to retrieve the
  931. most recently selected block and make it available for insertion into the file. 
  932. This may be a block that was previously deleted, moved, or copied.  As with move
  933. block and copy block, after pressing Alt-P, move the cursor to the location in
  934. the file where you desire the block to be inserted, and press ENTER.
  935.                                  File Options
  936.                                  ==== ======= 
  937.  
  938. Undo changes (Alt-U)
  939. --------------------
  940.  
  941. Undoes changes in the file since the last save was made. 
  942.  
  943.  
  944. Save File (Alt-S)
  945. -----------------
  946.  
  947. Alt-S causes a small menu to appear in the Hex window.  You are given the option
  948. to rename the file and then save it.  To actually save the file, you must press
  949. the ENTER key in the last box on the menu.  To cancel the save operation, press
  950. the Escape key at any time.
  951.  
  952. If there already exists a file with the name you are attempting to use, you will
  953. be given the option of making a backup file (with the .BAK extension) when the
  954. save takes place.
  955.  
  956. Upon completion of the save, the program returns to normal operation.
  957.  
  958.  
  959. Exit Program (Alt-Q)
  960. --------------------
  961.  
  962. Same as Alt-X.
  963.  
  964.  
  965. Exit Program with Optional Save (Alt-X)
  966. ---------------------------------------
  967.  
  968. Alt-X exits the program and gives an option to save the file.  ESC may used to
  969. escape the exit altogether.
  970.  
  971. Once you have moved to the Save menu via Alt-X, it is impossible to get back to
  972. the program.  Pressing ESC while in the Save menu will exit the program, and the
  973. file will NOT be saved.  (A notice to this effect is posted at the bottom of the
  974. Save menu when Save is entered via Alt-X.)
  975.  
  976.  
  977.  
  978.