home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / util / cli / BinHex.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  4.8 KB  |  101 lines
  1. Short:    Use favorite ASCII editor for HEX data V1.14
  2. Author:   stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
  3. Uploader: stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
  4. Version:  1.14
  5. Type:     util/cli
  6. Kurz:     Programm, um HEX-Daten mit ASCII Editor zu editieren
  7.  
  8. This program converts data (for example program code) into the hexadecimal
  9. data system. This data could be edited with your favorite ASCII text
  10. editor. After that you can convert the data back to their old style. So you
  11. do not need a special hexadecimal editor and you will also be able to
  12. delete, insert parts of the file and things like that. Most hexadecimal
  13. editors only allow to change given data byte for byte.
  14.  
  15. Be sure you know what you are doing! To insert some data into program code
  16. most time crashes the program, because the internal addresses are now
  17. illegal. But the ability to delete data is useful for removing start code
  18. from modules, pictures or text.
  19.  
  20. BinHex needs OS 37 (2.0) or later OS versions!
  21.  
  22. USAGE:
  23.   BinHex BIN/A,HEX/A,MAKEBIN/S,ONLYDATA/S,ROWS/N,ASMDATA/S,CDATA/S,
  24.        REV=REVERSED/S,SIZE/N
  25.   BIN      give filename for original data file
  26.   HEX      give filename for hexadecimal data
  27.   MAKEBIN  set program to convert HEX to BIN (else BIN to HEX)
  28.   ONLYDATA add no ASCII output and no position info to hex data file
  29.   ROWS       give number of rows in one line (1 row = 4 byte)
  30.   ASMDATA  creates a field of ASM DC.L lines (not convertable back to bin).
  31.   CDATA    creates a ULONG data[] = { ... } fiels (not convertable back).
  32.   REVERSED converts HEX format, where bytes of 16 bytes groups are in
  33.          reverse order (at the moment only in HEX->BIN mode)
  34.   SIZE     1) for ASMDATA and CDATA (1 = Byte, 2 = Word, 4 = Longword)
  35.          2) for REVERSED : gives size of REVERSED data (default = 16)
  36.  
  37. The options ASMDATA and CDATA create an output useable in an assembler or
  38. C compiler. If you choose SIZE 2 or 4 and the file does not end at WORD or
  39. LONG boundaries, at the end zeros are added till the boundary.
  40.  
  41. To make it impossible to overwrite binary data if not wanted use every time
  42. one of the BIN or HEX keywords, but they are not needed!. «BinHex A B» is
  43. same as «BinHex A HEX B», but the second is saver.
  44.  
  45. hexadecimal data format:
  46.   In the hexadecimal file the data is interpreted from begin of line to next
  47.   tab stop (\t, $09). If there is no tab stop in the line it is done from
  48.   begin of line to next return (\n, $0A). All other parts and spaces are
  49.   ignored!
  50.   If there is a \ in the data part all following characters to the next
  51.   tab stop (or return) are not converted. They are taken like given (good
  52.   for inserting readable text).
  53.  
  54.   example 1:
  55.   BIN data in RAM:A       Hello World!
  56. call BinHEX RAM:A HEX RAM:B ONLYDATA
  57.   HEX data in RAM:B       48656C6C6F20576F726C6421
  58.  
  59.   example 2:
  60.   HEX data in RAM:B      4865 6C6c 6f20\World!
  61. call BinHEX RAM:A HEX RAM:B MAKEBIN
  62.   BIN data in RAM:A       Hello World!
  63.  
  64. Please report me bugs, comments, suggestions and problems. If possible
  65. write a little mail if you use the program sometimes. If there are some
  66. Enforcer hits or other problems report them as good as possible.
  67.  
  68. Do not forget BinHex including source is Public Domain! I hope some more
  69. programmers follow the PD/Freeware idea. Shareware is good, but why pay
  70. for example 20$ for a very little utility?
  71.  
  72. Please contact me:
  73.  
  74. ****************************************************************************
  75. * snail-mail:                  * e-mail:                                   *
  76. *   Dirk Stoecker              *   stoecker@rcs.urz.tu-dresden.de          *
  77. *   Geschwister-Scholl-Str. 10 * phone:                                    *
  78. *   01877 Bischofswerda        *   GERMANY 03594/706666                    *
  79. *   GERMANY                    * world wide web:                           *
  80. *                              *   http://rcs.urz.tu-dresden.de/~stoecker/ *
  81. ****************************************************************************
  82.  
  83.  
  84. ============================= Archive contents =============================
  85.  
  86. Original  Packed Ratio    Date     Time    Name
  87. -------- ------- ----- --------- --------  -------------
  88.     6340    3425 45.9% 10-Feb-97 21:18:26  BinHex
  89.     3951    1786 54.7% 10-Feb-97 21:18:32  BinHex.readme
  90.    10330    3690 64.2% 10-Feb-97 21:18:26 +BinHex.c
  91.      408     245 39.9% 10-Feb-97 21:18:26 +SDI_ASM_functions.o
  92.     1195     549 54.0% 10-Feb-97 21:18:28 +SDI_ASM_protos.h
  93.     1928     753 60.9% 10-Feb-97 21:18:28 +SDI_ASM_STD_functions.o
  94.     3845    1250 67.4% 10-Feb-97 21:18:28 +SDI_ASM_STD_protos.h
  95.     4827    2045 57.6% 10-Feb-97 21:18:28 +SDI_defines.h
  96.     3952    1717 56.5% 10-Feb-97 21:18:28 +SDI_functions.o
  97.     3424    1423 58.4% 10-Feb-97 21:18:28 +SDI_protos.h
  98.      547     310 43.3% 10-Feb-97 21:18:28 +SDI_structures.h
  99. -------- ------- ----- --------- --------
  100.    40747   17193 57.8% 11-Feb-97 14:21:24   11 files
  101.