X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fman%2Fterm.5.html;fp=doc%2Fhtml%2Fman%2Fterm.5.html;h=144bd20f87efc225d0cf183260ff993c4fce545d;hb=084e3b44fc1c904d5ab941da55f47a237cb15766;hp=2cd0f44d9687cd08c1f577a6c39cab9a34c831b0;hpb=89d66edde5b9525fff1f4343470231344d1ff2c6;p=ncurses.git diff --git a/doc/html/man/term.5.html b/doc/html/man/term.5.html index 2cd0f44d..144bd20f 100644 --- a/doc/html/man/term.5.html +++ b/doc/html/man/term.5.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: term.5,v 1.62 2023/10/21 15:33:10 tom Exp @ + * @Id: term.5,v 1.65 2023/11/25 22:58:12 tom Exp @ -->
-term(5) File formats term(5) @@ -63,7 +63,7 @@ the ncurses libraries): directory tree - A two-level scheme is used to avoid a linear search of a huge UNIX + A two-level scheme is used to avoid a linear search of a huge Unix system directory: /usr/share/terminfo/c/name where name is the name of the terminal, and c is the first character of name. Thus, act4 can be found in the file /usr/share/terminfo/a/act4. @@ -189,7 +189,7 @@
The previous section describes the conventional terminfo binary format. With some minor variations of the offsets (see PORTABILITY), the same - binary format is used in all modern UNIX systems. Each system uses a + binary format is used in all modern Unix systems. Each system uses a predefined set of boolean, number or string capabilities. The ncurses libraries and applications support extended terminfo binary @@ -223,6 +223,12 @@ extended capabilities in order, e.g., booleans, then numbers and finally strings. + By storing terminal descriptions in this way, ncurses is able to + provide a database useful with legacy applications, as well as + providing data for applications which need more than the predefined + capabilities. See user_caps(5) for an overview of the way ncurses uses + this extended information. + Applications which manipulate terminal data can use the definitions described in term_variables(3x) which associate the long capability names with members of a TERMTYPE structure. @@ -245,6 +251,11 @@ TERMTYPE2 to provide data for the terminfo functions. +
+ /usr/share/terminfo + compiled terminal description database + +
@@ -261,12 +272,12 @@
X/Open Curses does not specify a format for the terminfo database. - UNIX System V curses used a directory-tree of binary files, one per - terminal description. + System V curses used a directory-tree of binary files, one per terminal + description. Despite the consistent use of little-endian for numbers and the otherwise self-describing format, it is not wise to count on - portability of binary terminfo entries between commercial UNIX + portability of binary terminfo entries between commercial Unix versions. The problem is that there are at least three versions of terminfo (under HP-UX, AIX, and OSF/1) which diverged from System V terminfo after SVr1, and have added extension capabilities to the @@ -306,8 +317,39 @@ directory tree in (two-character) hexadecimal form. -
- As an example, here is a description for the Lear-Siegler ADM-3, a +
+ ncurses stores compiled terminal descriptions in three related formats, + described in the sections + + o LEGACY STORAGE FORMAT, and + + o EXTENDED STORAGE FORMAT, and + + o EXTENDED NUMBER FORMAT. + + The legacy storage format and the extended number format differ by the + types of numeric capability which they can store (i.e., 16-bit versus + 32-bit integers). The extended storage format introduced by ncurses + 5.0 adds data to either of these formats. + + Some limitations apply: + + o total compiled entries cannot exceed 4096 bytes in the legacy + format. + + o total compiled entries cannot exceed 32768 bytes in the extended + format. + + o the name field cannot exceed 128 bytes. + + Compiled entries are limited to 32768 bytes because offsets into the + strings table use two-byte integers. The legacy format could have + supported 32768-byte entries, but was limited to a virtual memory + page's 4096 bytes. + + +
+ As an example, here is a description for the Lear-Siegler ADM-3, a popular though rather stupid early terminal: adm3a|lsi adm3a, @@ -343,28 +385,6 @@ 0150 00 08 00 0c 00 0b 00 0a 00 ........ . -
- Some limitations: - - o total compiled entries cannot exceed 4096 bytes in the legacy - format. - - o total compiled entries cannot exceed 32768 bytes in the extended - format. - - o the name field cannot exceed 128 bytes. - - Compiled entries are limited to 32768 bytes because offsets into the - strings table use two-byte integers. The legacy format could have - supported 32768-byte entries, but was limited a virtual memory page's - 4096 bytes. - - -
- /usr/share/terminfo - compiled terminal description database - -
Thomas E. Dickey extended terminfo format for ncurses 5.0 @@ -376,11 +396,11 @@
- curses(3x), curs_terminfo(3x), terminfo(5) + curses(3x), curs_terminfo(3x), terminfo(5), user_caps(5) -ncurses 6.4 2023-10-21 term(5) +ncurses 6.4 2023-11-25 term(5)