WS2MW Installation Documentation 09/29/86 ***************************************************************** WS2MW Version 1.0 Modification Date: 09/28/86; D.L. Knudson Any standard WS file should work without special preformatting and results in file which should be transferred to the Mac and opened with MacWrite using the Paragraph Option for CR representation. 1. 5 spaces at beginning of sentence will not be replaced with a TAB. 2. Control codes converted to a code to speed searching for format codes, eg., ^S ^B = | ^S = _ ^T = \ ^V = / 3. Unsupported codes stripped from mw_target 4. A control-Z (1ah) may be written to the file at the end with other text. However, just delete as it represents extraneous text from the last sector. WS2MW converts WordStar files to MacWrite; modified from TEXTTOWS.PAS by A. Fried on 06/29/86 (ASCII to WORDSTAR CONVERSION UTILITY; Written by Andrew Fried 12/84; for the Computer Shopper; MCI 116-7368 CompuServe 75545,1116) WS2MW.PAS is released into the public domain. This program may be copied and used freely, but it may not be sold for profit or otherwise commercialized. Copyright (c) 1986, D.L. Knudson Please report any bugs to: D.L. Knudson 30 Pawson Road Branford, CT 06405 or leave a message for Dennis Knudson 1. YARU ROS - (203)785-2912 2. CompuServe PNN 76254,111 ***************************************************************** -1- WS2MW Installation Documentation 09/29/86 TERMINAL INSTALLATION Before you use WS2MW, it must be installed to your particular terminal, i.e. provided with information regarding control characters required for certain functions. This installation is easily performed using the program WMINSTAL 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 WMINSTAL at your terminal. Select Screen installation from the main menu. Depending on your version of WS2MW, the installation proceeds as described in the following two sections. A menu listing a number 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 5) Ampex D80 19) Qume 6) ANSI 20) Soroc IQ-120 7) Apple/graphics 21) Soroc new models 8) Hazeltine 1500 22) Teletext 3000 9) Hazeltine Esprit 23) Televideo 912/920/925 10) IBM PC CCP/M b/w 24) Visual 200 11) IBM PC CCP/M color 25) Wyse WY-100/200/300 12) Kaypro 10 26) Zenith 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 number, and the installation is complete. Before installation is actually performed, 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 installed as described in the following. If you do not want to modify the terminal definition, just type N, and the installation completes by asking you the operating frequency of your CPU (see last item in this document). -2- WS2MW Installation Documentation 09/29/86 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 questions one by one as they appear on the screen. In the following, each command you 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 to 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 hexadecimal 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. =. or Enter the decimal or hexadecimal values separated by spaces. Hexadecimal 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 mixed, 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 of the terminal you are about to install. When you complete WMINSTAL, the values will be stored, and the terminal name will appear on the initial list of terminals. If you later need to re-install WS2MW 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 WS2MW 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 choose between entering the command directly or defining a file name containing the command string. The latter is a good idea if the initialization string is long, as e.g. a string to program a number of function keys would be. Send a reset string to the terminal? ------------------------------------------------------------------ Here, you may define a string to be sent to the terminal when -3- WS2MW Installation Documentation 09/29/86 WS2MW terminates. The description of the initialization command above applies here. CURSOR LEAD-IN command: ------------------------------------------------------------------ Cursor Lead-in is a special sequence of characters which tells your terminal that the following characters are an address on the screen on which the cursor should be placed. When you define this command, you are asked the following supplementary questions: CURSOR POSITIONING COMMAND to send between line and column: ----------------------------------------------------------- Some terminals need a command between the two numbers defining the row and column cursor address. CURSOR POSITIONING COMMAND to send after line and column: ----------------------------------------------------------- Some terminals need a command after the two numbers defining the row and column cursor address. Column first? ----------------------------------------------------------- Most terminals require the address on the format: first ROW, then COLUMN. If this is the case on your terminal, answer N. If your 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 on binary form. If that is true for your terminal, enter Y. If your terminal 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. -4- WS2MW Installation Documentation 09/29/86 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 position. 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 position 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. ------------------------------------------------------------------ Delay after CURSOR ADDRESS (0-255 ms): Delay after CLEAR, DELETE, and INSERT (0-255 ms): Delay after ERASE TO END OF LINE and HIGHLIGHT On/Off (0-255 ms): ------------------------------------------------------------------ Enter the delay in milliseconds required after the functions specified. RETURN means 0 (no delay). Is this definition correct? ------------------------------------------------------------------ If you have made any errors in the definitions, enter N. You will then return to the terminal selection menu. The installation data you haver just entered will be included in the installation data file and appear on the terminal selection menu, but installation will not be performed. -5- WS2MW Installation Documentation 09/29/86 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 depending on the operating frequency of your CPU, you must define this value. The installation is finished, installation data is written to WS2MW, and you return to the outer menu. New installation data is also saved in the installation data file and the new terminal will appear on the terminal selection list when you run WMINSTAL in future. -6-