HP 3000 Manuals HP 3000 Manuals
Creating Device Descriptions (contd)
Configuration Capabilities
Table 3-11 lists the capabilities used to configure terminals.
Following the table are more detailed descriptions of some of these
capabilities.
Table 3-11. Configuration Capabilities
----------------------------------------------------------------------------------------------
| | | |
| Capability | Variable | Description |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| acscU= | acs_chars | Graphics character set pairs |
| | | aAbBcC-defn=vt100 |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| am | auto_right_margin | Wraps to next line at right |
| | | margin |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| bel= | bell | Produce audible signal (bell |
| | | or beep) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| bufsz# | buffer_capacity | Number of bytes buffered |
| | | before printing |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| bw | auto_left_margin | cub1 wraps from column 0 to |
| | | last column |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| ccc | can_change | Terminal can redefine |
| | | existing color |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| chts | hard_cursor | Cursor is hard to see |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cmdch= | command_character | Terminal settable command |
| | | character in prototype |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cols# | columns | Number of columns on each |
| | | line |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cr= | carriage_return | Move cursor to left edge of |
| | | screen |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| da | memory_above | Display may be retained |
| | | above the screen |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| db | memory_below | Display may be retained |
| | | below the screen |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| eo | erase_overstrike | Terminal can erase |
| | | overstrikes with a blank |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| eslok | status_line_esc_ok | Escape can be used on the |
| | | status line |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| gn | generic_type | Generic line type (for |
| | | example, dialup, switch) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| hc | hard_copy | Hardcopy terminal |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| hs | has_status_line | Terminal has extra status |
| | | line |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| hz | tilde_glitch | Hazeltine: cannot print |
| | | tilde (~) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| if= | init_file | Name of file containing is |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| iprog= | init_prog | Path name of program for |
| | | initialization |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| is1= | init_1string | Terminal initialization |
| | | string |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| is2= | init_2string | Terminal initialization |
| | | string |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| is3= | init_3string | Terminal initialization |
| | | string |
| | | |
----------------------------------------------------------------------------------------------
Table 3-11. Configuration Capabilities (cont.)
----------------------------------------------------------------------------------------------
| | | |
| Capability | Variable | Description |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| lines# | lines | Number of lines on the |
| | | screen |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| lm# | lines_of_memory | Lines of memory if > 0; 0 |
| | | means unfixed |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| nxon | needs_xon_xoff | Padding will not work, |
| | | XON/XOFF required |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| pad= | pad_char | Pad character (rather than |
| | | null) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| pb# | padding_baud_rate | Lowest baud rate where cr/nl |
| | | padding needed |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| os | over_strike | Overstrike leaves both |
| | | characters on screen |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rf= | reset_file | Name of file containing |
| | | reset string |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rs1= | reset_1string | Reset terminal completely to |
| | | sane modes |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rs2= | reset_2string | Reset terminal completely to |
| | | sane modes |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rs3= | reset_3string | Reset terminal completely to |
| | | sane modes |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rmam= | exit_am_mode | Turn off automatic margins |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rmxon= | exit_xon_mode | Turn off XON/XOFF |
| | | handshaking |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| sam | semi_auto_right_margin | Printing in last column |
| | | causes cr |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| smam= | enter_am_mode | Turn on automatic margins |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| smxon= | enter_xon_mode | Turn on XON/XOFF handshaking |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| ul | transparent_underline | Underline character |
| | | overstrikes |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| vt# | virtual_terminal | Virtual terminal # (CB/UNIX) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xenl | eat_newline_glitch | Newline ignored after 80 |
| | | columns (Concept) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xoffc= | xoff_character | XOFF character |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xon | xon_xoff | Terminal uses XON/XOFF |
| | | handshaking |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xonc= | xon_character | XON character |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xsb | no_esc_ctlc | Beehive (f1=escape, f2=ctrl |
| | | C) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xt | dest_tabs_magic_smso | Tabs destructive, magic smso |
| | | character |
| | | |
----------------------------------------------------------------------------------------------
Detailed Descriptions.
More detailed descriptions are provided below for the following
capabilities:
* cmdch
* da, db
* gn
* if, iprog, is1, is2, is3
* lm
* xenl
* os, hc
* ascs
cmdch.
Some terminals, such as the Tektronix 4025, have a control character that
can be set. The cmdch string describes a "dummy" control character to be
used in all capabilities. Some UNIX systems support the convention of
using the value of the environment variable CC in place of the dummy
control character.
da.
The da capability describes the case where deleting a line or scrolling a
full screen may bring non-blank lines from below the screen; the db
capability describes the case where scrolling back with ri may bring down
non-blank lines from above.
gn.
Terminal descriptions that are not specific types of terminals (such as
switch, dialup, patch, and network) can be described at a basic level
with gn. This allows the terminal to function at a low level but still
complain when some operations are impossible. This capability is not
used for virtual terminal descriptions supported by the UNIX system
virtual terminal protocol. (Use vt.)
if, iprog, is1, is2, is3.
The if, iprog, is1, is2, and is3 strings must be sent to the device every
time that the user logs in. They must be output in a certain order: run
the program specified by iprog; output is1; output is2; set the margins
with mgc, smgl, and smgr; set the tabs with tbc and hts; print the file
specified by if; and output is3 (using the init option of the tput
command).
Normally initialization is done with is2 and in special cases, is1 and
is3; however, sequences that reset from an unknown state can be given as
rs1, rs2, rf, and rs3. (Reset strings are normally output with the reset
option of the tput command.) Commands are normally placed in these
strings when they have annoying results or are not needed when logging
in.
lm.
The lm capability is used if the terminal has more lines of memory than
can be displayed on the screen simultaneously; a value of zero means that
the number of lines is not fixed but that number is still more than can
fit on the screen.
xenl.
In addition to terminals that ignore a linefeed, xenl should be specified
for terminals that do not immediately wrap when a character is read to
the right-most column of the screen but wait until another character has
been received (the VT100, for example).
os, hc.
If the device is a printing terminal with no soft copy unit, both os and
hc should be specified.
ascs.
The definition of the ascs string is based on the DEC VT100 character set
with the addition of some characters from the AT&T 4410v1 terminal.
Table 3-12 illustrates the glyph to character mapping.
Table 3-12. Glyph to Character Mapping
---------------------------------------------------------------------------------------------
| | |
| Glyph Name | Character |
| | |
---------------------------------------------------------------------------------------------
| | |
| right arrow | + |
| | |
---------------------------------------------------------------------------------------------
| | |
| left arrow | ' |
| | |
---------------------------------------------------------------------------------------------
| | |
| down arrow | . |
| | |
---------------------------------------------------------------------------------------------
| | |
| up arrow | - |
| | |
---------------------------------------------------------------------------------------------
| | |
| solid square block | O |
| | |
---------------------------------------------------------------------------------------------
| | |
| lantern symbol | I |
| | |
---------------------------------------------------------------------------------------------
| | |
| diamond | ` |
| | |
---------------------------------------------------------------------------------------------
Table 3-12. Glyph to Character Mapping (cont.)
---------------------------------------------------------------------------------------------
| | |
| Glyph Name | Character |
| | |
---------------------------------------------------------------------------------------------
| | |
| checker board (stipple) | a |
| | |
---------------------------------------------------------------------------------------------
| | |
| degree symbol | f |
| | |
---------------------------------------------------------------------------------------------
| | |
| plus/minus | g |
| | |
---------------------------------------------------------------------------------------------
| | |
| board of squares | h |
| | |
---------------------------------------------------------------------------------------------
| | |
| lower right corner | j |
| | |
---------------------------------------------------------------------------------------------
| | |
| upper right corner | k |
| | |
---------------------------------------------------------------------------------------------
| | |
| upper left corner | l |
| | |
---------------------------------------------------------------------------------------------
| | |
| lower left corner | m |
| | |
---------------------------------------------------------------------------------------------
| | |
| plus | n |
| | |
---------------------------------------------------------------------------------------------
| | |
| scan line 1 | o |
| | |
---------------------------------------------------------------------------------------------
| | |
| horizontal line | q |
| | |
---------------------------------------------------------------------------------------------
| | |
| scan line 9 | s |
| | |
---------------------------------------------------------------------------------------------
Table 3-12. Glyph to Character Mapping (cont.)
---------------------------------------------------------------------------------------------
| | |
| Glyph Name | Character |
| | |
---------------------------------------------------------------------------------------------
| | |
| left tee (|-) | t |
| | |
---------------------------------------------------------------------------------------------
| | |
| right tee (-|) | u |
| | |
---------------------------------------------------------------------------------------------
| | |
| bottom tee () | v |
| | |
---------------------------------------------------------------------------------------------
| | |
| top tee (T) | w |
| | |
---------------------------------------------------------------------------------------------
| | |
| vertical line | x |
| | |
---------------------------------------------------------------------------------------------
| | |
| bullet | ~ |
| | |
---------------------------------------------------------------------------------------------
The characters are described in pairs, with the defining character for
the glyph followed by the corresponding character on the device. For
example, a device with the left tee, right tee, bottom tee, and top tee
defined by the f,g, h, and i characters would be described as follows:
acsc=tfugvhwi
Cursor Movement and Scrolling Capabilities
Table 3-13 lists the capabilities used to define cursor movements.
Following the table are more detailed descriptions of some of these
capabilities.
Table 3-13. Cursor Movement Capabilities
----------------------------------------------------------------------------------------------
| | | |
| Capability | Variable | Description |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| csr= | change_scroll_region | Change to lines #1 through |
| | | #2 (vt100) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cub= | parm_left_cursor | Move cursor left specified |
| | | number of spaces |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cub1= | cursor_left | Move cursor left one space |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cud= | parm_down_cursor | Move down specified number |
| | | of lines |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cud1= | cursor_down | Move cursor down one line |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cuf= | parm_right_cursor | Move cursor right specified |
| | | number of spaces |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cuf1= | cursor_right | Non-destructive space |
| | | (cursor right) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cup= | cursor_address | Move cursor to row #1 col #2 |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cuu= | parm_up_cursor | Move up specified number of |
| | | lines |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| cuu1= | cursor_up | Move cursor up one line |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| home= | cursor_home | Move cursor to upper left |
| | | corner of screen (if no cup) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| hpa= | column_address | Absolute horizontal position |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| ind= | scroll_forward | Scroll text up |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| indn= | parm_index | Scroll forward #1 lines |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| ll= | cursor_to_ll | Moves cursor to last line, |
| | | first column (if no cup) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| mir | move_insert_mode | Safe to move in insert mode |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| mrcup= | cursor_mem_address | Memory relative cursor |
| | | addressing |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| msgr | move_standout_mode | Safe to move in standout |
| | | mode |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| nel= | newline | Produces newline (behaves |
| | | like cr followed by lf) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| nrrmc= | non_rev_rmcup | smcup does not restore |
| | | screen after rmcup |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rc= | restore_cursor | Restores cursor to position |
| | | of last sc |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| ri= | scroll_reverse | Scrolls text down |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rin= | parm_rindex | Scrolls backward #1 lines |
| | | |
----------------------------------------------------------------------------------------------
Table 3-13. Cursor Movement Capabilities (cont.)
----------------------------------------------------------------------------------------------
| | | |
| Capability | Variable | Description |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| rmcup= | exit_ca_mode | String that ends programs |
| | | that use cup |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| sc= | save_cursor | Save cursor position |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| smcup= | enter_ca_mode | String that begins programs |
| | | that use cup |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| vpa= | row_address | Absolute vertical position |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xhpa | col_addr_glitch | Only positive motion for |
| | | hpa/mhpa capabilties |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xt | dest_tabs_magic_smso | Tabs destructive, magic smso |
| | | character (Teleray 1061) |
| | | |
----------------------------------------------------------------------------------------------
| | | |
| xvpa | row_addr_glitch | Only positive motion for |
| | | vpa/mvpa capabilities |
| | | |
----------------------------------------------------------------------------------------------
Detailed Descriptions.
More detailed descriptions are provided below for the following
capabilities:
* ind, ri
* cufl
* csr
* cup, cuu
* home
* mir
* smcup, rmcup
* xt
ind, ri.
Local cursor movements defined for TERMINFO are undefined at the top and
left edges of the screen. Unless bw is specified, programs should not
try to backspace at the left edge of the screen. To scroll text down,
the program should move the cursor to the bottom left corner of the
screen and send ind. To scroll up, the program should move the cursor to
the top of the screen and send ri. Both of these capabilities are
undefined when the cursor is anywhere else on the screen.
Although moving backwards from the left edge of the screen is not
possible unless bw is specified, moving forward at the right edge of the
screen does not necessarily depend on whether or not am is set. If the
device has switch selectable automatic margins, am should be specified in
the TERMINFO file, and initialization strings should turn on this option.
cufl.
The local cursor movements should not change the text that they pass
over; for example, you would not use cufl=\s because the space would
erase the character that it passed over.
csr.
The cursor position is undefined after using csr. Do not specify csr on
terminals that do not have destructive scroll regions unless all of the
following simulate destructive scrolling: ind, ri, indn, rin, dl, and
dl1. To find out whether or not the terminal has a destructive scroll
region, create a scroll region and place data on the bottom line, move
the cursor to the top and do a reverse index (ri), followed by a delete
line (dl1) or index (ind). The terminal has destructive scroll regions
if the bottom line drops off the bottom of the scrolling region.
The csr string can create the effect of insert and delete line.
cup, cuu.
If the device does not have cup, (Tektronix 4025, for example), cud, cub,
cuf, and cuu are useful for moving relative to present position.
Sometimes absolute-cursor addressing in one dimension (using vpa and hpa)
is faster than the two-parameter specification of cup (as with the
Hewlett-Packard 2645).
home.
Since home refers to the top left corner of the screen (0,0) and not to
memory, the sequence \EH on Hewlett-Packard terminals could not be used
without losing other features of the terminal. A program should not get
to the lower left hand corner by going up with cuu1 itself from the home
position because the effects of home cannot be predicted.
ri, ind.
The ri and ind strings can be used to insert lines at the top or bottom
of the screen on terminals that have no true insert/delete line (and may
even be faster).
mir.
A terminal that allows movement within insert mode to delete characters
on the same line can specify mir to speed up the insertion process. Some
terminals, such as Datamedia's, should not specify mir because of the way
that their insert mode works.
smcup, rmcup.
Some devices may need to be in a special mode to use cursor movement.
Some terminals turn off cursor movement when not in use; other terminals,
such as the Concept terminal, have cursor addressing relative to memory
instead of the screen; so a single screen-sized window must be fixed into
the device for cursor addressing to work properly. Terminals, such as
the Tektronix 4025, that have programmable command characters need to set
the command character to the one used in TERMINFO. The smcup and rmcup
strings start and end programs that use cursor movement.
xt.
The xt capability is used for Teleray terminals that have destructive
tabs (turn all characters tabbed over to blanks) and have an odd standout
mode that requires using insert and delete to change text from standout
back to normal instead of typing over the text.