home *** CD-ROM | disk | FTP | other *** search
/ Turbo Toolbox / Turbo_Toolbox.iso / turbo3 / install.doc < prev    next >
Text File  |  1994-03-30  |  11KB  |  255 lines
  1. *****************************************************************
  2.                INSTALL.DOC
  3. *****************************************************************
  4.  
  5. ..Substitue your own program name for  PROGRAMNAME and  your  own
  6. ..installation program name for INSTALLNAME in the following.
  7.  
  8.  
  9.  
  10. TERMINAL INSTALLATION
  11.  
  12. Before you use PROGRAMNAME, it must be installed to your particu-
  13. lat terminal,  i.e.  provided with information regarding  control
  14. characters required for certain functions.  This installation  is
  15. easily perfomred using the program INSTALLNAME which is described
  16. in the following.
  17.  
  18. After  having  made a work-copy,  please store  your distribution
  19. diskette safely away and work only on the copy.
  20.  
  21. Now start the installation by typing INSTALLNAME at your terminal.
  22. Select Screen installation from the main menu.  Depending on your
  23. version of PROGRAMNAME,  the installation proceeds as described in
  24. the following two sections.
  25.  
  26. IBM PC Display Selection
  27.  
  28. If you use PROGRAMNAME without installation,  the default  screen
  29. set-up  will be used.  You may override this default by selecting
  30. another screen mode from this menu:
  31.  
  32. -----------------------------------------------------------------
  33.    Choose one of the follwoing displays:
  34.  
  35.       0) Default display mode
  36.       1) Monochrome display
  37.       2) Color display 80x25
  38.       3) Color display 40x25
  39.       4) b/w   display 80x25
  40.       5) b/w   display 80x25
  41.    
  42.    Which display (enter no. or ^X to exit)  !
  43. -----------------------------------------------------------------
  44.          IBM PC Screen Installation Menu
  45.  
  46. Each  time PROGRAMNAME runs,  the selected mode will be used, and
  47. you will return to the default mode on exit.
  48.  
  49.  
  50.  
  51.  
  52. Non-IBM Installation
  53.  
  54. A menu listing a mungber of popular terminals will appear, inviting
  55. you to choose one by entering its number:
  56.  
  57. -------------------------------------------------------------------
  58.    Choose one of the following terminals:
  59.  
  60.      1) ADDS 20/25/30          15) Lear-Siegler ADM-31
  61.      2) ADDS 40/60             16) Liberty
  62.      3) ADDS Viewpoint-1A      17) Morrow MDT-20
  63.      4) ADM 3A                 18) Otrona Attache
  64.              .
  65.              .
  66.              .
  67.     13) Kaypro II and 4        27) None of the above
  68.     14) Lear-Siegler ADM-20    28) Delete a definition
  69.  
  70.    Which terminal? (Enter no. or ^X to exit):
  71. -----------------------------------------------------------------
  72.            Terminal Installation Menu
  73.  
  74. If your terminal is mentioned,  just enter the corresponding  num-
  75. ber,  and  the  installation is complete.  Before installation  is
  76. actually perfomred, you are asked the question:
  77.  
  78. ------------------------------------------------------------------
  79.    Do you want to modify the definition before installation?
  80. ------------------------------------------------------------------
  81.  
  82. This allows you to modify one or more of the values being  instal-
  83. led  as described in the following.  If you do not want to  modify
  84. the terminal definition,  just type N,  and the installation  com-
  85. pletes by asking you the operating frequency of your CPU (see last
  86. item in this appendix).
  87.  
  88. If your terminal is not on the menu,  however, you must define the
  89. required values yourself.  The values can most probably be found in
  90. the manual supplied with your terminal.
  91.  
  92. Enter the number corresponding to None of the above and answer the
  93. quesitona one by one as they appear on the screen.
  94.  
  95. In the following,  each command yuou may install is  described  in
  96. detail.  Your terminal may not support all the commands that can be
  97. installed.  If so, just  pass  the  command  not  needed  by typing 
  98. RETURN in response ti the prompt.  If Delete line, Insert line,  or
  99. Erase to end of  line  is  not  installed, these  functions will be
  100. emulated in software, slowing screen performance somewhat.
  101.  
  102.  
  103. Commands may be entered either simply by pressing the   appropriate
  104. keys or  by entering the decimal or hexidecimal ASCII value of  the
  105. command.  If a command  requires  the  two characters  'ESCAPE' and
  106. '=', may:
  107.  
  108. either Press  first  the ESC key,  then the =.  The entry  will  be
  109.        echoed with  appropriate labels, i.e.  <ESC> =.
  110. or     Enter  the  decimal  or  hexidecimal  values  separated   by
  111.        spaces.  Hexidecimal  values must be preceded by  a  dollar-
  112.        sign.  Enter e.g. 27 61  or $1B 61  or  $1B $3D  which  are
  113.        all equivalent.
  114.  
  115. The two methods cannot be mixwed, i.e. once you have entered a non-
  116. numeric  character,  the rest of that command must be  defined  in
  117. that mode,  and vise versa.
  118.  
  119. A  hyphen entered as the very first character is used to delete  a
  120. command,  and echoes the text "Nothing".
  121.  
  122. Terminal type:
  123. ------------------------------------------------------------------
  124. Enter the name fo the termanal you are about to install.  When you
  125. complete INSTALLNAME,  the values will be stored, and the terminal
  126. name will appear on the initial list of termianls.  If  you  later
  127. need  to re-install PROGRAMNAME to this terminal,  you can do that
  128. by choosing it from the list.
  129.  
  130. Send an initialization string to the terminal?
  131. ------------------------------------------------------------------
  132. If you want to initialize  your terminal when  PROGRAMNAME  starts
  133. (e.g.  to download commands  to programmable function  keys),  you
  134. answer Y for yes to this question.  If not, just hit RETURN.
  135.  
  136. If you answer Y, you may enter up to 13 characters for this string
  137.  
  138. Send a reset string to the terminal?
  139. ------------------------------------------------------------------
  140. Here,  you  may  define a string to be sent to the  terminal  when
  141. PROGRAMNAME terminates. The description of the intiialization com-
  142. mand above applies here.
  143.  
  144. CURSOR LEAD-IN command:
  145. ------------------------------------------------------------------
  146. Cursor  Lead-In  is a special sequence of characters  which  tells
  147. your  terminal that the follwoing characters are an address on the
  148. screen on which the cursor should be placed.
  149.  
  150. When you define this command,  you are asked the follwing  supple-
  151. mentary questions:
  152.  
  153.  
  154.  
  155.      CURSOR POSITIONING COMMAND to send between  line and column: 
  156.      ------------------------------------------------------------
  157.      Some terminals need a command between the two numbers  defi-
  158.      ning the row- and column cursor address.
  159.  
  160.      CURSOR POSITIONING COMMAND to send after line and column:
  161.      ------------------------------------------------------------
  162.      Some  terminals need a  command  after the two numbers defi-
  163.      ning the row- and column cursor address.
  164.  
  165.      Column first?
  166.      ------------------------------------------------------------
  167.      Most  terminal require  the  address on  the  format:  first
  168.      ROW,  then  COLUMN.  If this is the  case on your  terminal,
  169.      answer  N.  If you terminal  wants  COLUMN first,  then ROW,
  170.      then answer Y.
  171.  
  172.      OFFSET to add to LINE:
  173.      ------------------------------------------------------------
  174.      Enter the number to add to the LINE (ROW) address.
  175.  
  176.      OFFSET to add to COLUMN
  177.      ------------------------------------------------------------
  178.      Enter the number to add to the COLUMN address.
  179.  
  180.      Binary address?
  181.      ------------------------------------------------------------
  182.      Most terminals need the cursor  address sent in binary form.
  183.      If that is true for your terminal, enter  Y.  If your termi-
  184.      nal expects the cursor address as  ASCII digits, enter N. If
  185.      so, you are asked the supplementary question:
  186.  
  187.       2 or 3 ASCII digits?
  188.       -------------------------------------------------------
  189.       Enter  the  number of digits in the cursor  address for
  190.       your terminal.
  191.  
  192. CLEAR SCREEN command:
  193. ------------------------------------------------------------------
  194. Enter  the  command that will clear the entire  contents  of  your
  195. screen, both foreground and background, if applicable.
  196.  
  197. Does CLEAR SCREEN also HOME cursor?
  198. ------------------------------------------------------------------
  199. This is normally the case; if it is not so on your terminal, enter
  200. N, and define the cursor HOME command.
  201.  
  202. DELETE LINE command:
  203. ------------------------------------------------------------------
  204. Enter the command that deletes the entire line at the cursor posi-
  205. tion.
  206.  
  207. INSERT LINE command:
  208. ------------------------------------------------------------------
  209. Enter the command that inserts a line at the cursor position.
  210.  
  211. ERASE TO END OF LINE command:
  212. ------------------------------------------------------------------
  213. Enter the command that erases the line at the cursor position from
  214. the cursor poisiton through the right end of the line.
  215.  
  216. START OF 'LOW VIDEO' command:
  217. ------------------------------------------------------------------
  218. If your terminal supports different video intensities, then define
  219. the command that initiates the dim video here.  If this command is
  220. defined, the following question is asked:
  221.  
  222.        START OF 'NORMAL VIDEO' command:
  223.        -----------------------------------------------------------
  224.        Define  the command that sets the screen to show characters
  225.        in 'normal' video.
  226.  
  227. Number of rows (lines) on your screen:
  228. ------------------------------------------------------------------
  229. Enter the number of horizontal lines on your screen.
  230.  
  231. Number of columns on your screen:
  232. ------------------------------------------------------------------
  233. Enter the number of vertical column positions on your screen.
  234.  
  235. ------------------------------------------------------------------
  236. If you don't know the numbers of vertical columns, enter N. You will
  237. then return to the terminal selection menu.  The installation data
  238. you have  just entered will be included in  the installation  data
  239. file and appear on the terminal selection menu,  but  installation
  240. will not be performed.
  241.  
  242. When you enter Y in response to this question, you are asked:
  243.  
  244. ------------------------------------------------------------------
  245. Operating frequency of your microprocessor in MHz (for delays):
  246. ------------------------------------------------------------------
  247. As  the  delays specified earlier are depencing on  the  operating
  248. frequency of your CPU, you must define this value.
  249.  
  250. The  installation  is finished,  installation data is  written  to
  251. PROGRAMNAME, and you return to  the outer menu.  New  installation
  252. data  is  also  saved in the inmstallation data file  and  the new
  253. terminal  will  appear on the terminal selection list when you run
  254. INSTALLNAME in future.
  255.