home *** CD-ROM | disk | FTP | other *** search
- *****************************************************************
- INSTALL.DOC
- *****************************************************************
-
- ..Substitue your own program name for PROGRAMNAME and your own
- ..installation program name for INSTALLNAME in the following.
-
-
-
- TERMINAL INSTALLATION
-
- Before you use PROGRAMNAME, it must be installed to your particu-
- lat terminal, i.e. provided with information regarding control
- characters required for certain functions. This installation is
- easily perfomred using the program INSTALLNAME which is described
- in the following.
-
- After having made a work-copy, please store your distribution
- diskette safely away and work only on the copy.
-
- Now start the installation by typing INSTALLNAME at your terminal.
- Select Screen installation from the main menu. Depending on your
- version of PROGRAMNAME, the installation proceeds as described in
- the following two sections.
-
- IBM PC Display Selection
-
- If you use PROGRAMNAME without installation, the default screen
- set-up will be used. You may override this default by selecting
- another screen mode from this menu:
-
- -----------------------------------------------------------------
- Choose one of the follwoing displays:
-
- 0) Default display mode
- 1) Monochrome display
- 2) Color display 80x25
- 3) Color display 40x25
- 4) b/w display 80x25
- 5) b/w display 80x25
-
- Which display (enter no. or ^X to exit) !
- -----------------------------------------------------------------
- IBM PC Screen Installation Menu
-
- Each time PROGRAMNAME runs, the selected mode will be used, and
- you will return to the default mode on exit.
-
-
-
-
- Non-IBM Installation
-
- A menu listing a mungber of popular terminals will appear, inviting
- you to choose one by entering its number:
-
- -------------------------------------------------------------------
- Choose one of the following terminals:
-
- 1) ADDS 20/25/30 15) Lear-Siegler ADM-31
- 2) ADDS 40/60 16) Liberty
- 3) ADDS Viewpoint-1A 17) Morrow MDT-20
- 4) ADM 3A 18) Otrona Attache
- .
- .
- .
- 13) Kaypro II and 4 27) None of the above
- 14) Lear-Siegler ADM-20 28) Delete a definition
-
- Which terminal? (Enter no. or ^X to exit):
- -----------------------------------------------------------------
- Terminal Installation Menu
-
- If your terminal is mentioned, just enter the corresponding num-
- ber, and the installation is complete. Before installation is
- actually perfomred, you are asked the question:
-
- ------------------------------------------------------------------
- Do you want to modify the definition before installation?
- ------------------------------------------------------------------
-
- This allows you to modify one or more of the values being instal-
- led as described in the following. If you do not want to modify
- the terminal definition, just type N, and the installation com-
- pletes by asking you the operating frequency of your CPU (see last
- item in this appendix).
-
- If your terminal is not on the menu, however, you must define the
- required values yourself. The values can most probably be found in
- the manual supplied with your terminal.
-
- Enter the number corresponding to None of the above and answer the
- quesitona one by one as they appear on the screen.
-
- In the following, each command yuou may install is described in
- detail. Your terminal may not support all the commands that can be
- installed. If so, just pass the command not needed by typing
- RETURN in response ti the prompt. If Delete line, Insert line, or
- Erase to end of line is not installed, these functions will be
- emulated in software, slowing screen performance somewhat.
-
-
- Commands may be entered either simply by pressing the appropriate
- keys or by entering the decimal or hexidecimal ASCII value of the
- command. If a command requires the two characters 'ESCAPE' and
- '=', may:
-
- either Press first the ESC key, then the =. The entry will be
- echoed with appropriate labels, i.e. <ESC> =.
- or Enter the decimal or hexidecimal values separated by
- spaces. Hexidecimal values must be preceded by a dollar-
- sign. Enter e.g. 27 61 or $1B 61 or $1B $3D which are
- all equivalent.
-
- The two methods cannot be mixwed, i.e. once you have entered a non-
- numeric character, the rest of that command must be defined in
- that mode, and vise versa.
-
- A hyphen entered as the very first character is used to delete a
- command, and echoes the text "Nothing".
-
- Terminal type:
- ------------------------------------------------------------------
- Enter the name fo the termanal you are about to install. When you
- complete INSTALLNAME, the values will be stored, and the terminal
- name will appear on the initial list of termianls. If you later
- need to re-install PROGRAMNAME to this terminal, you can do that
- by choosing it from the list.
-
- Send an initialization string to the terminal?
- ------------------------------------------------------------------
- If you want to initialize your terminal when PROGRAMNAME starts
- (e.g. to download commands to programmable function keys), you
- answer Y for yes to this question. If not, just hit RETURN.
-
- If you answer Y, you may enter up to 13 characters for this string
-
- Send a reset string to the terminal?
- ------------------------------------------------------------------
- Here, you may define a string to be sent to the terminal when
- PROGRAMNAME terminates. The description of the intiialization com-
- mand above applies here.
-
- CURSOR LEAD-IN command:
- ------------------------------------------------------------------
- Cursor Lead-In is a special sequence of characters which tells
- your terminal that the follwoing characters are an address on the
- screen on which the cursor should be placed.
-
- When you define this command, you are asked the follwing supple-
- mentary questions:
-
-
-
- CURSOR POSITIONING COMMAND to send between line and column:
- ------------------------------------------------------------
- Some terminals need a command between the two numbers defi-
- ning the row- and column cursor address.
-
- CURSOR POSITIONING COMMAND to send after line and column:
- ------------------------------------------------------------
- Some terminals need a command after the two numbers defi-
- ning the row- and column cursor address.
-
- Column first?
- ------------------------------------------------------------
- Most terminal require the address on the format: first
- ROW, then COLUMN. If this is the case on your terminal,
- answer N. If you terminal wants COLUMN first, then ROW,
- then answer Y.
-
- OFFSET to add to LINE:
- ------------------------------------------------------------
- Enter the number to add to the LINE (ROW) address.
-
- OFFSET to add to COLUMN
- ------------------------------------------------------------
- Enter the number to add to the COLUMN address.
-
- Binary address?
- ------------------------------------------------------------
- Most terminals need the cursor address sent in binary form.
- If that is true for your terminal, enter Y. If your termi-
- nal expects the cursor address as ASCII digits, enter N. If
- so, you are asked the supplementary question:
-
- 2 or 3 ASCII digits?
- -------------------------------------------------------
- Enter the number of digits in the cursor address for
- your terminal.
-
- CLEAR SCREEN command:
- ------------------------------------------------------------------
- Enter the command that will clear the entire contents of your
- screen, both foreground and background, if applicable.
-
- Does CLEAR SCREEN also HOME cursor?
- ------------------------------------------------------------------
- This is normally the case; if it is not so on your terminal, enter
- N, and define the cursor HOME command.
-
- DELETE LINE command:
- ------------------------------------------------------------------
- Enter the command that deletes the entire line at the cursor posi-
- tion.
-
- INSERT LINE command:
- ------------------------------------------------------------------
- Enter the command that inserts a line at the cursor position.
-
- ERASE TO END OF LINE command:
- ------------------------------------------------------------------
- Enter the command that erases the line at the cursor position from
- the cursor poisiton through the right end of the line.
-
- START OF 'LOW VIDEO' command:
- ------------------------------------------------------------------
- If your terminal supports different video intensities, then define
- the command that initiates the dim video here. If this command is
- defined, the following question is asked:
-
- START OF 'NORMAL VIDEO' command:
- -----------------------------------------------------------
- Define the command that sets the screen to show characters
- in 'normal' video.
-
- Number of rows (lines) on your screen:
- ------------------------------------------------------------------
- Enter the number of horizontal lines on your screen.
-
- Number of columns on your screen:
- ------------------------------------------------------------------
- Enter the number of vertical column positions on your screen.
-
- ------------------------------------------------------------------
- If you don't know the numbers of vertical columns, enter N. You will
- then return to the terminal selection menu. The installation data
- you have just entered will be included in the installation data
- file and appear on the terminal selection menu, but installation
- will not be performed.
-
- When you enter Y in response to this question, you are asked:
-
- ------------------------------------------------------------------
- Operating frequency of your microprocessor in MHz (for delays):
- ------------------------------------------------------------------
- As the delays specified earlier are depencing on the operating
- frequency of your CPU, you must define this value.
-
- The installation is finished, installation data is written to
- PROGRAMNAME, and you return to the outer menu. New installation
- data is also saved in the inmstallation data file and the new
- terminal will appear on the terminal selection list when you run
- INSTALLNAME in future.
-