X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fterm.5.html;h=309a23dc432c6bce941814618d55a8d2a3349784;hp=ce6f5d4ac539285ab16adc672a064de765a530b2;hb=c3b21f65a2687f3894a0d3217006c23f162c893a;hpb=c6cfd97b8beaf0f6deafbf8aac7281cf6aa7f012 diff --git a/doc/html/man/term.5.html b/doc/html/man/term.5.html index ce6f5d4a..309a23dc 100644 --- a/doc/html/man/term.5.html +++ b/doc/html/man/term.5.html @@ -1,6 +1,6 @@ @@ -38,29 +38,24 @@
-term(5) term(5) --
+
term - format of compiled term file. --
+
term --
+
--
+
Compiled terminfo descriptions are placed under the direc- tory /usr/share/terminfo. Two configurations are sup- ported (when building the ncurses libraries): @@ -93,15 +88,14 @@ existing directory, and hashed database otherwise. --
+
The format has been chosen so that it will be the same on all hardware. An 8 or more bit byte is assumed, but no assumptions about byte ordering or sign extension are made. The compiled file is created with the tic program, and - read by the routine setupterm. The file is divided into + read by the routine setupterm. The file is divided into six parts: the header, terminal names, boolean flags, num- bers, strings, and string table. @@ -173,8 +167,7 @@ section. Each string is null terminated. --
+
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 @@ -204,7 +197,7 @@ bytes. Using the counts and sizes, ncurses allocates arrays and - reads data for the extended capabilties in the same order + reads data for the extended capabilities in the same order as the header information. The extended string table contains values for string capa- @@ -213,15 +206,14 @@ e.g., booleans, then numbers and finally strings. --
- Note that it is possible for setupterm to expect a differ- +
+ Note that it is possible for setupterm to expect a differ- ent set of capabilities than are actually present in the file. Either the database may have been updated since - setupterm has been recompiled (resulting in extra unrecog- + setupterm has been recompiled (resulting in extra unrecog- nized entries in the file) or the program may have been recompiled more recently than the database was updated - (resulting in missing entries). The routine setupterm + (resulting in missing entries). The routine setupterm must be prepared for both possibilities - this is why the numbers and sizes are included. Also, new capabilities must always be added at the end of the lists of boolean, @@ -239,8 +231,7 @@ sion of terminfo source compatibility issues. --
+
As an example, here is a hex dump of the description for the Lear-Siegler ADM-3, a popular though rather stupid early terminal: @@ -277,25 +268,21 @@ --
+
Some limitations: total compiled entries cannot exceed 4096 bytes. The name field cannot exceed 128 bytes. --
+
/usr/share/terminfo/*/* compiled terminal capability data base --
+
curses(3x), terminfo(5). --
+
Thomas E. Dickey extended terminfo format for ncurses 5.0 hashed database support for ncurses 5.6