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