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 2023-10-21 ncurses 6.4 File formats +term 5 2023-11-25 ncurses 6.4 File formats -

term 5 2023-10-21 ncurses 6.4 File formats

+

term 5 2023-11-25 ncurses 6.4 File formats

 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 @@
 

EXTENDED STORAGE FORMAT

        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.
 
 
+

FILES

+       /usr/share/terminfo
+              compiled terminal description database
+
+
 

PORTABILITY

 
 

setupterm

@@ -261,12 +272,12 @@
 
 

Binary format

        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.
 
 
-

EXAMPLE

-       As an example, here is a description  for  the  Lear-Siegler  ADM-3,  a
+

Limits

+       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.
+
+
+

EXAMPLES

+       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                       ........ .
 
 
-

LIMITS

-       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.
-
-
-

FILES

-       /usr/share/terminfo
-              compiled terminal description database
-
-
 

AUTHORS

        Thomas E. Dickey
        extended terminfo format for ncurses 5.0
@@ -376,11 +396,11 @@
 
 
 

SEE ALSO

-       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)