home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / hed.zip / HeD.doc < prev    next >
Text File  |  1995-09-29  |  9KB  |  292 lines
  1.  
  2.                              HeD/2 v1.0
  3.  
  4.                          Hex Editor for OS/2
  5.  
  6.  
  7.  
  8.  
  9.   ■ What is HeD/2
  10.   ---------------
  11.  
  12.          HeD/2 is yet another hex editor for OS/2.
  13.  
  14.          Anyway, HeD/2 has some very powerful features not
  15.          easily found in other binary editors, including
  16.          (but [as usual] not limited to) :
  17.  
  18.          - Unlimited editing in memory.
  19.          - Support for multiple files.
  20.          - Unlimited size of block copying & pasting.
  21.          - Internal evaluator.
  22.          - Wildcards in search strings.
  23.  
  24.  
  25.  
  26.   ■ Disclaimer license etc etc
  27.   ----------------------------
  28.  
  29.          HeD/2 is free. No registration is needed, and there
  30.          are no crippled features. This is a full functioning
  31.          version.
  32.  
  33.          HeD/2 comes with no warranty. The author is not responsible
  34.          for any damage caused directly or indirectly by the program.
  35.  
  36.  
  37.   ■ Command line syntax
  38.   ---------------------
  39.  
  40.          HeD/2 has no command line parameters. Everything you
  41.          type in the command line is treated as a filename to be
  42.          opened. Wildcards are allowed and there can be more than
  43.          one file specifications  e.g.
  44.  
  45.             HeD test* read*.do? \autoexec.bat ..\temp\3\foo.bar.2
  46.  
  47.          If a filename contains spaces use double quotes :
  48.  
  49.            HeD "Read  Me.Tx?" readme.txt
  50.  
  51.          If a filename is in the form of "drive:" HeD/2 will
  52.          try to edit the entire logical disk. If HeD/2 fails
  53.          to lock the device the disk will still be opened
  54.          but only for reading.
  55.  
  56.          If you are not absolutely sure you know what you are
  57.          doing DO NOT edit disk volumes !
  58.  
  59.          If no wildcards are specified HeD/2 will prompt you
  60.          to select a file from a list box.
  61.  
  62.  
  63.   ■ Moving around
  64.   ---------------
  65.  
  66.          HeD/2 displays files in two panels. The one on the
  67.          left holds the alphanumeric representation and the one
  68.          on the right the hexadecimal.
  69.  
  70.           A blue attribute cursor shows the current position in
  71.          both panels. If a file can be written (that is, if it
  72.          is not read-only and not blocked by the system) the
  73.          standard blinking cursor will be displayed as well in
  74.          the panel that has the focus.
  75.  
  76.           The moving keys are
  77.  
  78.   Up         Cursor up
  79.   Down       Cursor down
  80.   Left       Cursor left
  81.   Right      Cursor right
  82.  
  83.   PgUp       Previous screen
  84.   PgDwn      Next screen
  85.  
  86.   Alt-G      Go to position.
  87.   
  88.   Tab        Switch panels. The panel with the focus (double line
  89.              border) receives the data.
  90.  
  91.  
  92.  
  93.   ■ General commands
  94.   ------------------
  95.  
  96.   Alt-N      Go to next opened file.
  97.   Alt-P      Go to previous opened file.
  98.  
  99.   Alt-O      Open or create a new file.
  100.   Alt-Q      Quit file. If changes have been made you will be
  101.              prompted for saving. If the last file is quitted HeD/2
  102.              will exit.
  103.  
  104.   Alt-F      Toggle text filter.
  105.   Alt-D      Toggle between hexadecimal and decimal offsets display.
  106.  
  107.   Ctrl-F4    Evaluate expression.
  108.   F11        Show Ascii table.
  109.  
  110.   F9         Shell to command processor.
  111.   Alt-F9     Execute program.
  112.  
  113.   Esc        Quit HeD/2.
  114.  
  115.  
  116.   ■ Changing Data
  117.   ---------------
  118.  
  119.              Data is entered directly into the panel that has
  120.              the focus (use Tab to change the focus).
  121.  
  122.              Bytes with changed values will be displayed
  123.              intensified.
  124.  
  125.              HeD/2 allows you to enter data past the end of
  126.              file. Just press the left arrow while in the
  127.              bottom of the file and continue editing.
  128.  
  129.              Be careful when pasting data near the end of
  130.              file. HeD/2 will not truncate the pasted part,
  131.              instead it will increase the file size to make
  132.              more space. Make sure you don't end up with
  133.              a file larger than you want ...
  134.  
  135.              Changing commands are:
  136.  
  137.   Alt-Enter  Enter a number at the cursor location.
  138.   F11        While in the ascii dialog box you can press Enter
  139.              to insert the selected character in the file.
  140.  
  141.   Del        Undo changes at current location.
  142.   Backspace  Go back one character then undo at current location.
  143.   Ctrl-Del   Unto all changes in marked block (use shift and
  144.              movement keys for marking).
  145.  
  146.   Alt-PgDwn  Go to next changed data.
  147.   Alt-PgUp   Go to previous changed data.
  148.  
  149.   F2         Save changes
  150.   F3         Abort changes
  151.  
  152.  
  153.  
  154.   ■ Copying & Pasting
  155.   -------------------
  156.  
  157.              Mark data by holding down the Shift key, and then
  158.              any of the moving keys (e.g. arrows PgUp PgDown etc)
  159.  
  160.   Ctrl-Ins   Copy Data to clipboard
  161.  
  162.   Shift-Ins  Paste Data from clipboard
  163.  
  164.   
  165.       NOTE:  HeD/2 has a private internal clipboard. Data you
  166.              copy into it will not be available to other
  167.              sessions.
  168.  
  169.  
  170.  
  171.   ■ Searching
  172.   -----------
  173.  
  174.   F5         Case insensitive search for text
  175.   Alt-F5     Case insensitive search for text & replace
  176.  
  177.   F6         Search for text (case sensitive)
  178.   Alt-F6     Search for text & replace (case sensitive)
  179.  
  180.   F7         Hexadecimal search
  181.   Alt-F7     Hexadecimal search & replace
  182.  
  183.   F8         Search for number
  184.   Alt-F9     Search for number & replace
  185.  
  186.   Shift-F7   Redo last search.
  187.  
  188.  
  189.       NOTE:  In the search prompt press Alt-? for a wildcard.
  190.              The wildcard is displayed as an intensified
  191.              question mark.
  192.  
  193.              When searching, a wildcard will match any data.
  194.              For example a search for  '22 ?? EE'  will match
  195.              both  '22 31 EE'  and  '22 04 EE'.
  196.  
  197.              When replacing, a wildcard is treated as a "do not
  198.              change" flag. If for example you are replacing using
  199.              '?? 12 34' , only the second and third byte of the
  200.              matching data will be replaced.
  201.  
  202.              Wildcards are allowed only in text and hex
  203.              search.
  204.  
  205.  
  206.   ■ Evaluation
  207.   ------------
  208.  
  209.          HeD/2 contains an internal evaluator. Whenever you are
  210.          prompted for a number you can type an expression using
  211.          the following mathematical functions :
  212.  
  213.                 ~   Boolean NOT
  214.                 *   Multiply
  215.                 /   Division
  216.                 %   Remainder
  217.                 +   Add
  218.                 -   Subtract
  219.                 <<  Rotation left
  220.                 >>  Rotation right
  221.                 &   Boolean AND
  222.                 ^   Boolean XOR
  223.                 |   Boolean OR
  224.  
  225.  
  226.              WARNING : HeD/2 uses the C precedence of the symbols.
  227.              That means for example that 4+4&8 yields 8 and not 4 !
  228.              To be on the safe side always use parenthesis.
  229.  
  230.              Numbers are treated as decimal by default. Use a
  231.              trailing h or b to denote hexadecimal or binary.
  232.              For example :
  233.  
  234.                1000 + ( (1440&200h) << 11b )
  235.  
  236.  
  237.  
  238.   ■ The infamous codepage patch
  239.   -----------------------------
  240.  
  241.    For reasons that are not yet clear to me (!!) I have decided to
  242.   design a complicated (!) patch to allow codepage switching while
  243.   HeD/2 is running (did I ?).
  244.  
  245.    In order to change the HeD's codepage you should hex edit the file
  246.   hed.exe (!!?) search for the string "CODEPAGE:000" and change the
  247.   number to the desired codepage (!).
  248.  
  249.    NOTE: Don't use "hed hed" (!) to hex edit hed. Try a renamed version
  250.   of hed.
  251.  
  252.  
  253.  
  254.   ■ End notes
  255.   -----------
  256.  
  257.    HeD/2 is not available for any platform other than OS/2. I
  258.   may write a DOS version, but then again I may not.
  259.   
  260.    HeD/2 has been tested by a small number of beta testers.
  261.   Nevertheless if you find any  bugs, spelling errors, or if
  262.   you have any suggestion about future improvements, or if
  263.   you just want to send a message of support here is where you
  264.   can reach me:
  265.  
  266.    fidonet:    Dimitris Kotsonis @ 2:410/301.7
  267.    OS2net:     Dimitris Kotsonis @ 81:430/2.1
  268.  
  269.    internet:   jnk@opti.patra.hol.gr
  270.                jnk@patra.hol.gr           (try both)
  271.          
  272.  
  273.  
  274.   ■ Acknowledgements
  275.   ------------------
  276.  
  277.    I would like to thank the following people for their help and
  278.   support:
  279.  
  280.                 Nikos Lazos
  281.                 John Mantzouranis
  282.                 John Millas
  283.                 Panagiotis Malakoudis
  284.                 Alex Spanidis
  285.                 Nick Mylonas
  286.                 Costas Papadopoulos
  287.  
  288.                                                  thank you all
  289.  
  290.                                                            jnk
  291.  
  292.