home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / zap.lha / zap.doc < prev   
Text File  |  1990-01-19  |  5KB  |  147 lines
  1.  
  2.         Zap v2.04
  3.         ---------
  4.  
  5.  
  6.   Zap is a binary file view/edit program. You can examine and modify the
  7. file in hexadecimal and ASCII mode. Zap keeps the file in memory, so moving
  8. in the file and searching is very fast, but available memory may limit
  9. the size of files that zap can handle.
  10.  
  11. Starting the program:
  12. ---------------------
  13.  
  14.   Zap can be started from CLI or workbench. When starting from CLI, file
  15. name can be given as a command line parameter. If the name contains spaces
  16. it can be enclosed in double quotes. When starting from workbench, a file
  17. can be selected by first clicking the Zap icon and then holding down
  18. shift-key and double clicking the icon of the file you want to edit.
  19. If you don't specify a file name when starting Zap, you can use the 'Load'-
  20. menuitem to load a file into Zap.
  21.  
  22. (If you want to start Zap from workbench, you must first create
  23. an icon for it)
  24.  
  25. The following menu functions are available:
  26. -------------------------------------------
  27.  
  28.  Project menu:
  29.  
  30.   Load    -  Loads a new file, The file name can be selected with a file name
  31.              requester. If the current file has been modified the program
  32.              asks first if you really want to load.
  33.  
  34.   Save    -  Saves the buffer with the current filename (The name
  35.              is displayed in the Zap title bar). (The save begins
  36.              immediately, with no requesters or yes/no questions. It is
  37.              easy to accidentally save a file you don't really want to.)
  38.  
  39.   Save as -  Saves the buffer with a new name. You can select the name
  40.              with a file name requester.
  41.  
  42.   About   -  Displays some information about the program.
  43.  
  44.   Quit    -  Exits Zap. If the buffer has been modified, asks first
  45.              if you really want to quit.
  46.  
  47.  Goto menu:
  48.  
  49.   Top          -  Moves to the beginning of the buffer.
  50.   Bottom       -  Moves to the end of the buffer.
  51.   Any position -  Moves to the selected position. A requester appears
  52.                   where you can type the position. You can use decimal
  53.                   or hex numbers. Use '$'-prefix for hex.
  54.  
  55.  Search menu:
  56.  
  57.   Find         -  Allows you to enter a text string and searches it in
  58.                   the buffer starting from the current cursor position.
  59.  
  60.   Find binary  -  Allows you to enter a byte secuence (hex or decimal number).
  61.                   and searches for it.
  62.  
  63.   Find next    -  Repeats the last search. Can be used to find the
  64.                   next occurence of a string.
  65.  
  66.   Direction    -  Allows you to select the search direction. Default is
  67.                   forward.
  68.  
  69.   Ignore case  -  Allows you to select whether the search is case sensitive
  70.                   or not. Default is case sensitive. Note that this does not
  71.                   affect binary search.
  72.  
  73.  
  74.  Gadgets:
  75.  --------
  76.  
  77.  At the side of the window are three gadgets that you can use to move in
  78.  the buffer. The drag bar (proportional gadget) allows you to select a
  79.  position anywhere in the buffer. The arrow gadgets allow you to scroll
  80.  the display up and down one line at time. The repeat if you hold the
  81.  left mouse button down on them.
  82.  
  83.  
  84.  The following keyboard functions are available:
  85.  -----------------------------------------------
  86.  (in addition to the menu shortcut keys)
  87.  
  88.  TAB  -  toggles HEX and ASCII entry mode.
  89.  
  90.  Cursor keys - move cursor left/right/up/down
  91.  
  92.  Shift-Cursor left/right - move cursor to left/right edge of a line.
  93.  
  94.  Shift-Cursor up/down    - move up/down one screenful at a time.
  95.  
  96.  Control-Cursor up/down  - scroll the display up/down while the cursor
  97.                            position in the buffer does not change.
  98.  
  99.  
  100.  You can use the keyboard to directly edit the data in the buffer.
  101.  In HEX mode you can enter numbers 0-9 and letters A-F/a-f to modify
  102.  the data. In ASCII mode you can directly enter all printable characters.
  103.  
  104.  
  105.  The file requester:
  106.  -------------------
  107.  The Zap file requester allows you to select/enter filenames with load/save
  108.  operations. (Note that you must select 'Save as' if you want to select the
  109.  filename. 'Save' selects with the current name).
  110.  
  111.  It is possible to select files or directories when the file requester is
  112.  still reading the directory from disk. To make this easier, the file
  113.  requester does not sort the names until the list is complete or you
  114.  use the dragbar (proportinal gadget) or the arrow gadgets.
  115.  
  116.  Pressing the right mouse button or selecting 'Parent' at the root level
  117.  causes a list of volumes, devices and assigned directories to appear in
  118.  the file requester display. (This list may also appear in some DOS error
  119.  conditions, for example if the volume with the current directory is not
  120.  mounted when entering the file requester).
  121.  
  122.  If you don't want to load/save you can exit the file requester by clicking
  123.  the 'Cancel' gadget.
  124.  
  125.  There are three ways to exit the file requester and select a file. First,
  126.  you can select a file and then click the 'Load' or 'Save' gadget. You can
  127.  also double click the filename in the list to select it. The third way is
  128.  to press return/enter in the filename string gadget.
  129.  
  130.  
  131. Copyright and distribution:
  132. ---------------------------
  133.  
  134.   Zap v2.04 is Copyright © 1990 by Timo Rossi. It can be freely
  135. distributed for non-commercial purposes.
  136.  
  137. Zap was programmed in assembly language using Charlie Gibbs' A68k assembler.
  138.  
  139. Send suggestions, bug reports etc. to:
  140. (use e-mail if possible)
  141.  
  142.   Timo Rossi
  143.   Kellankoski                 internet e-mail:
  144.   44300 KONNEVESI              trossi@jyu.fi
  145.   FINLAND
  146.  
  147.