Dump3a

New version for the S3a with this new features:

-	Dump3a takes advantage of the bigger screen and shows 208 
                bytes
-	Edit mode can now be accessed by the diamond key
-	The build in calculator now allows decimal input
-	Dump3a has a search function in either hex and ascii mode.


Dump3a is a program for viewing and modifying (CAUTION !!!) any 
type of file in either binary and ascii mode. It's provided as an 
.opa file.


Installation:

Copy the Dump3a.opa file into any \app directory and install it 
as an application from the system screen.


Functions:

The screen is divided into a status line at the top, a dump in 
binary mode and a dump in ascii mode. The status line indicates 
ths bytes shown and the actual position of the cursor.

<left>           moves the cursor one byte left
<right>          moves the cursor on byte right
<up>             moves the cursor one line (16 bytes) up
<down>           moves the cursor one line (16 bytes) down
<page up>        moves the cursor one page (208 bytes) up
<page down>      moves the cursor one page (208 bytes) down
<psion> o        asks for a new filename
<psion> i        gives you some information about the file in use
<psion> e  or    this is a toggle key for editing the current  
diamond key      file. The Edit Mode is indicted by an arrow at 
                 the left side of either the binary or the ascii 
                 dump. 
                 You can toggle between the binary and the ascii 
                 mode by pressing the <tab> key. 
                 In ascii mode you can enter all characters 
                 available on the Series 3a keyboard and also all 
                 combinations with <ctrl><number> except the 
                 combination <ctrl><009> (this is the <tab> key). 
                 Each character is written directly to the file. 
                 In binary mode you can enter all values in hex-
                 code (0-9,A-F). The program waits for two valid 
                 keystrokes and then writes the character to the 
                 file. After the first half-byte you can delete 
                 it pressing the <del> key. 
                 Pressing the <esc> key terminates the byte 
                 editing.
<psion> j        asks you for an address to jump to.
<psion> c        pops up a simple hex-calculator. It works in 
                 RPN-mode. That means that you have to enter 
                 operations like this
                 number >enter> number operator number ...
                 Operators can be '+ - * /'.
*** NEW ***      Pressing the number sign (#) as the first sign 
                 changes the the input from hexadecimal to 
                 decimal input.
                 You can calculate only with integers. Dividing 
                 an odd number by an even number gives an 
                 integer.
                 A nice feature of the calculator is that 
                 pressing <psion>j inside the calculator jumps 
                 directly to the calculated address.
                 You can edit the number only with the <del> key.
*** NEW ***      Pressing the monkey tail (@) deletes the input 
                 line.
                 Pressing <psion> j or <esc> terminates the 
                 calculator.
<psion> f        opens a new screen where you can enter up to 20 
                 characters to search for. These characters can 
                 be entered either in hexadecimal or ascii mode.
                 In ascii mode you can enter all characters 
                 available on the Series 3a keyboard and also all 
                 combinations with <ctrl><number> except the 
                 combination <ctrl><009> (this is the <tab> key). 
                 Each character is written directly to the file. 
                 In binary mode you can enter all values in hex-
                 code (0-9,A-F). The program waits for two valid 
                 keystrokes and then writes the character to the 
                 file. After the first half-byte you can delete 
                 it pressing the <del> key. 
                 Pressing the <esc> key terminates the byte 
                 editing.
                 Pressing <tab> changes between the hexadecimal 
                 and the ascii input.
                 You can move the cursor with the <right> and the 
                 <left> cursor key and delete characters with the 
                 <del> or the <shift><del> key.
                 The hexadecimal and ascii lines are updated at  
                 the same time.
                 Pressing <enter> starts the search at the  
                 current cursor position. 
*** NOTE ***     The search is case sensitive.
<psion> g        repeats the search with the actual search string 
                 from the current cursor position.
<psion> x        exits the program.
<menu>           let you enter all the above functions.

WARNING:
                 I will take no responsability for the lost of 
                 any data. I suggest to make a backup-copy of the 
                 files you will modify.

I hope you enjoy the program. Let me know all bugs and suggestions.


Wolfgang

Hamburg, Oct., 25 1993


Prepared by :

Wolfgang Schirmer
Manshardtstrasse 13a
22119 Hamburg
Germany
Phone 49406553956
CIS 100022,1371

