home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / dskutl / patchz80.lbr / PATCH.DQC / PATCH.DOC
Encoding:
Text File  |  1985-02-10  |  7.1 KB  |  168 lines
  1. Release Date October 31, 1984;    Patch 1.2
  2.  1.  Fixed search function to stop after wrap around to start of search
  3.  2.  Added tabbing to ASCII display mode (tabsize=8)
  4.  3.  Quicker disk operations during searches
  5.  4.  Default disk changed when reference is made to a disk in File Name
  6.  5.  Added a WILDCARD to the search routine
  7.  
  8. Release Date October 21, 1984;    Patch 1.1
  9.  1.  Changed Search function to disreguard upper/lower case distinction
  10.  2.  Search now begins at current record and wrapps around
  11.  3.  Now able to select disks other than default
  12.  4.  Added Display mode that prints ASCII files out in line format
  13.      for better readability
  14.  
  15. First Release Date October 15, 1984;  Patch 1.0
  16.  
  17. PATCH 1.2      (c) Copyright Bill Rink;  1984
  18.  
  19. This software is made available to the public domain and may be freely
  20. distributed.  It is not to be sold or used for commercial use and is
  21. donated as appreciation for all the fine software made available by the
  22. unselfish individuals that have contributed to the public domain.
  23.  
  24. PATCH is a file/memory editor that allows for easy access of either in-
  25. dividual records within a file or pages within memory.  PATCH can operate
  26. in one of two modes; accessing 128 byte records from within the selected
  27. file, or 256 byte pages of processor memory (up to 64k).  Regardless of
  28. which mode you are in, there are 256 bytes of information displayed on
  29. the screen.  PATCH works like a full screen editor when changing HEX
  30. data.  In addition, it has search capabilities on any combination of
  31. either HEX, DECIMAL, or ASCII fields that are separated by commas.
  32.  
  33. PATCH is based upon the concept of EDFILE, a program which I have used
  34. extensively and enjoyed tremendously.  My desire was to make an enhanced
  35. version that would be easy to use and more versatile.  In a later ver-
  36. sion, I plan to have the option of displaying the various addresses
  37. associated with the operating system (BDOS,CCP,BIOS, jump table, etc.)
  38. and allowing easy access to these memory pages or disk records.
  39.  
  40. Selecting a Mode
  41. ----------------
  42. When the program initializes, you are asked to select whether you wish
  43. to edit a FILE or MEMORY.  Once you have selected the desired mode, you
  44. will either be prompted for the file name or shown the first page of
  45. memory (page 0).
  46.  
  47. Commands
  48. --------
  49. You will then be shown a list of commands to use for operating in that
  50. mode.  The command set is more complete in the file mode due to the na-
  51. ture of operation.
  52.  
  53. 'Display'  This will change the dispaly mode for looking at a
  54.        file.  If you are looking at a file in the HEX/ASCII
  55.        mode, entering a "D" will toggle you into a ASCII
  56.        line mode in which each line is strickly ASCII and
  57.        is terminated by a CR,LF.  Any non-printable char-
  58.        acters will be shown as a reverse video field to
  59.        indicate them as such.  Tabs are converted, using
  60.        a tab size of 8.
  61.  
  62. 'Record'   Enter the record number within the file that you wish
  63.        to access.  This is a DECIMAL record number.  The EOF
  64.        record is shown next to the file name.
  65.  
  66. 'Base'       Allows changing the BASE address used as a reference
  67.        while in a file.  The default is 100H.  This is useful
  68.        when viewing image files of the operating system.
  69.  
  70. 'Search'   Will prompt you for a search key to be used for
  71.        scanning records or memory.  You may search for any
  72.        combination of character types (HEX, decimal, or
  73.        ASCII).  To denote the different types, you use a
  74.        prefix before the field.  Use quotes (") at the
  75.        beginning of any ASCII field, a decimal point (.)
  76.        at the beginning of a decimal field, and H at the
  77.        start of a HEX field.  If you leave the prefix out,
  78.        it will be assumed to be HEX.  Separate each field
  79.        with a comma.
  80.  
  81.        eg. "This is ASCII,.1234,0FE1," etc.
  82.  
  83.        Will search for an ASCII string followed by a decimal,
  84.        HEX, and ASCII field.
  85.  
  86.        When a string is found, it will be reverse highlighted
  87.        to denote it from the rest.
  88.  
  89.        Wildcards are permittted by using an 'X' for a don't
  90.        care.  This must be a seperate field, delimited by a
  91.        comma and there may be as many X's in the string as you
  92.        desire.  For example, entering a "Bo,X,"t,X  for a
  93.        search string would locate a match for BOATING, BOOTS,
  94.        or BOTTOM.  Excercise caution, because whenever the
  95.        wildcard(s) are present, any "X" in an ASCII string
  96.        will act as if it were a wild card too.
  97.  
  98.        You can terminate the search at any time by hitting any
  99.        character on the keyboard. This is useful if you are
  100.        searching a long file and realize that you entered the
  101.        wrong key.
  102.  
  103. 'Ucase'    When highlighted, it means that when searching for
  104.        an ASCII match, the case of the key and the string
  105.        matched against will NOT matter.  If not highlighted,
  106.        case does matter.  This feature can be toggled by
  107.        entering a "U" command.  If you perform a search on
  108.        a HEX, decimal, or ASCII and numerical combination,
  109.        Ucase will toggle to the OFF state.  In other words,
  110.        all searches will be exact matches if mixed or numeric.
  111.  
  112. 'Cont'       Continues the search for the last string found.
  113.  
  114. 'Address'  Allows a HEX address to be entered for positioning
  115.        from within the file or memory.
  116.  
  117. 'Edit'       Will place the cursor at the top left corner or at
  118.        the begining of the string that was found with a
  119.        'Search'.  Commands will be displayed to indicate
  120.        how you may move the cursor from within the display.
  121.        There are two sets of commands available, the standard
  122.        WordStar format and one for those who like to use
  123.        their right hand.  If you have cursor keypad that
  124.        outputs E2,E4,E6, and E8, then it will work.  (You
  125.        can use PATCH to change these for your particular
  126.        keypad, just search for them.)
  127.  
  128.        To change from the HEX field to the ASCII field, or
  129.        visa versa, enter a ^F.  To quit editing, enter a ^Q.
  130.        You will then be asked if you wish to WRITE the record
  131.        or ABORT the edit.
  132.  
  133. 'Page'       Paging is accomplished by either entering a + or -,
  134.        or hitting a RETURN for paging forward.
  135.  
  136. To use this program, it is necessary that your terminal have the follow-
  137. ing screen commands available:
  138.  
  139.     Cursor Addressing
  140.     Reverse Video
  141.     Clear Line
  142.     Clear Screen
  143.     Delete Line and scroll screen up
  144.     Insert Line and scroll screen down
  145.  
  146. To install this program for your terminal, use DDT to change the
  147. following locations. The first byte in each string is the number
  148. of bytes in the string.
  149.  
  150.     Cursor Addressing  018B  is currently 04,1B,3D,00,00
  151.                           ( 2 ESC = 0 0 )
  152.  
  153.        The last two bytes are the offset from 20H for row,col.
  154.        i.e., if your term uses an offset of 30H, then use 10H
  155.        or an offset of 0, then use FFDFH (-20D)
  156.  
  157.     Clear Screen       01A2  is currently 02,1B,2A ( 2 ESC * )
  158.     Clear Line       01BC  is currently 02,1B,54 ( 2 ESC T )
  159.     Start REV Video    01C8  is currently 02,1B,29 ( 2 ESC ) )
  160.     End REV Video       01C2  is currently 02,1B,28 ( 2 ESC ( )
  161.     Insert Line       01AE  is currently 02,80,0B
  162.     Delete Line       01B4  is currently 02,80,0A
  163.  
  164. I think you will find this a powerful PATCH utility and I hope you
  165. find it useful. Enjoy!    
  166.                     - Bill Rink  San Jose, CA
  167. 
  168. I think you w