read by the editor during
configuration. As delivered, this is a
configuration for an ANSI
standard/VT-lOO terminal. This
file
isnot used for IBM PC versions.
ICEDKEYB.CFG
The keyboard configuration
file.
Thisfile
is created by the KEYBOARD programand read by the editor during config-uration. As delivered, this is a config uration for an IBM PC keyboard, and uses
the PC function keys.
ICEDKEYB.MNU
This is a data
file
used by the KEYBOARDprogran to name
all
of the functionspossible in the editor.
E.2 Confiqurinq Screen Output
If
you are using Tnstant-c on an IBM PC or PC/XT orcompatible, you don't need to configure the screen output and should skip this section.
Since Instant-C uses
full
screen operations,it
isnecessary to
tell
Instant-C how to draw and performvarious functions on the screen. You can do this by
running the program we have provided, SCREEN. SCREEN is an interactive application which builds or modifies a configuration
file
containingscreen-driving character sequences. The configuration
file
(ICEDSCRN.CFG) is then read byPage 154 (: 'bL:\y::\;!)l 1"¿\.1
"y' Á¿}l'Q"'a S.
,, l, :i'c'
AL i Fll(itt T :G W-SF '?'jj-j)
"
User'sManua!hstant~C"
,N,,A,,,,,,N
Instant-C to customize the screen editor to your terminal.
Note: a configuration
file
is provided for IBM PC or compatible machines.If
you have one of thesemachines, you
will
not need to specify any screenoperations. SCREEN
will let
you override the defaultscreen attribute selections, however, should you want
to do SQ.
To run the screen configuration program, simply type:
A>sc: reen
The program prompts with a menu of choices and
screen function. The normal way to run SCREEN is to
type the number of the screen drawing functions, and
answer the prompts. You
will
need the manual foryour terminal to enter the proper sequence of characters. The 'T' tests only test what has been entered, so your strategy should be to get cursor
addressing right, then clear screen and
(if
yourterminal has
it)
clear to end of line. Then use 'T'after each change to verify your progress.
The 'B' for numeric base is for entering characters
by their value, rather than the actual keystroke.
(Some manuals use decimal, some octal, and some
hexadecimal.)
If
any of your sequences use acarriage return, you
will
need to enter a numericvalue for the CR, since SCREEN uses return as the delimiter to indicate the end of a sequence. BE SURE to use the 'T' conunand to test your configuration before writing
it
to disk. You can get somespectacular, but undesirable, effects
if
your screenconfiguration is wrong.
After running SCREEN to create your configuration
file,
you can configure the keyboard (see following section). After preparing the configurationfiles,
you
will
need to build or modify Instant-C and ED forthe changes to take effect.
{"'t:,-",
¿l;j 1'1[44
" " ' ' ' ' " ' " " page""'i"55"
fil ! :'J ," '
," j':, Rl Sí |-í',if l ')
User'sManual
Instant-C"
'INSTALLATION
E.3 Confíqurinq the Keyboard
You can reconfigure the key function interpretation of Instant-c's editor. This key reconfiguration is
designed to adapt Instant-C to different computer
keyboards and terminals. You can also use the key reconfiguration feature to make the Instant-c editor
more like some other editor with which you are more
comfortable. You can reconfigure the keys on an IBM pcF for detailsor PC/XT computerabout
all if
youof theso desire.key functions.See AppendixNote: you do not need to reconfigure the keyboard at
all
to use the Instant-c editor. This feature isprovided solely to make the keyboard interface as
useful as possible for you.
To reconfigure the keyboard, you should run the
KEYBOARD program provided on your Instant-c master
disk. The KEYBOARD program interacts with you and
creates or modifies a
file
containing the keyboardassignments. The keyboard assignment
file
is thenread by Instant-C to control which keys are bound to
which editor functions.
If
you are not using an IBM PC or compatible, youmust run SCREEN, the screen configuration program,
before running the keyboard configuration.
To run the keyboard configuration program, simply type:
A>keyboard
The program prompts with a menu of choices. You
can type 'H' and get the menu back again. The most frequently used command is 'B' for defining key to function bindings. Key bindings can be overriden just by redefining them. You can map several keys to
the same function
if
you wish. Use the 'D' (fordelete) command to eliminate a key binding completely.
Page 156 (;jf'í, T'(¿ll! 'tj'-'!
l""," l |cít'{)'),l| S',,': 1\'g, : " ',,'
"
User'sManüalInstant-C'
INSTALLATION
with Bind, you essentially teach the program what
keys or sequence of keys are to perform what editor function. When defining, the keys or sequences of
keys can be entered just as you would type them when running the editor, followed by a return. Note: some
ASCII terminals have function keys which send several characters at a time and include a carriage return.
If
this is true for your terminal, use the 'S' option to set the delimiter to some other character('l'
isa good choice).
After running KEYBOARD to create your configuration
file,
youwill
need to build or modify Tnstant-C andED. The new configuration takes effect when:
- You run an unconfigured editor (as in ICBASE).
In this case, configuration
files
must bepresent in the directory for the editor to
work.
- For Instant-C, you issue a #edconfigure
command. See sections on building and modifying Instant-c, below, for instructions on how to
make the configuration a perinanent part of your
Instant—C.
- For ED, you go through the editor configuration
process ("ed (d"). See "Configuring a New ED",
below.
E.4 Building a New Instant-C
Tnstant-C is delivered to you in both of two forms:
l.
A pre-configured forní with the standardlibrary built
into the workspace and with the editorconfigured (IC).
2. A "raw" form, with no configurations performed
(ICBASE). All components needed to reproduce the pre-configured are also provided.
,,,..,,k,j -'F-,; Page 157
\,i ' l¿j ,rl", ¢"'C"'l }¿\/j l'
User'sManual '
Instant-C"
INSTALLATION
Major changes to the standard library (particularly replacing,reducing, or eliminating
it)
are bestaccomplished by rebuilding Instant-C from scratch.
Minor changes, such as changed editor configurations, modified or added library functions, or changes to default settings of options are best handled by
"cloning" an Instant-C (described in "Modifying Your Instant-c", below).
To build a new Instant-C from scratch, you need to
have the following
files:
ICBASE .EXE for PC-DOS (and MS-DOS) or .CMD for
CP/M-86. The raw Instant-C programs.
LSl.C The(Processedsource for the library