|
DataMuseum.dkPresents historical artifacts from the history of: Jet Computer Jet80 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Jet Computer Jet80 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - download
Length: 16384 (0x4000)
Types: TextFile
Names: »INSTALL.DOC«
└─⟦09ad82a35⟧ Bits:30002863 PolyPascal-80 V3.10 for JET80 CP/M
└─ ⟦this⟧ »INSTALL.DOC«
└─⟦692ac107c⟧ Bits:30005923 PolyPascal-80 V3.10 arbejdsdiskette 1
└─ ⟦this⟧ »INSTALL.DOC«
└─⟦8181fe295⟧ Bits:30005924 PolyPascal-80 V3.10 arbejdsdiskette 2
└─ ⟦this⟧ »INSTALL.DOC«
PolyPascal-80 Supplementary Documentation
Installation Notes
Copyright (C) 1985
PolyData MicroCenter A/S
PolyPascal is designed in such a way that it can be installed to
match the hardware of any microcomputer system. If you have
bought an "uninstalled" copy of PolyPascal, i.e. a copy which is
not set up for any specific computer system, then before you can
use it, you must install it.
To install PolyPascal you may use the INSTALL program supplied on
the distribution disk. The INSTALL program is fully self-explai-
ning, but to answer the questions asked by it you will probably
have to consult your system documentation. If you wish, you may
also use the INSTALL program to customize an already installed
copy to suit your individual needs.
Through the INSTALL program you may view and/or modify almost all
configuration parameters. However, some features, for instance
user written machine code drivers, cannot be accessed, and usual-
ly need not be accessed. Should you wish to modify and/or install
user written machine code drivers, you must use the DDT debugger
supplied with your CP/M operating system.
The descriptions that follow specify the address and the length
of each field in the configuration table. The address is in hex
and the length is in decimal.
Many fields in the configuration table are strings. The first
byte of a string contains its length and the following bytes
contain the actual characters. When the length of a string field
is 9, the string can at most contain 8 characters.
Basic terminal data
-------------------
0120 32 Terminal name. A string of up to 31 characters defi-
ning the name of the installed terminal. A length of
zero indicates an unconfigured copy.
0140 1 Screen width. The value contained in this location
defines the width of your video display, i.e. the
number of characters per line. If a character cannot
be written to the last position on the bottom line
without scrolling the screen, then set this field to
the actual screen width less one.
0141 1 Screen height. The value contained in this location
defines the heigth of your video display, i.e. the
number of lines on the screen. The value must be
exact.
Cursor positioning data
-----------------------
If a user defined GOTOXY routine is not installed, these fields
must be filled in for PolyPascal to operate correctly.
0142 9 GOTOXY lead-in sequence. The string sent before the
coordinates in a cursor addressing sequence.
014B 5 GOTOXY separator sequence. The string sent between the
coordinates in a cursor addressing sequence. This
string is usually empty, but some standards (e.g the
ANSI standard) requires a separator.
0150 5 GOTOXY terminator sequence. The string sent after the
coordinates in a cursor addressing sequence. This
string is usually empty.
0155 1 GOTOXY coordinate order. Zero in this location indica-
tes that the Y coordinate (row) is sent before the X
coordinate (column). Non-zero means X before Y.
0156 1 GOTOXY coordinate offset. This location defines the
offset value to be added to the coordinates before
they are sent. Unbiased coordinate values start at 0.
A very common offset value is 32 (decimal).
0157 1 Coordinate format. Zero in this location indicates
that coordinates are to be sent as single characters
in binary format (i.e. the ASCII values of the charac-
ters sent correspond to the coordinate values plus an
offset as defined above). Non-zero values (2 or 3)
indicate that coordinates are to be sent as strings of
numeric characters ('0'-'9'), and the value defines
the length of such strings.
Terminal function sequences
---------------------------
The CLRHOM sequence must be installed for PolyPascal to operate
correctly. All other sequences are optional. All fields in this
section are strings.
0158 9 CLRHOM sequence. Clears the screen and places the
cursor in the upper left corner.
0161 9 CLREOS sequence. Clears all character locations from
the cursor to the end of the screen.
016A 9 CLREOL sequence. Clears all character locations from
the cursor to the end of the current line.
0173 9 INSLIN sequence. Inserts a blank line at the current
line and scrolls all lines below it down.
017C 9 DELLIN sequence. Deletes the current line and scrolls
all lines below it up. A blank line must appear at the
bottom of the screen.
0185 9 Reverse on sequence. Subsequent characters will be
printed in reverse.
018E 9 Reverse off sequence. Turns off the reverse attribute.
0197 9 Intensify on sequence. Subsequent characters will be
printed in increased (or decreased) intensity.
01A0 9 Intensify off sequence. Turns off the intensify attri-
bute.
01A9 9 Underline on sequence. Subsequent characters will be
underlined.
01B2 9 Underline off sequence. Turns off the underline attri-
bute.
01BB 9 Blink on sequence. Subsequent characters will blink.
01C4 9 Blink off sequence. Turns off the blink attribute.
01CD 9 All attributes off sequence. Turns off all character
attributes. Some standards (e.g. the ANSI standard)
does not allow for selective deactivation of character
attributes. Instead they provide a single sequence to
turn off all attributes. If this applies to your
terminal, install empty strings in the four deactiva-
tion sequences above, and install the clear attributes
sequence in this field.
GOTOXY routine
--------------
If the GOTOXY function cannot be implemented using the GOTOXY
configuration table entries, you must write your own driver in
machine code. Install the code in the patch area and store the
entry address in the vector shown below. When a non-zero address
is stored in the vector, it automatically overrides all GOTOXY
strings. (X,Y) is passed in (E,D), and the upper left corner
corresponds to (E,D)=(0,0).
01D6 2 GOTOXY driver address. Zero indicates that no driver
is installed.
Low-level I/O routines
----------------------
PolyPascal allows you to write your own low-level machine code
drivers for character device input and output. The code should be
installed in the patch area and the entry addresses in the vec-
tors shown below. If a driver is not installed, PolyPascal will
use a CP/M BIOS call instead. An uninstalled vector should be set
to 0. Output routines receive the character in C, input routines
must return the character in A, and status routines must return
A=$FF if character is ready or A=$00 if not.
01D8 2 Console status driver address. Used by the KEYPRESS
standard function. Zero causes PolyPascal to use the
CONST routine in the BIOS.
01DA 2 Console input driver address. Used by the CON:, TRM:
and KBD: devices. Zero causes PolyPascal to use the
CONIN routine in the BIOS.
01DC 2 Console output driver address. Used by the CON:, TRM:
and KBD: devices. Zero causes PolyPascal to use the
CONOUT routine in the BIOS.
01DE 2 List output driver address. Used by the LST: device.
Zero causes PolyPascal to use the LIST routine in the
BIOS.
01E0 2 Auxiliary output driver address. Used by the AUX:
device. Zero causes PolyPascal to use the PUNCH rou-
tine in the BIOS.
01E2 2 Auxiliary input driver address. Used by the AUX: de-
vice. Zero causes PolyPascal to use the READER routine
in the BIOS.
Entry and exit routines
-----------------------
The entry and exit routines may be used to initialize and de-
initialize the terminal. The code should be installed in the
patch area and the entry addresses in the vectors shown below. If
a routine is not installed, its vector should be zero.
01E4 2 PolyPascal entry routine address. If installed, this
routine is called when PolyPascal is started from the
operating system.
01E6 2 PolyPascal exit routine address. If installed, this
routine is called just before PolyPascal returns to
the operating system.
01E8 2 Editor entry routine address. If installed, this rou-
tine is called when the editor is started.
01EA 2 Editor exit routine address. If installed, this rou-
tine is called just before the editor returns to the
PolyPascal command mode.
User patch area
---------------
The user patch area is not used by PolyPascal but left open for
you to install user written drivers in it.
01EC 128 User patch area. The address of the last available
byte is $026B.
Editor configuration table
--------------------------
The address of the editor configuration table may be different
from one release of PolyPascal to another. To find the start
address, examine locations $0101 and $0102. They contain the base
address (least significant byte first) of the editor configura-
tion table. In the descriptions below, the address of each field
is an offset address from the base address of the table.
0003 2 Replace prompt delay. This entry is used only by the
find/replace function in the editor. It defines the
delay used when moving the cursor alternately between
the replace prompt and the text. Experiment to find a
suitable value (typical values range from 200 to
2000).
0005 256 Alternate editor keyboard table. See below for a des-
cription.
0105 1 Side scroll step value. This location defines the step
size used by the editor when it scrolls sidewards.
The minimum value is 1 and the maximum value is the
screen width less one.
0106 1 Backup flag. This location must contain either $00 or
$FF. If it is set to $FF, duplicate files will have
their type changed to 'BAK' when the SAVE command is
used to save a file. Otherwise such files are simply
deleted.
0107 1 INSERT mode initial value. This location defines the
initial state of the INSERT mode. $FF means on and $00
means off.
0108 1 AUTO mode initial value. This location defines the
initial state of the auto-indent tabulator. $FF means
on and $00 means off.
0109 1 TABS mode initial value. This location defines the
initial state of the TABS mode. $FF means on and $00
means off.
010A 1 Error message mode. The error message mode may be
either $00, $01 or $02. $00 means that the error
message file should never be loaded. $01 means that
the error message file should only be loaded if the
user confirms it (by answering yes to the prompt when
PolyPascal is started), and $02 means that the error
message file should always be loaded.
010B 12 Help file name. Contains the name of the PolyPascal
help file in FCB format. The first byte defines the
disk drive. 0 means the default drive, 1 means A, 2
means B, etc. The next 8 bytes define the file name,
and the last 3 bytes define the file type. Unused
positions in the name and type fields should be set to
blanks. If bit 7 is set in the drive number, PolyPas-
cal will scan user number 0 in addition to the current
user number when looking for the help file.
0117 12 Error message file name. Contains the name of the
PolyPascal error message file name in FCB format as
described above.
0123 12 Default workfile name. Contains the default workfile
name in FCB format.
012F 3 Default text file type. Three characters which define
the default type used by the LOAD, SAVE and NAME
commands. Unused positions should be set to blanks.
0132 3 Default backup file type. Three characters which de-
fine the type used by the SAVE command to create
backup files.
0135 3 Default backup file type. Three characters which de-
fine the default type used by the PROGRAM command.
0138 3 Default object file type. Three characters which de-
fine the default type used by the OBJECT command.
Alternate editor keyboard table
-------------------------------
To be able to benefit fully from the special keys offered by your
terminal's keyboard, PolyPascal allows you to define alternate
keys to invoke selected editor functions. A typical example of
alternate keys is defining your cursor arrows to do the same as
^S, ^D, ^E and ^X.
The alternate editor keyboard table consists of a list of strings
each defining an alternate character (or sequence of characters)
to invoke a specific editor function. The first byte of each
string defines the number of the function it invokes. The second
byte defines the length of the sequence and the following bytes
contain the actual characters of the sequence. The strings are
totally contiguous, i.e. immediately following the last character
of a sequence comes the next definition. The table is ended by a
zero byte. The maximum length of the table is 256 bytes. The
function numbers, in hex, are:
01 ^J 02 ^S 03 ^D 04 ^A
05 ^F 06 ^Q^S 07 ^Q^D 08 ^E
09 ^X 0A ^Q^E 0B ^Q^X 0C ^R
0D ^C 0E ^Q^R 0F ^Q^C 10 ^H
11 ^G 12 ^Q^H 13 ^Q^Y 14 ^T
15 ^Y 16 ^M 17 ^I 18 ^N
19 ^V 1A ^Z 1B ^B 1C ^W
1D ^Q^F 1E ^Q^A 1F ^L 20 ^K^B
21 ^K^K 22 ^K^Y 23 ^K^C 24 ^K^V
25 ^K^P 26 ^K^R 27 ^K^W 28 ^K^H
29 ^K^D 2A ^K^X
Below follows an example of an alternate editor key table (the
numbers are in hex):
08 02 1B 41 09 02 1B 42 00
This table defines ESC-A ($1B,$41) as an alternate for ^E (func-
tion $08) and ESC-B ($1B,$42) as an alternate for ^X (function
$09). Note that the first character of a function sequence may be
any character, but the following characters must be stored as
values between $20 and $5F or $80 and $FF. When the editor inputs
a function sequence from the keyboard, all control characters and
lower case letters following the first character of the sequence
are converted to upper case letters, i.e. characters between $00
and $1F or $60 and $7F are converted to characters between $40
and $5F. For instance, this means that ^Q^H may also be entered
as ^Q "H" or ^Q "h".
Note that it is actually possible to override the standard key
sequences. If you for instance define ^J to be an alternate key
for the ^X function, the original ^J function will become inac-
cessible unless you define an alternate sequence for it as well.
«eof»