home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / patch18a.lbr / PATCHINS.DZC / PATCHINS.DOC
Encoding:
Text File  |  1993-10-25  |  10.4 KB  |  235 lines
  1. TERMINAL INSTALLATION
  2.  
  3.  
  4. Before you use PATCH, it must be installed to your particular terminal
  5. i.e., provided with information regarding control characters required
  6. for certain functions.    This installation is easily performed using the
  7. program PINSTALL which is described in the following.
  8.  
  9. After having made a work-copy, please store your distribution diskette
  10. safely away and work only on the copy.
  11.  
  12. Now start the installation by typing PINSTALL at your terminal.  Select
  13. sreen installation from the main menu.    Depending on your version of
  14. PATCH, the installation proceeds as described in the following two sec-
  15. tions.
  16.  
  17.  
  18. A menu listing a number of popular terminals will appear, inviting you
  19. to choose one by entering its number:
  20.  
  21. ------------------------------------------------------------------------
  22.    Choose one of the following terminals:
  23.  
  24.      1) ADDS 20/25/30           15) Lear-Siegler ADM-31
  25.      2) ADDS 40/60           16) Liberty
  26.      3) ADDS Viewpoint-1A      17) Morrow MDT-20
  27.      4) ADM 3A               18) Otrona Attache
  28.      5) Ampex D80           19) Qume
  29.      6) ANSI               20) Soroc IQ-120
  30.      7) Apple/graphics           21) Soroc new models
  31.      8) Hazeltine 1500           22) Teletext 3000
  32.      9) Hazeltine Esprit       23) Televideo 912/920/925
  33.     10) IBM PC CCP/M b/w       24) Visual 200
  34.     11) IBM PC CCP/M color     25) Wyse WY-100/200/300
  35.     12) Kaypro 10           26) Zenith
  36.     13) Kaypro II and 4        27) None of the above
  37.     14) Lear-Siegler ADM-20    28) Delete a definition
  38.  
  39.    Which terminal? (Enter no. or ^X to exit):
  40. ------------------------------------------------------------------
  41.             Terminal Installation Menu
  42.  
  43. If your terminal is mentioned, just enter the corresponding number, and
  44. the installation is complete.  Before installation is actually perform-
  45. ed, you are asked the question:
  46.  
  47. ------------------------------------------------------------------
  48.    Do you want to modify the definition before installation?
  49. ------------------------------------------------------------------
  50.  
  51. This allows you to modify one or more of the values being installed as
  52. described in the following.  If you do not want to modify the terminal
  53. definition, just type N, and the installation completes by asking you
  54. the operating frequency of your CPU (see last item in this appendix).
  55.  
  56. If your terminal is not on the menu, however, you must define the re-
  57. quired values yourself.  The values can most probably be found in the
  58. manual supplied with your terminal.
  59.  
  60. Enter the number corresponding to "none of the above" and answer the
  61. questions one by one as they appear on the screen.
  62.  
  63. In the following, each command you may install is described in detail.
  64. Your terminal may not support all the commands that can be installed.
  65. If so, just pass the command not needed by typing RETURN in response to
  66. the prompt.  If Delete line, Insert line, or Erase to end of line is not
  67. installed, these functions will be emulated in software, slowing screen
  68. performance somewhat.
  69.  
  70. Commands may be entered either simply by pressing the appropriate keys
  71. or by entering the decimal or hexadecimal ASCII value of the command.
  72. If a command requires the two characters 'ESCAPE' and '=', may:
  73.  
  74.     either Press first the ESC key then the =.  The entry will
  75.     be echoed with appropriate labels i.e., <ESC> =.  Enter the
  76.     decimal or hexadecimal values separated by spaces.  Hexadec-
  77.     imal values must be preceded by a dollar sign.    Enter e.g.
  78.     27 61 or $1B 61 or $1B $3D which are all equivalent.
  79.  
  80. The two methods cannot be mixed i.e., once you have entered a non-numeric
  81. character, the rest of that command must be defined in that mode, and
  82. vice versa.
  83.  
  84. A hyphen entered as the very first character is used to delete a com-
  85. mand, and echoes nothing to the text.
  86.  
  87. Terminal type:
  88. ------------------------------------------------------------------------
  89. Enter the name of the terminal you are about to install.  When you com-
  90. plete PINSTALL, the values will be stored and the terminal name will ap-
  91. pear on the initial list of terminals.    If you later need to re-install
  92. PATCH to this terminal, you can do that by choosing it from the list.
  93.  
  94. Send an initialization string to the terminal?
  95. ------------------------------------------------------------------------
  96. If you want to initialize your terminal when  PATCH starts (e.g. to down-
  97. load commands to programmable function    keys), you answer Y for yes to
  98. this question.    If not, just hit RETURN.
  99.  
  100. If you answer Y, you may choose between entering the command directly or
  101. defining a file name containing the command string.  The latter is a
  102. good idea if the initialization string is long, as sinc a string to pro-
  103. gram a number of function keys would be.
  104.  
  105. Send a reset string to the terminal?
  106. ------------------------------------------------------------------------
  107. Here, you may define a string to be sent to the terminal when PATCH ter-
  108. minates.  The description of the initialization command above, applies
  109. here.
  110.  
  111. CURSOR LEAD-IN command:
  112. ------------------------------------------------------------------------
  113. Cursor Lead-in is a special sequence of characters which tells your ter-
  114. minal that the following characters are an address on the screen on which
  115.  
  116.  
  117. the cursor should be placed.  When you define this command, you are asked
  118. the following supplementary questions:
  119.  
  120. --------------------------------------------------------------------
  121.     Some terminals need a command between the two numbers defin--
  122.     ing the row and column cursor address.
  123.  
  124.     CURSOR POSITIONING COMMAND to send after line and column:
  125.     -----------------------------------------------------------
  126.     Some  terminals need a command after the two numbers defin-
  127.     ing the row and column cursor address.
  128.  
  129.     Column first?
  130.     -----------------------------------------------------------
  131.     Most terminals require the address on the format:  First
  132.     ROW, then COLUMN.  If this is the case on your terminal,
  133.     answer N.  If your terminal wants COLUMN first, then ROW,
  134.     then answer Y.
  135.  
  136.     OFFSET to add to LINE
  137.     -----------------------------------------------------------
  138.     Enter the number to add to the LINE (ROW) address.
  139.  
  140.     OFFSET to add to COLUMN
  141.     -----------------------------------------------------------
  142.     Enter the number to add to the COLUMN address.
  143.  
  144.     Binary address?
  145.     -----------------------------------------------------------
  146.     Most terminals need the cursor address sent on binary form.
  147.     If that is true for your terminal, enter Y.  If your termi-
  148.     nal expects the cursor address as ASCII digits, enter N.
  149.     If so, you are asked the supplementary question:
  150.  
  151.     2 or 3 ASCII digits?
  152.     -----------------------------------------------------------
  153.     Enter the number of digits in the cursor address for your
  154.     terminal.
  155.  
  156. CLEAR SCREEN command:
  157. ------------------------------------------------------------------------
  158. Enter the command that will clear the entire contents of your screen,
  159. both foreground and background, if applicable.
  160.  
  161. Does CLEAR SCREEN also HOME cursor?
  162. ------------------------------------------------------------------------
  163. This is normally the case; if it is not so on your terminal, enter N and
  164. define the cursor HOME command.
  165.  
  166. DELETE LINE command:
  167. ------------------------------------------------------------------------
  168. Enter the command that deletes the entire line at the cursor position.
  169.  
  170. INSERT LINE command:
  171. ------------------------------------------------------------------------
  172. Enter the command that inserts a line at the cursor position.
  173.  
  174. ERASE TO END OF LINE command:
  175. ------------------------------------------------------------------------
  176. Enter the command that erases the line at the cursor position from the
  177. cursor position through the right end of the line.
  178.  
  179. START OF 'LOW VIDEO' command:
  180. ------------------------------------------------------------------------
  181. If your terminal supports different video intensities, then define the
  182. command that initiates the dim video here.  If this command is defined,
  183. the following question is asked:
  184.  
  185.     START OF 'NORMAL VIDEO' command:
  186.     ------------------------------------------------------------
  187.     Define the command that sets the screen to show characters
  188.     in 'normal' video.
  189.  
  190.     NOTE:  Because PATCH uses REVERSE VIDEO HIGHLIGHTING, you may
  191.     need to REVERSE the definition of 'LOW VIDEO' and 'NORMAL VIDEO'
  192.     in order to get the proper effect.  When properly installed, the
  193.     main menu should have a HIGHLIGHTED boarder with the required
  194.     input character for each command HIGHLIGHTED.
  195.  
  196. Number of rows (lines) on your screen:
  197. ------------------------------------------------------------------------
  198. Enter the number of horizontal lines on your screen.
  199.  
  200. Number of columns on your screen:
  201. ------------------------------------------------------------------------
  202. Enter the number of vertical column positions on your screen.
  203.  
  204. ------------------------------------------------------------------------
  205. Delay after CURSOR ADDRESS (0-255 ms):
  206. Delay after CLEAR, DELETE, and INSERT (0-255 ms):
  207. Delay after ERASE TO END OF LINE and HIGHLIGHT On/Off (0-255 ms):
  208. ------------------------------------------------------------------------
  209. Enter  the  delay  in milliseconds required  after  the  functions spec-
  210. ified. RETURN means 0 (no delay).
  211.  
  212. Is this definition correct?
  213. ------------------------------------------------------------------------
  214. If you have made any errors in the definitions, enter N.  You will then
  215. return to the terminal selection menu.    The installation data you have
  216. just entered will be included in the installation data file and appear
  217. on the terminal selection menu, but installation will not be performed.
  218.  
  219. When you enter Y in response to this question, you are asked:
  220.  
  221. ------------------------------------------------------------------------
  222. Operating frequency of your microprocessor in MHz (for delays):
  223. ------------------------------------------------------------------------
  224. As the delaysspecified earlier are depending on the operating frequency
  225. of your CPU, you must define this value.
  226.  
  227.  
  228.  
  229. The installation is finished, installation data is written to PATCH, and
  230. you return to the outer menu.  New installation data is also saved in the
  231. installation data file and the new terminal will appear on the terminal
  232. selection list when you run PINSTALL in the future.
  233.  
  234.                     Bill Rink, San Jose, CA
  235.