Short:    use favorite ASCII editor for HEX data V1.12
Uploader: stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
Author:   stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
Type:     util/cli
Version:  1.12
Kurz:     Programm, um HEX-Daten mit ASCII Editor zu editieren

This program converts data (for example program code) into the hexadecimal
data system. This data could be edited with your favorite ASCII text
editor. After that you can convert the data back to their old style. So you
don't need a special hex editor and you will be able also to delete parts
of the file, insert parts and so on. Most hex editors allow only to change
given data.

Be sure that you know what you are doing! To insert some data into program
most time crashes the program, because the internal addresses are now
illegal. But the ability to delete data is useful for removing start code
from modules, pictures or text.

BinHex needs OS 37 (2.0) or later OS versions!

USAGE:
  BinHex BIN/A,HEX/A,MAKEBIN/S,ONLYDATA/S,ROWS/N,ASMDATA/S
  BIN      give filename for original data file
  HEX      give filename for hexadecimal data
  MAKEBIN  set program to convert HEX to BIN (else BIN to HEX)
  ONLYDATA add no ASCII output and no position info to hex data file
  ROWS	   give number of rows in one line (1 row = 4 byte)
  ASMDATA  creates a field of ASM DC.L lines (not convertable back to bin).
  CDATA    creates a ULONG data[] = { ... } fiels (not convertable back).

The options ASMDATA and CDATA create an output useable in an assembler or
C compiler. There are always ULONG fields created, so it may be that the
last number is incorrect. Please edit this one by hand.

To make it impossible to overwrite binary data if not wanted use every time
one of the BIN or HEX keywords, but they aren't needed!. «BinHex A B» is
same as «BinHex A HEX B», but the second is saver.

hexadecimal data format:
  In the hex file the data is only interpreted from begin of line to next
  tabulator (\t, $09). If there is no tabulator in line it is done from
  begin of line to next return (\n, $0A). All other parts and spaces are
  ignored!
  If there is a \ in the data part all following chars to the next
  tabulator (or return) are not converted. They are taken like given (good
  for inserting readable text).

  example 1:
  BIN data in RAM:A       Hello World!
call BinHEX RAM:A HEX RAM:B ONLYDATA
  HEX data in RAM:B       48656C6C6F20576F726C6421

  example 2:
  HEX data in RAM:B	  4865 6C6c 6f20\World!
call BinHEX RAM:A HEX RAM:B MAKEBIN
  BIN data in RAM:A       Hello World!

Please report bugs, comments, suggestions, problems to me. If possible
write a little mail if you use the program sometimes. If there are some
enforcer hits or other problems report them as good as possible (I can't
start enforcer!).

Don't forget BinHex including source is Public Domain! I hope some more
programmers follow the PD/Freeware idea. Shareware is good, but why pay
for example 20$ for a very little utility?

Please contact me:

***************************************************************************
* snail-mail: Dirk Stoecker              * e-mail:                        *
*             Geschwister-Scholl-Str. 10 * stoecker@rcs.urz.tu-dresden.de *
*             01877 Bischofswerda        * phone:                         *
*             GERMANY                    * GERMANY 03594/706666           *
***************************************************************************