home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.barnyard.co.uk
/
2015.02.ftp.barnyard.co.uk.tar
/
ftp.barnyard.co.uk
/
cpm
/
walnut-creek-CDROM
/
MBUG
/
MBUG049.ARC
/
PATCH.DOC
< prev
next >
Wrap
Text File
|
1979-12-31
|
9KB
|
198 lines
************************************************************************
* *
* PATCH 1.3 DOCUMENTATION *
* *
************************************************************************
Note: This was compiled with a Z80 version TURBO PASCAL compiler.
First Release Date October 15, 1984; Patch 1.0
Release Date October 21, 1984; Patch 1.1
1. Changed Search function to disreguard upper/lower case distinction
2. Search now begins at current record and wrapps around
3. Now able to select disks other than default
4. Added Display mode that prints ASCII files out in line format
for better readability
Release Date October 31, 1984; Patch 1.2
5. Fixed search function to stop after wrap around to start of search
6. Added tabbing to ascci display mode (tabsize=8)
7. Quicker disk operations during searches
8. Default disk changed when reference is made to a disk in File Name
9. Added a WILDCARD to the search routine
Release Date November 13, 1984; Patch 1.3
I received a phone call from Irv Hoff telling me that
people were having difficulty running the .COM file,
most likely because of TPA size differences. Well, as
it turned out that was the problem. Evidently when
TURBO PASCAL compiles a program, it records the top
of the TPA in the file so that upon loading the .COM
file into memory it sets the program variable space
at the top of memory. Well, if your running ZCPR3 or
have a large BIOS, then most likely PATCH was
stepping all over your CCP and causing untold
problems. This new version was compiled for a TPA
size of 48k, top of TPA set to BF00. Thanks to Irv
Hoff for pointing it out! By the way, Irv will be
locating someone with an 8080 TURBO PASCAL compiler
so a non-Z80 version can be started for all those
Intel fans.
PATCH 1.3 (c) Copyright Bill Rink; 1984
This software is made available to the public domain and
may be freely distributed. It is not to be sold or used
for commercial use and is donated as appreciation for all
the fine software made available by the unselfish individuals
that have contributed to the public domain.
PATCH is a file/memory editor that allows for easy access
of either individual records within a file or pages within
memory. PATCH can operate in one of two modes; accessing
128 byte records from within the selected file, or 256 byte
pages of processor memory (up to 64k). Reguardless of which
mode you are in, there are 256 bytes of information displayed
on the screen. PATCH works like a full screen editor when changing
hex data. In addition, it has search capabilities on any
combination of either HEX, DECIMAL, or ASCII fields that are
separated by commas.
PATCH is based upon the concept of EDFILE, a program which I
have used extensively and enjoyed tremendously. My desire was
to make an enhanced version that would be easy to use and more
versatile. In a later version, I plan to have the option of
displaying the various addresses associated with the operating
system (BDOS,CCP,BIOS, jump table, etc.) and allowing easy access
to these memory pages or disk records.
Selecting a Mode
When the program initializes, you are asked to select whether
you wish to edit a FILE or MEMORY. Once you have selected the
desired mode, you will either be prompted for the file name
or shown the first page of memory (page 0).
Commands
You will then be shown a list of commands to use for operating
in that mode. The command set is more complete in the file mode
due to the nature of operation.
'Display' This will change the dispaly mode for looking at a file.
If you are looking at a file in the hex/ascii mode,
entering a "D" will toggle you into a ascii line mode
in which each line is strickly ascii and is terminated
by a CR,LF. Any non-printable characters will be shown
as a reverse video field to indicate them as such. Tabs
are converted, using a tab size of 8.
'Record' Enter the record number within the file that you wish
to access. This is a DECIMAL record number. The EOF
record is shown next to the file name.
'Base' Allows changing the BASE address used as a reference
while in a file. The default is 100h. This is useful
when viewing image files of the operating system.
'Search' Will prompt you for a search key to be used for scanning
records or memory. You may search for any combination of
character types (hex, decimal, or Ascii). To denote
the different types, you use a prefix before the field.
Use quotes (") at the beginning of any ascii field, a
decimal point (.) at the beginning of a decimal field,
and h at the start of a hex field. If you leave the prefix
out, it will be assumed to be hex. Separate each field
with a comma.
eg. "This is ASCII,.1234,0FE1,"etc
Will search for an ascii string followed by a decimal,
hex, and ascii field.
When a string is found, it will be reverse highlighted
to denote it from the rest.
Wildcards are permittted by using an 'X' for a don't care.
This must be a seperate field, delimited by a comma and there
may be as many X's in the string as you desire.
For example, entering a "Bo,X,"t,X for a search string would
locate a match for BOATING, BOOTS, or BOTTOM. Excercise caution,
because whenever the wildcard(s) are present, any "X" in an
ascii string will act as if it were a wild card too.
You can terminate the search at any time by hitting any
character on the keyboard. This is useful if you are
searching a long file and realize that you entered the
wrong key.
'Ucase' When highlighted, it means that when searching for an ASCII
match, the case of the key and the string matched against
will NOT matter. If not highlighted, case does matter. This
feature can be toggled by entering a "U" command. If you
perform a search on a hex, decimal, or ascii and numerical
combination, Ucase will toggle to the OFF state. In other
words, all searches will be exact matches if mixed or numeric.
'Cont' Continues the search for the last string found.
'Address' Allows a HEX address to be entered for positioning from
within the file or memory.
'Edit' Will place the cursor at the top left corner or at the
begining of the string that was found with a 'Search'.
Commands will be displayed to indicate how you may
move the cursor from within the display. There are
two sets of commands available, the standard WordStar
format and one for those who like to use thier right hand.
If you have cursor keypad that outputs E2,E4,E6, and E8,
then it will work. (You can use PATCH to change these
for your particular keypad, just search for them)
To change from the HEX field to the ASCII field, or
visa versa, enter a ^F.
To quit editing, enter a ^Q.
You will then be asked if you wish to WRITE the record
or ABORT the edit.
'Page' Paging is accomplished by either entering a + or -,
or hitting a RETURN for paging forward.
To use this program, it is necessary that your terminal have the
following screen commands available:
Cursor Addressing
Reverse Video
Clear Line
Clear Screen
Delete Line and scroll screen up
Insert Line and scroll screen down
To install this program for your terminal, use DDT to change the
following locations. The first byte in each string is the number
of bytes in the string.
Cursor Addressing 018B is currently 04,1B,3D,00,00 ( 2 ESC = 0 0 )
last two bytes are the offset from 20h for row,col.
i.e., if your term uses an offset of 30h, then use 10h
or an offset of 0, then use FFDFh (-20d)
Clear Screen 01A2 is currently 02,1B,2A ( 2 ESC * )
Clear Line 01BC is currently 02,1B,54 ( 2 ESC T )
Start REV Video 01C8 is currently 02,1B,29 ( 2 ESC ) )
End REV Video 01C2 is currently 02,1B,28 ( 2 ESC ( )
Insert Line 01AE is currently 02,80,0B
Delete Line 01B4 is currently 02,80,0A
I think you will find this a powerful PATCH utility and I hope you
find it useful. Enjoy! Bill Rink San Jose, California
TURBO PASCAL is copyrighted by Borland International, Scotts Valley, Ca.
Clear Line
Clear Screen
Delete Line and scroll screen up
Insert Line and scroll screen down
To install this p