home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / trompat2.lbr / -TRPATCH.DZC / -TRPATCH.DOC
Encoding:
Text File  |  1993-10-25  |  9.4 KB  |  212 lines
  1. -read.me 7/16/86
  2.  
  3.               TurboROM patches for Kaypro Software
  4.  
  5.  
  6.  
  7. This  disk contains files that are used to "patch" several appli-
  8. cation  programs  that  were  either bundled  by  Kaypro  or  are 
  9. specific  to  the  Kaypro.  The files that are required  for  the 
  10. patches are located on USER area 0:
  11.  
  12.  
  13.      1.   TRPATCH.COM  Executable program that does the patching.
  14.      2.   TRPATCH.DAT  Data file that contains the patch info.
  15.  
  16.  
  17. To  use the patch program,  the files TRPATCH.COM and TRPATCH.DAT 
  18. should  be copied to the same drive and user as  the  application 
  19. programs.  At  the operating system prompt enter "TRPATCH" and  a 
  20. RETURN  to execute the TRPATCH.COM program.   The TRPATCH program 
  21. will  present  a  menu  of  files  to  patch;   just  follow  the 
  22. instructions.
  23.           
  24. The  files on USER area 1 are the assembly language source  files 
  25. that are used for the patches.   These source files are  provided 
  26. for  the curious and are not required for the proper operation of 
  27. the TRPATCH program.
  28.  
  29.  
  30.                          <<< WARNING >>>
  31.  
  32.  
  33.  
  34. Do not use the  TRPATCH.COM program to patch your original copies 
  35. of your application programs.   Use the TRPATCH.COM program  only 
  36. on  backup  copies of the programs (if something goes  wrong  you 
  37. don't want to risk destroying your originals).
  38.  
  39.  
  40. The current version of the TRPATCH.DAT file contains patches  for 
  41. the following programs:
  42.  
  43.  
  44.             +------------+-----------+-------+     
  45.             |  Program   |  Version  | Notes |   
  46.             +------------+-----------+-------+   
  47.             | Automite   | Vers 1.60 |   3   |   
  48.             | Automite   | Vers 1.61 |  U,3  |   
  49.             | CalcStar   | Vers 1.46 |   U   |   
  50.             | DataStar   | Vers 1.42 |   U   |   
  51.             | FastBack83 | Vers 1.1  |   1   |   
  52.             | FastBack84 | Vers 1.1  |   2   |   
  53.             | FastRest83 | Vers 1.1b |   1   |   
  54.             | FastRest84 | Vers 1.1b |   2   |   
  55.             | Formgen    | Vers 1.42 |   U   |   
  56.             | MasterMenu | Vers 4.51 |   3   |   
  57.             | MasterMenu | Vers 5.22 |   3   |   
  58.             | MasterMenu | Vers 5.30 |  U,3  |   
  59.             | Redit      | Vers 1.03 |   U   |   
  60.             | Report     | Vers 1.03 |   U   |   
  61.             | Rinstall   | Vers 1.03 |   U   |   
  62.             | WordStar   | Vers 3.30 |  U,4  |   
  63.             | WordStar   | Vers 3.00 |  WSK  |   
  64.             | WordStar   | Vers 3.30 |  WSK  |   
  65.             +------------+-----------+-------+   
  66.  
  67.      Notes:
  68.  
  69.           (1)  These  patches  are  used to modify  FASTBACK  and 
  70.                FASTREST  for use on an '83 Kaypro with  an  added 
  71.                hard disk drive.
  72.           
  73.           (2)  These  patches  are used to  modify  FASTBACK  and 
  74.                FASTREST  for  use on an '84 Kaypro with an  added 
  75.                hard disk drive.
  76.           
  77.           (3)  These patches ensure that the 25th line is cleared 
  78.                correctly.
  79.           
  80.           (4)  This  patch  for WordStar is not specific  to  the 
  81.                versions  of  WordStar bundled with the   "U  ROM" 
  82.                software.   The  patch will work with nearly   all 
  83.                variations  of  WordStar 3.30 and  simply  insures 
  84.                that the arrow keys function within WordStar.
  85.       
  86.           (U)  These  patches are used to modify the versions  of 
  87.                these  applications that were bundled with the  "U 
  88.                ROM" machines from Kaypro.
  89.  
  90.         (WSK)  These patches for WordStar are identified with the 
  91.                "(WSK)" symbol in the TRPATCH menu.  These patches 
  92.                provide multiple key re-definitions for the Kaypro 
  93.                arrow and numeric key pads.  These patches require 
  94.                the  use of the WSCONFIG program included on  this 
  95.                diskette.   Additional information on the  use  of 
  96.                these  patches is found in the TurboROM manual and 
  97.                in several manuals from Plu*Perfect Systems.
  98.  
  99. Background Information On the Patches
  100.  
  101. Many  of  the application programs bundled by Kaypro with the  "U 
  102. ROM" computers are incompatible with the Advent TurboROM.   There 
  103. are  there  areas  of compatibility  problems  addressed  by  the 
  104. TRPATCH.COM patches:
  105.  
  106. 1.   Function key definitions.
  107.  
  108.      The  "U  ROM" operating system software (BIOS)  handles  the 
  109.      translation  of  the arrow and keypad keys  completely  dif-
  110.      ferently  than  the operating system software used with  any 
  111.      previous Kaypro computer.   The TurboROM fully supports  the 
  112.      arrow  and  keypad conventions established by  the  previous 
  113.      (pre-U  ROM)  computers.   All  of the "U  ROM"  application 
  114.      patches,  except for MASMENU and AUTOMITE,  modify the arrow 
  115.      key translation.
  116.  
  117. 2.   CRT screen handling
  118.  
  119.      TurboROM treats the CRT screen as either a 24 line scrolling 
  120.      region  with  a  fixed  25th status line or  as  a  25  line 
  121.      scrolling screen with no status line.   Although,  this des-
  122.      cription  seems  reasonable and follows conventions  set  by 
  123.      terminal  manufacturers,  the handling of the CRT screen  by 
  124.      the  original Kaypro ROM and the associated application pro-
  125.      grams is at times different and inconsistent at  best.   The 
  126.      patches for MASMENU and AUTOMITE deal primarily with the CRT 
  127.      handling problem.
  128.  
  129. 3.   Subtle problems
  130.  
  131.      Some  of  the  application  programs such  as  AUTOMITE  and 
  132.      various  versions of the MASMENU program have some very  odd 
  133.      operating  system dependencies.   The  dependencies  usually 
  134.      result  in the programs not exiting to the operating  system 
  135.      in  a  reliable manner to ensure that a "Warm Boot" is  exe-
  136.      cuted.   Changing  the CCP portion of the  operating  system 
  137.      from  Digital Research's CCP to ZCPR1 or Plu*Perfect Systems 
  138.      2.2E tends to aggravate the subtle problems with these  pro-
  139.      grams.
  140.  
  141.  
  142.  
  143. FASTBACK / FASTREST
  144.      
  145.      Fastback  and Fastrest are low cost and very fast hard  disk 
  146.      backup  and  restore  utilities written for the  Kayrpo  10.  
  147.      These  programs  can  back up a 10M hard disk  in  8  to  10 
  148.      minutes.   The backup utility does not require pre-formatted 
  149.      diskettes!!!.  
  150.  
  151.      Fastback works fine with and without the TurboROM.  FastBack 
  152.      is  not picky about the hard disk drive.   Fastback  can  be 
  153.      used  to  backup a stock Kaypro 10 hard disk drive and  then 
  154.      restore  the data to the same Kaypro after dropping  in  the 
  155.      TurboROM  and a 20M drive.  We've also used Fastback to load 
  156.      and unload our RAM Disk very quickly.
  157.  
  158.  
  159.      Fastback and Fastrest are hard coded for the Kaypro 10.  The 
  160.      patches provided here,  modify Fastback and Fastrest to  run 
  161.      on  both '83 and '84 Kaypros that have had hard disks added.  
  162.      These  patches  read and write using the first  floppy  disk 
  163.      drive and this drive MUST be a double sided 48TPI drive.
  164.  
  165.      Fastback is a commercial product available from:
  166.  
  167.  
  168.                eSOFT (Phil Becker)
  169.                4100 South Parker Road #305
  170.                Aurora, CO  80014
  171.                (303) 699-6565.
  172.      
  173.  
  174. WordStar Patches
  175.  
  176.      Kaypro  has  distributed two different releases of  WordStar 
  177.      (3.00 and 3.30).   Dealing with two different releases would 
  178.      not  have been a big problem if it wasn't for the fact  that 
  179.      Kaypro made numerous patches to the program.   We have  seen 
  180.      over 8 different sets of patches installed by Kaypro.     
  181.  
  182.      The  goal  for the patches presented here are the  same:  to 
  183.      ensure  that  the  Kaypro arrow keys  will  move  WordStar's 
  184.      cursor  about predictably.   The only versions  of  Wordstar 
  185.      that ABSOLUTELY require patches to run with the TurboROM are 
  186.      the  versions  that were bundled with the "U ROM"  machines.  
  187.      The  "U  ROM"  versions call  non-existent  subroutines  and 
  188.      generally will "lock up" your TurboROM-equipped TurboROM.
  189.  
  190.      The  first patch for WordStar 3.30 provides for  the  simple 
  191.      re-mapping of the arrow keys to match the MicroPro up, down, 
  192.      right,  and left definitions.  This patch is identified with 
  193.      the "(U)" symbol.  Although, this patch was intended for the 
  194.      "U  ROM"  version  of WordStar 3.30 it will  work  with  any 
  195.      version of WordStar 3.30.
  196.  
  197.      The  last two patches for WordStar are identified  with  the 
  198.      "(WSK)"  symbol in the TRPATCH menu.  These patches  provide 
  199.      multiple  key  stroke definitions for the Kaypro  arrow  and 
  200.      numeric  key  pads.   These patches require the use  of  the 
  201.      updated  WSCONFIG program included on this diskette.   
  202.  
  203.      The  "(WSK)"  patches  are  updated versions  of  the  WSKEY 
  204.      patches  included with the TurboROM and with several of  the 
  205.      Plu*Perfect  Systems products.  The original version of  the 
  206.      patch for WordStar 3.30 was buggy.   The bugs would show  up 
  207.      when  you  tried  to  use the "R" command  at  the  WordStar 
  208.      opening menu to run a CP/M program.   If you have  installed 
  209.      previous  versions of the WSKEY patches you MUST go back  to 
  210.      your  original WordStar diskette and get an original version 
  211.      of WordStar to install these new patches.
  212.