home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 056.lha / newzap.doc < prev    next >
Encoding:
Text File  |  1986-11-20  |  3.7 KB  |  82 lines
  1.        NewZAP: Program and Documentation (c) 1986 Proprietary Products
  2.                    
  3.                  
  4. WHAT IS NEWZAP?
  5. ===============
  6.  
  7. NewZAP is a multi-purpose file sector editing utility. If you've ever
  8. had the need to alter just a few bytes within a file, examine its binary and
  9. ASCII representations, or search for key sequences of digits or characters,
  10. NewZAP will make your hacking life a little bit easier. It does what text
  11. editors were not meant to do; precise position-oriented object modifications.
  12. NewZAP will run from CLI or Workbench under 1.1 or 1.2 KickStart with or
  13. without FAST RAM.
  14.  
  15. ORIGINS & CREDITS
  16. =================
  17.  
  18. NewZAP is a third-generation ZAP utility in the sense that it descended
  19. from Apparat's Z-80 based SuperZap to FileZAP (Fred Fish disk # 10) to the
  20. current. NewZAP was compiled under 16-bit Aztec "C", with graphics, fontwork
  21. and debugging assisted by with Deluxe Paint, FontEdit, and MetaScope,
  22. respectively. Thanx to Scott Saunders for the competitive edge, Mike Lehman
  23. for the much-needed documentation, and to R.J. Mical for "A Final Note on
  24. Style".
  25.  
  26. Beverages provided by the Coca-Cola Company and Molson Breweries of Canada..
  27.     
  28. USAGE
  29. =====
  30.  
  31.     The calling sequence from CLI is NewZAP [filename], where filename is
  32. the optional initial file to edit. From Workbench, just click on the gadget.
  33. The rest of the program is... well, self-explanatory! The current file can
  34. be changed at any time by editing the filename string gadget, writing out any
  35. changes to the previous file before switching. Simply click on the HEX or 
  36. ASCii windows to reflect the current editing mode. The cursor can be moved by
  37. rolling the mouse with the left button down, or by using the arrow keys. Note
  38. that each window wraps to the next; i.e., you can click on the HEX window, 
  39. move the cursor over the the ASCii side, and edit the ASCii position while 
  40. still in HEX mode.
  41.  
  42.     As in FileZAP, you cannot edit past the EOF byte in the last record.
  43. Unlike FileZAP, NewZAP displays and edits full 512-byte sectors via a 106 
  44. character wide internal font. Most commands are duplicated with matching 
  45. command sequences; an exception being the HELP key, which brings up the 
  46. "About..." menuitem. Input/disk errors are flagged with a non-abusive audible
  47. "beep".
  48.  
  49.     The Search menu is unique to NewZAP. Use it to check for strings or
  50. HEX digits, forward or backward, with or without caps matching. Tired of batch
  51. files that grind your disk drive? Use NewZAP's Search, Edit and Save functions
  52. to modify both instances of ":T" to "T:" in C:EXECUTE. Execute will henceforth
  53. store its preprocessed batch files anywhere you want provided you have 
  54. ASSIGNed T: to someplace! I recommend ASSIGNing T: to RAM: in your 
  55. Startup-Sequence for ultra-fast EXECUTEs.
  56.  
  57. CAVEATS
  58. =======
  59.  
  60.     Some folk have requested the ability to extend files. Well, the 
  61. original didn't support it so neither does NewZAP. I've rarely had a need for
  62. this, but perhaps future versions will support it if the demand is great.
  63.  
  64.     NewZAP expects an 80-column environment for its titles and gadgets.
  65. If you haven't set Preferences yet, do so!
  66.  
  67.     NewZAP is a two-edged sword, and can DESTROY object files with 
  68. careless editing. My advice : work on backup copies.
  69.  
  70.     Lastly, NewZAP is shareware, a concept where authors can release 
  71. high-quality software at low cost and risk to users. If you like it, 
  72. contribute something to the kitty. If you don't, pass it on. A $15 donation 
  73. will put you on the upgrade list, so you can receive the next major revision 
  74. on disk via U.S. Postal service. ENCOURAGE USER-SUPPORTED SOFTWARE! The 
  75. author can be reached at :
  76.  
  77.  
  78.                            Proprietary Products
  79.                              c/o John Hodgson
  80.                               P.O. Box 1643
  81.                        Pebble Beach, Ca. 93953-1643
  82.