PCjs Machines

Home of the original IBM PC emulator for browsers.


PC-SIG Diskette Library (Disk #3080)

[PCjs Machine "ibm5170"]

Waiting for machine "ibm5170" to load....


║             <<<<  PC-SIG Disk #3080  BD/PATCH UTILITY  >>>>             ║
║                                                                         ║
║ Copy the program files to a subdirectory on your hard drive.            ║
║                                                                         ║
║ To print the documentation, type:  COPY README.TXT PRN    (press Enter) ║
║                                    COPY QUICKREF.TXT PRN  (press Enter) ║
║                                                                         ║
║ Then start the program by typing:  PATCH  (press Enter)                 ║
║                                                                         ║
║                                                                         ║
║                                        (c) Copyright 1992, PC-SIG Inc.  ║


                BD/PATCH Release 1.0   Quick Documentation

     BD/Patch  is  a versatile new utility from  Breakthrough  Designs  for 
viewing or editing files, and other file-like objects such as disk  drives, 
directories  and  memory.  Patch supports various display formats  to  help 
interpret the data being edited, but removes the usual restrictions on file 
and disk manipulation usually imposed by DOS or applications programs.  For 
this  reason it is both a powerful and useful tool, and a good way to  mess 
up  data if you're not sure what you're doing.  This program is a tool  for 
patching files and data; the intelligence for what you are accomplishing is 
     Patch is also a useful file or object viewer, to examine the structure 
of files or other data without making changes, and provides a good tool for 
seeing "what's inside" the data you examine.
     This program was created to fill several utility needs, and while this 
is  the  first commercial version of this program, it is  the  fifth  major 
revision  of a program which has been used profitably and powerfully  by  a 
number  of people for over six years.  Hopefully you will find  BD/Patch  a 
useful utility for your work as well.

====== ============
BD/Patch  requires  an  IBM-compatible computer running  MS-DOS  or  PC-DOS 
version  2.0  or  higher.  Version 3.0 or  higher  is  recommended.   Patch 
utilizes as much base memory as is available, but requires at least 220K of 
free  memory to operate.  Any standard video display will work with  Patch, 
although Patch has certain optional features which require an EGA or higher 
display.  Also, Patch makes use of the extended keyboards (twelve  function 
keys across the top) if you have one (and your system supports it).

The  programs  and files of Patch all fit, uncompressed, on a  single  low-
density  floppy  disk, and require less than 300K if installed  on  a  hard 
disk.   Simply copy the files from the Patch disk to a new floppy, or to  a 
hard disk subdirectory.
     While  the  Patch files take up little space on a hard disk,  you  may 
wish to eliminate some files if you are adding Patch to a "utilities" disk.  
Only  the  PATCH.EXE file is required for operation.   The  following  list 
describes the other files on the Patch disk, and what they are for:
     PATCH.HLP - the on-line help text.  If removed, no help is available.
     PATCH.PRF - these are your preferences, if you have set any.  If you
          remove this file, the factory defaults will be used.
     *.FS - any .FS file adds file system drivers.  If these are removed,
          Patch will only have FILE, SUBDIR, LDRIVE and PDRIVE.
     *.CTL - any .CTL file adds display format drivers.  If these are re-
          moved, Patch will only have HEX, TEXT, SUBDIR and LDRIVE.
     *.PRN - any .PRN file adds printer drivers.   If these are  removed,
          Patch will only have SIMPLE as a printer choice.
     QUICKREF.TXT - this document.
     README.TXT - quick description of the program and how to register.
     PATCH.PIF, PATCH.ICO - these are used by Microsoft Windows for infor-
          mation about this program, but are not required.

======= =====
To  start  the Patch program, if you are in the directory where  the  Patch 
program is located, just type "patch" and press the ENTER key.  Or, if  you 
have  from one to four files you would like to patch directly from the  DOS 
prompt, type the names of these files after "patch," such as:
     C:\PATCH>patch \mainmenu.mdf a:\sample.dat
If you want to patch a command from another file system, the format is  the 
same but the name is preceded by the file system and a colon, like this:
     C:\PATCH>patch mem:286 subdir:a:\temp
The number of files to patch you type specifies the number of windows which 
will  be  opened.   If you start Patch without any named  files,  a  single 
window appears with the "Opening Menu" displayed; choose options from  that 
by pressing the desired letter, or use the pull-down menus instead.
     MS-DOS  version 3.0 or higher is recommended if you run Patch  from  a 
different  directory than you are working in, which is often the case.   In 
MS-DOS  version  2, Patch can locate the supplemental files  if  Patch  was 
located  in  a  directory  specified  by the  path,  and  is  still  called 
"PATCH.EXE."   But  in  MS-DOS version 3 or higher, Patch  can  locate  the 
supplemental files based on how the command was started, regardless of what 
drive  or directory the files are on, or what the Patch command is  called.  
For example, if you had the Patch files on a floppy disk, you could type:
     C:\DOS>a:patch share.exe
Patch would run, and find all its files on the floppy disk, but only if the 
DOS  version is 3.0 or higher.  Under DOS 2.x, you would have to  make  the 
floppy drive the active drive and run from there, like this:
     A:\>cd patch
     A:\PATCH>patch c:\dos\share.exe

===== ========== == =====
Patch  was  written  to view and edit a variety  of  files,  and  file-like 
objects,  in a consistent and editor-like way.  There are  two  overlapping 
methods for controlling Patch, one based upon the WordStar editor, and  the 
other  based  on cursor and function keys and pull-down menus,  which  have 
become customary elements in PC software.
     The cursor keys on your keyboard do pretty much what you would expect.  
The function keys are labeled at the bottom of the Patch screen by  default 
(you can remove the labels if you wish).  The pull-down menus are  operated 
by  pressing the ALT key and the first letter of the menu you  want  (these 
are  displayed  across the top line of the screen), and then  selecting  an 
option from the menu with the cursor keys and pressing ENTER on the one you 
want.  Menu options may also be chosen by typing the capitalized letter  on 
the option you want.
     The  WordStar codes are faster to use and harder to learn.   They  all 
require  a control code (press the CTRL key and the letter you want),  many 
commands  also  requiring a second character which need not  be  a  control 
code.   The commands are represented with a carat (^) symbol to indicate  a 
control  code, so "^KX" means press Ctrl-K, and then X (which can be  upper 
or  lower  case,  or even Ctrl-X).  If you are already  familiar  with  the 
WordStar editor many of the commands will be familiar to you.  If not,  but 
you  wish to learn them, the command reference in this document provides  a 
list,  or  you can turn on WordStar menus by setting the help level  to  3; 
this can be done with the command ^JJ3.
     Patch  can edit up to four files at one time; each appears in its  own 
"window"  (a group of screen lines independent from the others).  Only  one 
window  can be edited at one time, but the other windows continue  to  show 
what you are working on.  The F10 key jumps between windows.
     Several  commands for patching a file use "blocks," meaning a  section 
of the file which you define and use as a single item for this command.  In 
WordStar  commands, you mark the block with the ^KB and ^KK  commands,  and 
then  use  a  command to do something with that block.   In  the  pull-down 
menus, on the other hand, you choose the command, and Patch prompts you  to 
mark the length of the block (and, for some commands, where you want to use 
the  block  as well).  For this reason the two sets of block  commands  are 
similar but not the same.
     Patch has a number of built-in display formats, and some standard add-
on  display formats.  Built-in formats include HEX (displaying  hexadecimal 
bytes  and  ASCII equivalences; this is the default), TEXT (a  simple  text 
editor screen, but awkward if your file isn't text), SUBDIR (the format for 
subdirectory  data) and LDRIVE (the format for a logical drive).  The  file 
PATCH.CTL currently adds the DEC and OCT formats, which are similar to  HEX 
but use decimal or octal, respectively.
     Patch has a number of built-in file systems, and some standard  add-on 
file systems.  Built-in systems include FILE (normal DOS files; this is the 
default),  SUBDIR (DOS subdirectories), LDRIVE (a logical drive,  named  by 
its drive letter) and PDRIVE (a physical drive, named by its unit  number).  
The  file  PATCH.FS currently adds the MEM file system, which  patches  the 
"files"  BASE  (1M of system base memory), 286 (16M of memory on a  286  or 
higher  processor),  386 (4G of memory on a 386 or higher  processor),  and 
CMOS  (the  battery-backed  real time clock and config memory  in  most  AT 
     For  printing,  Patch  can support several printer  types,  which  are 
loaded  from  the  file PATCH.PRN.  Without the .PRN  file(s),  Patch  only 
supports  the SIMPLE printer type, which works suitably on any printer  but 
doesn't make the same data distinctions one of the named printer types can.
     Other  file systems, display formats and printer drivers can be  added 
to  your Patch program by simply adding the appropriate .FS, .CTL  or  .PRN 
files to the location of your existing Patch files.
     You  can change many of the default options in Patch to suit your  own 
preferences,  and to configure Patch to your display if your computer  will 
support 132-column text modes.  These settings are all accomplished via the 
"Prefer"  pull-down menu, and can be saved to the file PATCH.PRF to  become 
your new defaults.
                PATCH PLUS Release 1.0   Command Reference

Conventions:   WordStar control codes are shown in "carat" notation, as  in 
"^KX".  Keyboard keys are shown in all caps, like "RIGHT" or "F10".   Pull-
down menu options are shown by their displayed names, inside angle  braces, 
like  "<File,Save>".   For more help on any of these commands,  invoke  the 
Help system (F1, or ^Jc where c is a WordStar command).

======== ====== ====
F1 (HELP) - Invokes help for this screen or general help index
F2 (GOTO) - Direct jump to location, same as ^QI or <Move,Absolute>
F3 (FIND) - Search for string or bytes, same as ^QF or <Move,Search>
F4 (PREV) - Jump to previous location, same as ^QP
F5 (HEADR) - Toggle window header between display modes
F6 (RSIZE) - Select record size, start offset, same as ^OR
F7 (CHECK) - Re-examine file for changes, same as ^KL or <File,Look>
F8 (UNDO) - Discard unwritten (highlighted) changes, same as ^U
F9 (SAVE) - Write unwritten changes, same as ^KS or <File,Save>
F10 (delta-WIN) - Change to next window, same as <Window,Next>, like ^OK
F11 (CLOSE) - Closes window, saving changes, same as ^KD or <File,Close>
F12 (EXIT) - Return to DOS, same as ^KX or <File,eXit>
SHIFT+F1 - Same as F11, for older keyboards
SHIFT+F2 - Same as F12, for older keyboards
LEFT - Cursor left, same as ^S
CTRL+LEFT - "Word" left, same as ^A
ALT+LEFT - All the way left, same as ^QS
RIGHT - Cursor right, same as ^D
CTRL+RIGHT - "Word" right, same as ^F
ALT+RIGHT - All the way right, same as ^QD
UP - Cursor up, same as ^E
CTRL+UP - Scroll up, same as ^W
DOWN - Cursor down, same as ^X
CTRL+DOWN - Scroll down, same as ^Z
PGUP - Cursor up one windowfull, same as ^R
CTRL+PGUP - Up one logical record, same as ^Q-
ALT+PGUP - Previous window
PGDN - Cursor down one windowfull, same as ^C
CTRL+PGDN - Down one logical record, same as ^Q+
ALT+PGDN - Next window, same as F10 or <Window,Next>
HOME - Cursor to top left of window, same as ^QE
CTRL+HOME - Cursor to top of file, same as ^QR
ALT+HOME - Select top window
END - Cursor to bottom right of window, same as ^QX
CTRL+END - Cursor to bottom of file, same as ^QC
ALT+END - Select bottom window
INS - Toggle insert mode between "Ovr," "InsB" and "Ins," same as ^V
DEL - Delete a character, if insert mode active, same as ^G
TAB - In HEX, DEC or OCT displays, toggles to/from text section
+ - On numeric data, increments value
- - On numeric data, decrements value

======== ===== ========
^A - "Word" left, same as Ctrl-LEFT
^B - Accept next character as literal and set high bit
^C - Page down, same as PGDN
^D - Cursor right, same as RIGHT
^E - Cursor up, same as UP
^F - "Word" right, same as Ctrl-RIGHT
^G - Delete a character, if insert mode active, same as DEL
^H - Backspace, generally same as ^S or LEFT
^I - In HEX, DEC or OCT, toggles to/from text, same as TAB
^J - WordStar help screen
^Jc (c is any WordStar command) - Display help for command
^JJn (n is 0-3) - Set help level to n, similar to <Help,Level>
^K - Block/file operations menu
^KB - Mark beginning of block for WordStar block commands
^KC - Copy marked block to this location, similar to <Edit,Copy block>
^KD - Save changes and close window, same as <File,Close>
^KF - Run DOS command (if typed) or DOS shell, same as <File,Run cmd>
^KH - Toggle display of blocks and place markers
^KK - Mark end of block for WordStar block commands
^KL - Re-examine file for changes, same as F7
^KP - Print block, if marked, or file, similar to <File,Print>
^KQ - Abandon changes and close window, same as <File,Abandon>
^KR - Read in or insert external file, same as <Edit,Read block>
^KS - Save changes and continue editing, same as <File,Save> or F9
^KV - Move marked block to this location, similar to <Edit,Move block>
^KW - Write marked block to a file, similar to <Edit,Write block>
^KX - Return to DOS, same as <File,eXit> or F12
^KY - Delete marked block, similar to <Edit,Delete block>
^Kn (n is 0-9) - set place marker n, similar to <Move,Place marker>
^K= - Fills marked block with value, similar to <Edit,mOdify,Fill>
^K+ - Adds value to block bytes, similar to <Edit,mOdify,Add>
^K- - Subtracts value from block bytes, similar to <Edit,mOdify,Subtract>
^K* - Multiplies block bytes by value, similar to <Edit,mOdify,Multiply>
^K/ - Divides block bytes by value, similar to <Edit,mOdify,Divide>
^K& - Logical-AND block bytes with value, similar to <Edit,mOdify,aNd>
^K| - Logical-OR block bytes with value, similar to <Edit,mOdify,Or>
^K^ - Logical-XOR block bytes with value, similar to <Edit,mOdify,eXclusive>
^K' - Converts block to lowercase, similar to <Edit,mOdify,Lowercase>
^K" - Converts block to uppercase, similar to <Edit,mOdify,Uppercase>
^K! - Locks marked block, similar to <Edit,Locking,Lock>
^K. - Unlocks last lock, same as <Edit,Locking,Unlock>
^L - Look again, repeats last ^QF or ^QA
^M - Same as ENTER
^N - If insertion allowed, inserts carriage return/line feed
^O - On-screen operations menu
^OB - Selects on-screen treatment of bytes with high bits set
^OF - Selects new screen format driver
^OH - Selects base used for window header
^OK - If only one window, creates another; otherwise, next window
^OL - Toggles display of function key labels
^OM - Selects position representation used for window header
^OO - Toggles outlined window feature
^OP - "Protects" a file from accidental changes
^OR - Select record size and start offset, same as F6
^OU - Selects on-screen treatment of bytes in unprintable ASCII ranges
^OV - Selects the video display mode to use
^O[ - Defines current position as start of record 0 (sets record offset)
^O] - Defines current position as end of record 0 (sets record size)
^O. - Toggles automatic record blocking mode
^O= - For some display drivers, displays logical layout of file
^O? - Displays memory usage within Patch at this moment
^P - Accepts next character as literal, not command
^Q - "Quick" operations menu
^QA - Search and replace, same as <Move,Replace>
^QB - Jump to beginning of marked block
^QC - Jump to end of file, same as Ctrl-END or <Move,End>
^QD - Move all the way to the right, same as Alt-RIGHT
^QE - Move to top left corner, same as HOME
^QF - Search for string or bytes, same as <Move,Search>
^QI - Move to absolute position, same as F2
^QK - Jump to end of marked block
^QP - Jump to previous location, same as F4
^QR - Jump to beginning of file, same as Ctrl-HOME or <Move,Beginning>
^QS - Move all the way to the left, same as Alt-LEFT
^QX - Move to bottom right corner, same as END
^QY - Truncate file here, same as <Edit,Truncate file>
^Qn (n is 0-9) - Move to marker n, similar to <Move,to Marker>
^Q[ - Move to beginning of record 0
^Q] - Move to end of record 0
^Q! - Move to start of locked region, same as <Edit,Locking,Go to lock>
^Q+ - Advance one logical record, same as Ctrl-PGDN
^Q- - Back up one logical record, same as Ctrl-PGUP
^R - Page up, same as PGUP
^S - Cursor left, same as LEFT
^T - Delete a "word," if insert mode active
^U - Discard unwritten changes, same as F8
^V - Toggles insert modes between "Ovr," "InsB" and "Ins," same as INS
^W - Scroll up one line, same as Ctrl-UP
^X - Cursor down, same as DOWN
^Y - Delete a screen line, if insert mode active
^Z - Scroll down one line, same as Ctrl-DOWN

==== ==== ==== ========
<File,Open> - Select a file to patch (defaults: FILE, HEX, Read/Write)
<File,View> - Select a file to patch (defaults: FILE, HEX, Read-only)
<File,Save> - Saves changes, continues editing, same as ^KS or F9
<File,Close> - Saves changes, closes window, same as ^KD or F11
<File,Abandon> - Discards changes, closes window, same as ^KQ
<File,Print> - Prints entire file, similar to ^KP
<File,Look> - Re-examines file for changes, same as ^KL or F7
<File,Run cmd> - Execute a DOS command, or run DOS shell, same as ^KF
<File,eXit> - Close all windows and return to DOS, same as ^KX or F12
<Edit,Copy block> - Prompt for block, and where to copy to, similar to ^KC
<Edit,Move block> - Prompt for block, and where to move to, similar to ^KV
<Edit,Delete block> - Prompt for block to delete, similar to ^KY
<Edit,mOdify,Fill block> - Prompt for block, byte to fill with, similar to ^K=
<Edit,mOdify,Add> - Prompt for block, byte to add, similar to ^K+
<Edit,mOdify,Subtract> - Prompt for block, byte to subtract, similar to ^K-
<Edit,mOdify,Multiply> - Prompt for block, byte to multiply, similar to ^K*
<Edit,mOdify,Divide> - Prompt for block, byte to divide by, similar to ^K/
<Edit,mOdify,Or> - Prompt for block, byte to logical-OR with, similar to ^K|
<Edit,mOdify,aNd> - Prompt for block, byte to logical-AND with, similar to ^K&
<Edit,mOdify,eXclusive-or> - Prompt for block, byte to XOR with, similar to ^K^
<Edit,mOdify,Uppercase> - Prompt for block to upper-case, similar to ^K"
<Edit,mOdify,Lowercase> - Prompt for block to lower-case, similar to ^K'
<Edit,Write block> - Prompt for block to write to a file, similar to ^KW
<Edit,Read block> - Read in or insert file, same as ^KR
<Edit,Print block> - Prompt for block to print, similar to ^KP
<Edit,Insertion,None> - Sets "Ovr" mode - no inserts/deletes allowed
<Edit,Insertion,Block> - Sets "InsB" mode - inserts/deletes within marked block
<Edit,Insertion,Full> - Sets "Ins" mode if allowed - full inserts/deletes
<Edit,Locking,Lock> - Prompts for block and locks it, similar to ^K!
<Edit,Locking,Unlock> - Releases last lock set, same as ^K.
<Edit,Locking,Go to lock> - Moves to position of last lock set, same as ^Q!
<Edit,Truncate file> - If possible, resets file length to location, same as ^QY
<Move,Search> - Search for string or bytes, same as ^QF or F3
<Move,Replace> - Search and replace, same as ^QA
<Move,Look again> - Repeats last <Move,Search> or <Move,Replace>, same as ^L
<Move,Absolute> - Jump to absolute location, same as ^QI or F2
<Move,to Marker> - Move to one of up to ten place markers, similar to ^Qn
<Move,Place marker> - Set one of up to ten place markers, similar to ^Kn
<Move,Beginning> - Jump to start of file, same as ^QR or Ctrl-HOME
<Move,End> - Jump to end of file, same as ^QC or Ctrl-END
<View,Format> - Selects a new display format driver, same as ^OF
<View,Structure,View> - For some drivers, shows file structure, same as ^O=
<View,Structure,Records> - Set record size and start offset, same as ^OR
<View,Header,nOne> - Display no header in this window
<View,Header,Decimal> - Display header in decimal numbers (usually one line)
<View,Header,Hex> - Display header in hexadecimal numbers (usually one line)
<View,Header,Both> - Display header in hex and decimal (usually two lines)
<View,Header,Absolute> - Display header locations as absolute byte values
<View,Header,Record> - Display header locations as record and offset
<View,Header,Native> - Display header locations according to file driver
<View,Header,Custom> - Display header locations according to display driver
<View,Unprintable,Full character set> - Unprintable ASCII shows as IBM graphic
<View,Unprintable,Represent controls> - Unprintables show as ASCII designation
<View,Unprintable,Dot display> - Unprintables show as a dot (".")
<View,Unprintable,Color-code high bits> - High-bit chars are a different color
<View,Unprintable,Ignore high bits> - High-bit chars displayed as IBM graphic
<View,Unprintable,Strip high bits> - High-bit chars displayed as high-bit off
<View,Display,Normal> - Display 25x80 text (works on any PC)
<View,Display,Ega> - Display 43x80 text (works on EGA and above)
<View,Display,Vga> - Display 50x80 text (works on VGA and above)
<View,Display,Wide> - Display 25x132 text (on video displays supporting it)
<View,Display,Tiny> - Display 43x132 text (on video displays supporting it)
<View,function Keys> - Toggles the display of function key labels, same as ^OL
<View,Boxed windows> - Toggles the display of window outlines, same as ^OO
<View,Option> - For drivers supporting them, offers additional options
<Window,Open> - Create another window (up to four allowed)
<Window,Close> - Close the current window, same as F11 or ^KD
<Window,Next> - Switch to next window down, same as F10
<Prefer,Colors> - Set Patch preferences for screen color usage
<Prefer,Display> - Set Patch preferences for display characteristics
<Prefer,Hardware> - Set hardware-specific options
<Prefer,Printer> - Set Patch preferences for printing
<Prefer,Options> - Set Patch preferences for option default settings
<Prefer,Save> - Save your preferences as new defaults
<Help,Index> - Invoke Help system, starting at front index, similar to F1
<Help,Keyboard> - Provide help for keyboard commands
<Help,Mouse> - Provide help for using a mouse with Patch
<Help,meNus> - Provide help with pull-down menus
<Help,Level> - Set help level 0-3, similar to ^JJn
<Help,About> - Displays Patch version and copyright information



This  file  accompanies  the BD/Patch Utility.  An  additional  text  file, 
QUICKREF.TXT,  describes the commands and general concepts of the  program.  
You may wish to print out the QUICKREF.TXT file before using Patch.

BD/Patch  is  a  product of Breakthrough Designs,  and  is  distributed  as 
"shareware."   What this means is that you may freely copy, distribute  and 
examine  this  software.   However, if you find it  useful  and  intend  to 
continue  using  it,  you are required to pay Breakthrough  Designs  for  a 
license  to  continue  using the software.  This one-time  license  fee  is 
only  $25.00,  and entitles you to both the latest  shareware  version  and 
product  announcements  as we release new versions and/or titles,  both  in 
shareware and commercial form.

There  is  no  way that we can enforce your  obligation  to  register  this 
product.   However,  we hope that you will do so in order  to  support  our 
development  of future products.  The shareware concept depends  upon  this 
sort  of support, and represents an excellent value compared to prices  for 
commercial software.

When you register BD/Patch, please send $25.00, along with the version  and 
serial numbers of the copy you have (from within Patch, press ^O? for  this 
information), to:

               Breakthrough Designs
               525 Alexander Street
               Greensburg, PA 15601

For  comments  or  suggestions  (not orders),  you  can  also  contact  the 
program's primary author, Mark Bereit, directly by electronic mail at:

               marky@draco.ece.cmu.edu  (Internet)
               74040,1003               (CompuServe)

If  you  distribute copies of BD/Patch, all the original files  (listed  in 
QUICKREF.TXT) must accompany the PATCH.EXE program in unmodified form.   If 
you  are a commercial distributor, please let us know so that we  can  keep 
you informed as we develop new shareware programs or updates.

Directory of PC-SIG Library Disk #3080

 Volume in drive A has no label
 Directory of A:\

PATCH    CTL      3433   3-19-92  10:20p
PATCH    EXE    169371   3-31-92  11:31p
PATCH    FS        902   6-29-91  11:07p
PATCH    HLP     61784   3-31-92  11:25p
PATCH    ICO       766   7-31-91  10:34a
PATCH    PIF       545   6-14-91   2:00p
PATCH    PRN      3766   1-11-92   2:26p
QUICKREF TXT     22912   3-31-92  11:36p
README   TXT      2176   3-19-92  10:12p
GO       BAT        38   1-31-91  12:58a
GO       TXT      1078   8-27-92   9:54a
       11 file(s)     266771 bytes
                       49152 bytes free