home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / disk / zap-2.47.lha / Zap-2.47 / Zap.doc < prev    next >
Encoding:
Text File  |  1994-07-01  |  8.1 KB  |  223 lines
  1.  
  2.         Zap v2.47 (The binary file editor)
  3.         ----------------------------------
  4.                           by Timo Rossi
  5.  
  6.  
  7.  
  8.   Zap is a binary file view/edit program. You can examine and modify the
  9. file in hexadecimal and ASCII mode. Zap keeps the file in memory, so moving
  10. in the file and searching is very fast, but available memory limits
  11. the size of files that zap can handle.
  12.  
  13. NOTE: This (and later) version of Zap requires Kickstart/Workbench 2.04
  14. or later.
  15.  
  16. Starting the program:
  17. ---------------------
  18.  
  19.   Zap can be started from CLI or workbench. When starting from CLI, file
  20. name can be given as a command line parameter. If the name contains spaces
  21. it can be enclosed in double quotes. When starting from workbench, a file
  22. can be selected by first clicking the Zap icon and then holding down
  23. shift-key and double clicking the icon of the file you want to edit.
  24. If you don't specify a file name when starting Zap, you can use the 'Load'-
  25. menuitem to load a file into Zap.
  26.  
  27. There are two command line options in Zap. The first is '-*' and it disables
  28. the automatic CLI detach feature. This is useful for example when starting
  29. zap from a directory utility type program. The other option is
  30. '-S<pubscreen_name>' and it allows Zap to open on a specific public screen.
  31. Normally Zap opens on the default public screen.
  32.  
  33. The following menu functions are available:
  34. -------------------------------------------
  35.  
  36.  Project menu:
  37.  
  38.   Load    -  Loads a new file, The file name can be selected with an ASL
  39.              file requester. If the current file has been modified
  40.              the program asks first if you really want to load.
  41.  
  42.   Save    -  Saves the buffer to a file. This displays an ASL file requester
  43.          and enter/select a new file name or just press <return> or
  44.          the 'Ok' gadget to save with the current name. Or you can
  45.          click the 'Cancel' gadget if you selected this accidentally.
  46.  
  47.   About   -  Displays some information about the program.
  48.  
  49.   Quit    -  Exits Zap. If the buffer has been modified, asks first
  50.              if you really want to quit.
  51.  
  52.  Goto menu:
  53.  
  54.   Top          -  Moves to the beginning of the buffer.
  55.   Bottom       -  Moves to the end of the buffer.
  56.   Any position -  Moves to the selected position. A requester appears
  57.                   where you can type the position. You can use decimal
  58.                   or hex numbers. Use '$'-prefix for hex.
  59.  
  60.  Search menu:
  61.  
  62.   Find         -  Allows you to enter a text string and searches it in
  63.                   the buffer starting from the current cursor position.
  64.  
  65.   Find binary  -  Allows you to enter a byte secuence (hex or decimal numbers).
  66.                   and searches for it. bytes must be separated with
  67.           commas or spaces. hex numbers must be prefixed with
  68.           '$' or '0x'.
  69.  
  70.   Find next    -  Repeats the last search. Can be used to find the
  71.                   next occurence of a string.
  72.  
  73.   Direction    -  Allows you to select the search direction. Default is
  74.                   forward.
  75.  
  76.   Ignore case  -  Allows you to select whether the search is case sensitive
  77.                   or not. Default is not case sensitive. Note that this does
  78.                   not affect binary search.
  79.  
  80.  
  81.  Gadgets:
  82.  --------
  83.  
  84.  At the side of the window are three gadgets that you can use to move in
  85.  the buffer. The drag bar (proportional gadget) allows you to select a
  86.  position anywhere in the buffer. The arrow gadgets allow you to scroll
  87.  the display up and down one line at time. They repeat if you hold the
  88.  left mouse button down on them.
  89.  
  90.  
  91.  The following keyboard functions are available:
  92.  -----------------------------------------------
  93.  (in addition to the menu shortcut keys)
  94.  
  95.  TAB  -  toggles HEX and ASCII entry mode.
  96.  
  97.  Cursor keys - move cursor left/right/up/down
  98.  
  99.  Shift-Cursor left/right - move cursor to left/right edge of a line.
  100.  
  101.  Shift-Cursor up/down    - move up/down one screenful at a time.
  102.  
  103.  Control-Cursor up/down  - move to top/bottom of file.
  104.  
  105.  Alt-Cursor up/down      - scroll the display up/down while the cursor
  106.                            position in the buffer does not change.
  107.  
  108.  
  109.  You can use the keyboard to directly edit the data in the buffer.
  110.  In HEX mode you can enter numbers 0-9 and letters A-F/a-f to modify
  111.  the data. In ASCII mode you can directly enter all printable characters.
  112.  
  113.  
  114. Zap version history:
  115. --------------------
  116. 2.47 - Fixed a bug that causes Zap to display negative buffer offsets
  117.     (ie. free memory) in some cases...
  118.      - Better resolution sensitivity (works with sysihack).
  119.  
  120. 2.45 - Added '8 bit characters printable'-option
  121.  
  122. 2.44 - Fixed proportional gadget height setting and menu handling.
  123.  
  124. 2.43 - removed some unused things (arrow gadget images in the older version)
  125.        proportional gadget works with big files again...
  126.  
  127. 2.42 - added more 2.04 stuff (BOOPSI & gadtools gadgets etc.)
  128.  
  129. 2.41 - fixed a stupid bug (dos_error dropped to BlockWindow...)
  130.  
  131. 2.40 - now uses gadtools for menus. supports 3.0 newlookmenus.
  132.  
  133. 2.39 - 2.04+ only version. Uses asl file requester.
  134.  
  135. 2.38 - supports 2.0 public screens
  136.  
  137. 2.37 - doesn't allocate buffer as public memory (should work with
  138.        virtual memory)
  139.  
  140. 2.35 - fixed window blocking to work with kick/wb 1.3
  141.  
  142. 2.34 - filerequester bugfix (it could unlock currentdir sometimes)
  143. 2.33 - small bug fixes.
  144.  
  145. 2.32 - the main window is blocked from any input when there
  146.        is a filerequester/autorequester/stringrequester active.
  147.  
  148. 2.30 - small fixes in filerequester and some internal changes.
  149.  
  150. 2.29 - fixed a small bug in 2.27 & 2.28 that caused enforcer hits
  151.      - added '-*' option for disabling segsplit.
  152.  
  153. 2.28 - works better with 2.0 scrollable screens
  154.  
  155. 2.27 - more 2.0-look (file requester), font adaptive menus
  156.  
  157. 2.25, 2.26 - internal changes, mostly not visible to user
  158.  
  159. 2.24 - removed 'Save as' option and changed 'Save' always to bring up
  160.     the file requester. this should prevent accidental 'Save's.
  161.  
  162. 2.23 - added control/cursor up/down to move top/bottom of file
  163.     (also changed old control up/down to use alt instead of control)
  164.  
  165. 2.22 - fixed a bug in 2.21 that caused it to crash if the window was
  166.        sized when there was no file in the buffer.
  167.  
  168. 2.21 - added visible cursors in both hex/ascii displays.
  169.  
  170. 2.19 - Minor file requester update. Now shift-return toggles between
  171.        the string gadgets.
  172.  
  173. 2.18 - Now it is really font-adaptive. The actual editing area uses
  174.     the default system font.
  175.  
  176. 2.16 - File requester no more crashes with system fonts smaller than
  177.     8 pixels in x-direction.
  178.  
  179. 2.15 - Modified propgadget routines.
  180.  
  181. 2.14 - Now adapts to different screen font sizes (useful in AmigaDOS 2.0)
  182.     (the actual editing display is topaz 80).
  183.     Also fixed the bug that caused a division-by-zero-
  184.     guru if the propgadget was used before loading a file to the buffer.
  185.  
  186. 2.13 - Near real time scrolling of the display when the propgadget is used.
  187.  
  188. 2.12 - Some minor bug fixes
  189. 2.11 - Uses new segsplit startup (detaches itself from CLI automatically).
  190. 2.08 - Now looks better with WB 2.0. Also 'Ignore case' is on by default.
  191. 2.07 - Now '0x' can be used as prefix for hex numbers
  192. 2.06 - Corrects a bug in multiple menu select handling that could cause
  193.        null pointer references.
  194. 2.05 - Corrects a small bug in the position/byte display (If the first digit
  195.        of a hex number was changed, the 'Byte'-display was not updated)
  196. 2.04 - First version posted to comp.binaries.amiga (only change from
  197.        2.03 was copyright message)
  198. 2.03 - Works correctly with files greater than 64k.
  199. 2.01 - File requester doesn't show devices like PIPE: etc.
  200. 2.00 - Initial release.
  201.  
  202. Copyright and distribution:
  203. ---------------------------
  204.  
  205.   Zap v2.44 is Copyright © 1994 by Timo Rossi. It can be freely
  206. distributed for non-commercial purposes. Please keep this document file
  207. together with the executable.
  208.  
  209. (There is also a disk archiving program called 'Zap'. I have nothing to
  210. do with it and I used the name 'Zap' much earlier...and in my opinion,
  211. the name suits a lot better for a binary editor than an archiving program)
  212.  
  213. Zap was programmed in assembly language using Charlie Gibbs' A68k assembler.
  214.  
  215. Send suggestions, bug reports etc. to:
  216. (use e-mail if possible)
  217.  
  218.   Timo Rossi
  219.   Mattilankatu 40 A 4          internet e-mail:
  220.   40600 Jyväskylä               trossi@jyu.fi
  221.   FINLAND
  222.  
  223.