X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fman%2Fterminfo.5.html;h=20bb063d23f9b5137c0c8bb3c083605cef09dc1c;hb=refs%2Ftags%2Fv5.2;hp=59a79d59a0fe25bcff77a41f2a6cb022614f2725;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;p=ncurses.git
diff --git a/doc/html/man/terminfo.5.html b/doc/html/man/terminfo.5.html
index 59a79d59..20bb063d 100644
--- a/doc/html/man/terminfo.5.html
+++ b/doc/html/man/terminfo.5.html
@@ -10,7 +10,7 @@
SYNOPSIS
- @DATADIR@/terminfo/*/*
+ /usr/share/terminfo/*/*
@@ -293,12 +293,13 @@
(P*)
change_char_pitch cpi ZA Change number of
characters per inch
+ to #1
change_line_pitch lpi ZB Change number of
- lines per inch
+ lines per inch to #1
change_res_horz chr ZC Change horizontal
- resolution
+ resolution to #1
change_res_vert cvr ZD Change vertical res-
- olution
+ olution to #1
change_scroll_region csr cs change region to
line #1 to line #2
(P)
@@ -332,9 +333,9 @@
ble
cursor_left cub1 le move left one space
-
cursor_mem_address mrcup CM memory relative cur-
- sor addressing
+ sor addressing, move
+ to row #1 columns #2
cursor_normal cnorm ve make cursor appear
normal (undo
civis/cvvis)
@@ -347,13 +348,14 @@
cursor_visible cvvis vs make cursor very
visible
define_char defc ZE Define a character
+ #1, #2 dots wide,
+ descender #3
delete_character dch1 dc delete character
(P*)
delete_line dl1 dl delete line (P*)
dial_phone dial DI dial number #1
dis_status_line dsl ds disable status line
- display_clock dclk DK display clock at
- (#1,#2)
+ display_clock dclk DK display clock
down_half_line hd hd half a line down
ena_acs enacs eA enable alternate
char set
@@ -384,9 +386,9 @@
mode
enter_protected_mode prot mp turn on protected
mode
+
enter_reverse_mode rev mr turn on reverse
video mode
-
enter_secure_mode invis mk turn on blank mode
(characters invisi-
ble)
@@ -438,9 +440,8 @@
from_status_line fsl fs return from status
line
goto_window wingo WG go to window #1
- hangup hup HU hang-up phone
-
+ hangup hup HU hang-up phone
init_1string is1 i1 initialization
string
init_2string is2 is initialization
@@ -493,8 +494,8 @@
screen key
key_exit kext @9 exit key
key_f0 kf0 k0 F0 function key
- key_f1 kf1 k1 F1 function key
+ key_f1 kf1 k1 F1 function key
key_f10 kf10 k; F10 function key
key_f11 kf11 F1 F11 function key
key_f12 kf12 F2 F12 function key
@@ -547,8 +548,8 @@
key_f55 kf55 Fj F55 function key
key_f56 kf56 Fk F56 function key
key_f57 kf57 Fl F57 function key
- key_f58 kf58 Fm F58 function key
+ key_f58 kf58 Fm F58 function key
key_f59 kf59 Fn F59 function key
key_f6 kf6 k6 F6 function key
key_f60 kf60 Fo F60 function key
@@ -601,8 +602,8 @@
key_sf kind kF scroll-forward key
key_sfind kFND *0 shifted find key
key_shelp kHLP #1 shifted help key
- key_shome kHOM #2 shifted home key
+ key_shome kHOM #2 shifted home key
key_sic kIC #3 shifted insert-char-
acter key
key_sleft kLFT #4 shifted left-arrow
@@ -655,8 +656,8 @@
label_format fln Lf label format
label_off rmln LF turn off soft labels
label_on smln LO turn on soft labels
- meta_off rmm mo turn off meta mode
+ meta_off rmm mo turn off meta mode
meta_on smm mm turn on meta mode
(8th-bit on)
micro_column_address mhpa ZY Like column_address
@@ -667,8 +668,8 @@
micro mode
micro_right mcuf1 Zb Like cursor_right in
micro mode
- micro_row_address mvpa Zc Like row_address in
- micro mode
+ micro_row_address mvpa Zc Like row_address #1
+ in micro mode
micro_up mcuu1 Zd Like cursor_up in
micro mode
newline nel nw newline (behave like
@@ -707,10 +708,12 @@
in micro mode
pkey_key pfkey pk program function key
#1 to type string #2
+
+
+
pkey_local pfloc pl program function key
#1 to execute string
#2
-
pkey_xmit pfx px program function key
#1 to transmit
string #2
@@ -743,7 +746,8 @@
position (P)
scroll_forward ind sf scroll text up (P)
scroll_reverse ri sr scroll text down (P)
- select_char_set scs Zj Select character set
+ select_char_set scs Zj Select character
+ set, #1
set_attributes sgr sa define video
attributes #1-#9
(PG9)
@@ -752,22 +756,23 @@
set_bottom_margin smgb Zk Set bottom margin at
current line
set_bottom_margin_parm smgbp Zl Set bottom margin at
- line #1 or #2 lines
- from bottom
+ line #1 or (if smgtp
+ is not given) #2
+ lines from bottom
set_clock sclk SC set clock, #1 hrs #2
mins #3 secs
set_color_pair scp sp Set current color
pair to #1
+
+
set_foreground setf Sf Set foreground color
#1
set_left_margin smgl ML set left soft margin
- at current column
-
-
-
+ at current column.
+ See smgl. (ML is not
+ in BSD termcap).
set_left_margin_parm smglp Zm Set left (right)
margin at column #1
- (#2)
set_right_margin smgr MR set right soft mar-
gin at current col-
umn
@@ -779,18 +784,19 @@
current line
set_top_margin_parm smgtp Zp Set top (bottom)
margin at row #1
- (#2)
set_window wind wi current window is
lines #1-#2 cols
#3-#4
start_bit_image sbim Zq Start printing bit
image graphics
start_char_set_def scsd Zr Start character set
- definition
+ definition #1, with
+ #2 characters in the
+ set
stop_bit_image rbim Zs Stop printing bit
image graphics
stop_char_set_def rcsd Zt End definition of
- character set
+ character set #1
subscript_characters subcs Zu List of subscript-
able characters
superscript_characters supcs Zv List of superscript-
@@ -800,7 +806,8 @@
these_cause_cr docr Zw Printing any of
these characters
causes CR
- to_status_line tsl ts move to status line
+ to_status_line tsl ts move to status line,
+ column #1
tone tone TO select touch tone
dialing
underline_char uc uc underline char and
@@ -811,6 +818,7 @@
user2 u2 u2 User string #2
user3 u3 u3 User string #3
user4 u4 u4 User string #4
+
user5 u5 u5 User string #5
user6 u6 u6 User string #6
user7 u7 u7 User string #7
@@ -818,13 +826,12 @@
user9 u9 u9 User string #9
wait_tone wait WA wait for dial-tone
xoff_character xoffc XF XOFF character
-
xon_character xonc XN XON character
zero_motion zerom Zx No motion for subse-
quent character
- The following string capabilities are present in the
- SVr4.0 term structure, but were originally not documented
+ The following string capabilities are present in the
+ SVr4.0 term structure, but were originally not documented
in the man page.
Variable Cap- TCap Description
@@ -838,8 +845,9 @@
of the bit image
bit_image_repeat birep Xy Repeat bit image
cell #1 #2 times
- char_set_names csnm Zy List of character
- set names
+ char_set_names csnm Zy Produce #1'th item
+ from list of char-
+ acter set names
code_set_init csin ci Init sequence for
multiple codesets
color_names colornm Yw Give name for
@@ -851,7 +859,7 @@
guage/codeset sup-
port
display_pc_char dispc S1 Display PC charac-
- ter
+ ter #1
end_bit_image_region endbi Yy End a bit-image
region
enter_pc_charset_mode smpch S2 Enter PC character
@@ -862,17 +870,19 @@
display mode
exit_scancode_mode rmsc S5 Exit PC scancode
mode
+
+
+
get_mouse getm Gm Curses should get
- button events
+ button events,
+ parameter #1 not
+ documented.
key_mouse kmous Km Mouse event has
occurred
mouse_info minfo Mi Mouse status
information
pc_term_options pctrm S6 PC terminal
options
-
-
-
pkey_plab pfxl xl Program function
key #1 to type
string #2 and show
@@ -891,16 +901,18 @@
set3_des_seq s3ds s3 Shift to code set
3
set_a_background setab AB Set background
- color using ANSI
- escape
+ color to #1, using
+ ANSI escape
set_a_foreground setaf AF Set foreground
- color using ANSI
- escape
+ color to #1, using
+ ANSI escape
set_color_band setcolor Yz Change to ribbon
color #1
set_lr_margin smglr ML Set both left and
right margins to
- #1, #2
+ #1, #2. (ML is
+ not in BSD term-
+ cap).
set_page_length slines YZ Set page length to
#1 lines
set_tb_margin smgtb MT Sets both top and
@@ -925,8 +937,6 @@
mode
enter_right_hl_mode erhlm Xr Enter right high-
light mode
-
-
enter_top_hl_mode ethlm Xt Enter top highlight
mode
enter_vertical_hl_mode evhlm Xv Enter vertical high-
@@ -1034,64 +1044,65 @@
piled description you are working on. Only that directory
is searched.
- If TERMINFO is not set, the ncurses version of the
- terminfo reader code will instead look in the directory
+ If TERMINFO is not set, the ncurses version of the ter-
+ minfo reader code will instead look in the directory
$HOME/.terminfo for a compiled description. If it fails
to find one there, and the environment variable TER-
MINFO_DIRS is set, it will interpret the contents of that
variable as a list of colon- separated directories to be
searched (an empty entry is interpreted as a command to
- search @DATADIR@/terminfo). If no description is found in
- any of the TERMINFO_DIRS directories, the fetch fails.
+ search /usr/share/terminfo). If no description is found
+ in any of the TERMINFO_DIRS directories, the fetch fails.
- If neither TERMINFO nor TERMINFO_DIRS is set, the last
- place tried will be the system terminfo directory,
- @DATADIR@/terminfo.
+ If neither TERMINFO nor TERMINFO_DIRS is set, the last
+ place tried will be the system terminfo directory,
+ /usr/share/terminfo.
- (Neither the $HOME/.terminfo lookups nor TERMINFO_DIRS
- extensions are supported under stock System V ter-
+ (Neither the $HOME/.terminfo lookups nor TERMINFO_DIRS
+ extensions are supported under stock System V ter-
minfo/curses.)
Preparing Descriptions
- We now outline how to prepare descriptions of terminals.
- The most effective way to prepare a terminal description
- is by imitating the description of a similar terminal in
- terminfo and to build up a description gradually, using
+ We now outline how to prepare descriptions of terminals.
+ The most effective way to prepare a terminal description
+ is by imitating the description of a similar terminal in
+ terminfo and to build up a description gradually, using
partial descriptions with vi or some other screen-oriented
- program to check that they are correct. Be aware that a
+ program to check that they are correct. Be aware that a
very unusual terminal may expose deficiencies in the abil-
- ity of the terminfo file to describe it or bugs in the
+ ity of the terminfo file to describe it or bugs in the
screen-handling code of the test program.
- To get the padding for insert line right (if the terminal
+ To get the padding for insert line right (if the terminal
manufacturer did not document it) a severe test is to edit
- a large file at 9600 baud, delete 16 or so lines from the
- middle of the screen, then hit the `u' key several times
- quickly. If the terminal messes up, more padding is usu-
- ally needed. A similar test can be used for insert char-
+ a large file at 9600 baud, delete 16 or so lines from the
+ middle of the screen, then hit the `u' key several times
+ quickly. If the terminal messes up, more padding is usu-
+ ally needed. A similar test can be used for insert char-
acter.
Basic Capabilities
- The number of columns on each line for the terminal is
- given by the cols numeric capability. If the terminal is
- a CRT, then the number of lines on the screen is given by
+ The number of columns on each line for the terminal is
+ given by the cols numeric capability. If the terminal is
+ a CRT, then the number of lines on the screen is given by
the lines capability. If the terminal wraps around to the
- beginning of the next line when it reaches the right mar-
- gin, then it should have the am capability. If the termi-
- nal can clear its screen, leaving the cursor in the home
- position, then this is given by the clear string capabil-
- ity. If the terminal overstrikes (rather than clearing a
- position when a character is struck over) then it should
- have the os capability. If the terminal is a printing
- terminal, with no soft copy unit, give it both hc and os.
- (os applies to storage scope terminals, such as TEKTRONIX
- 4010 series, as well as hard copy and APL terminals.) If
- there is a code to move the cursor to the left edge of the
- current row, give this as cr. (Normally this will be car-
- riage return, control M.) If there is a code to produce
- an audible signal (bell, beep, etc) give this as bel.
+ beginning of the next line when it reaches the right
+ margin, then it should have the am capability. If the
+ terminal can clear its screen, leaving the cursor in the
+ home position, then this is given by the clear string
+ capability. If the terminal overstrikes (rather than
+ clearing a position when a character is struck over) then
+ it should have the os capability. If the terminal is a
+ printing terminal, with no soft copy unit, give it both hc
+ and os. (os applies to storage scope terminals, such as
+ TEKTRONIX 4010 series, as well as hard copy and APL termi-
+ nals.) If there is a code to move the cursor to the left
+ edge of the current row, give this as cr. (Normally this
+ will be carriage return, control M.) If there is a code
+ to produce an audible signal (bell, beep, etc) give this
+ as bel.
If there is a code to move the cursor one position to the
left (such as backspace) that capability should be given
@@ -1143,6 +1154,7 @@
33|tty33|tty|model 33 teletype,
bel=^G, cols#72, cr=^M, cud1=^J, hc, ind=^J, os,
+
while the Lear Siegler ADM-3 is described as
adm3|3|lsi adm3,
@@ -1185,6 +1197,7 @@
%+ %- %* %/ %m
arithmetic (%m is mod): push(pop() op pop())
+
%& %| %^ bit operations: push(pop() op pop())
%= %> %< logical operations: push(pop() op pop())
%A, %O logical and & or operations (for conditionals)
@@ -1508,6 +1521,7 @@
\E[0 always \E[0
;1 if p1 or p6 %?%p1%p6%|%t;1%;
;4 if p2 %?%p2%|%t;4%;
+
;5 if p4 %?%p4%|%t;5%;
;7 if p1 or p3 %?%p1%p3%|%t;7%;
;8 if p7 %?%p7%|%t;8%;
@@ -1521,6 +1535,7 @@
Remember that if you specify sgr, you must also specify
sgr0.
+
Terminals with the ``magic cookie'' glitch (xmc) deposit
special ``cookies'' when they receive mode-setting
sequences, which affect the display algorithm rather than
@@ -1631,9 +1646,9 @@
They are normally sent to the terminal, by the init option
of the tput program, each time the user logs in. They
will be printed in the following order: run the program
- iprog; output is1; is2; set the margins using mgc, smgland
- smgr; set tabs using tbc and hts; print the file if; and
- finally output is3.
+ iprog; output is1; is2; set the margins using mgc, smgl
+ and smgr; set tabs using tbc and hts; print the file if;
+ and finally output is3.
Most initialization is done with is2. Special terminal
modes can be set up without duplicating strings by putting
@@ -1684,6 +1699,7 @@
ter as a pad, then this can be given as pad. Only the
first character of the pad string is used.
+
Status Lines
Some terminals have an extra `status line' which is not
normally used by software (and thus not counted in the
@@ -1737,7 +1753,6 @@
board of squares ACS_BOARD # h
bullet ACS_BULLET o ~
checker board (stipple) ACS_CKBOARD : a
-
degree symbol ACS_DEGREE \ f
diamond ACS_DIAMOND + `
greater-than-or-equal-to ACS_GEQUAL > z
@@ -1884,10 +1899,10 @@
If the terminal can move up or down half a line, this can
be indicated with hu (half-line up) and hd (half-line
- down). This is primarily useful for superscripts and sub-
- scripts on hard-copy terminals. If a hard-copy terminal
- can eject to the next page (form feed), give this as ff
- (usually control L).
+ down). This is primarily useful for superscripts and
+ subscripts on hard-copy terminals. If a hard-copy termi-
+ nal can eject to the next page (form feed), give this as
+ ff (usually control L).
If there is a command to repeat a given character a given
number of times (to save time transmitting a large number
@@ -2103,7 +2118,6 @@
Some SVr4 curses implementations, and all previous to
SVr4, don't interpret the %A and %O operators in parameter
strings.
-
SVr4/XPG4 do not specify whether msgr licenses movement
while in an alternate-character-set mode (such modes may,
among other things, map CR and NL to characters that don't
@@ -2159,7 +2173,7 @@
FILES
- @DATADIR@/terminfo/?/* files containing terminal
+ /usr/share/terminfo/?/* files containing terminal
descriptions
@@ -2178,6 +2192,46 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+