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