Bulletin number:  368
Products affected: Dx205
Description: F editor keyboard mapping
Component: F editor
Date: Wed May 29 15:26:04 BST 1991
-----

DESCRIPTION:

Some Sun users have experienced difficulties getting all the functions
of the F editor to work in an Xterm window. Typically F comes up
correctly, having found the help and startup files (sunfold.stp,
sunfold.hlp), and displays the text of the first part of say, the
tutorial file, including several fold lines. They are able to use the
cursor keys to navigate through the text. The more complex navigation
commands do not work (word left, page down, open fold etc.)  The
"display help" (L2) command gives rise to the message "invalid
keystroke in this context".

With an OpenWindows window, the editor comes up correctly, but the
"display help" command (key L2) puts the editor process into an
infinite loop.

The information below can be equally well applied to customising
of ITERM for any host.

FIX:

This is basically a question of setting up ITERM to suit the users
environment. The ITERM shipped with the SUN products is intended as an
example because each user can set up his environment in a different
way. Hence providing exhaustive ITERMs is not feasible. The best way to
set about creating an appropriate ITERM for any environment is as
follows:

1. copy the standard iterm to newfld.itm
2. F newfld.itm
3. At every line which does not work correctly, delete the numeric sequence
   representing the keystroke and press [raw key display]. Type the key
   given in the first comment column in the ITERM followed by space. This
   will have replace the standard sequence with the actual sequence generated.
4. Replace the terminating "," by "." to complete the ITERM line.
5. set FTERM to point at the newly created ITERM and try again

There follows an example:
#                         SUN KEY          generated code   F usage

start:
18:27,91,50,48,48,122.    # L9             ESC [ 2 0 0 z    line up

delete numeric sequence:
18:.    # L9             ESC [ 2 0 0 z    line up

press raw key followed by desired key (L9 in this case):
18:27,91,50,52,59,49,72,.    # L9             ESC [ 2 0 0 z    line up

remove trailing comma, and correct comment:
18:27,91,50,52,59,49,72.  # L9             ESC [ 2 4 ; 1 H  line up


This will give an ITERM which maps the functions on to the standard
keys (if they are available in this window set up). The user may then
proceed to customize the ITERM to suit his/her own special needs.