ncurses 6.4 - patch 20231125

[ncurses.git] / man / terminfo.tail

diff --git a/man/terminfo.tail b/man/terminfo.tail
index e420275a2d5faf5daf1c140ad0745a45e393936f..267a104d59e59c6523612f605aa38e4b8671effb 100644 (file)
--- a/man/terminfo.tail
+++ b/man/terminfo.tail
@@ -27,7 +27,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: terminfo.tail,v 1.134 2023/10/14 19:18:14 tom Exp $
+.\" $Id: terminfo.tail,v 1.135 2023/11/25 14:32:36 tom Exp $

 .ps +1
 .SS User-Defined Capabilities
 .
 .ps +1
 .SS User-Defined Capabilities
 .


@@ -247,7 +247,7 @@ in the example above.
 Terminal descriptions in \fBncurses\fP are stored in terminal databases.
 These databases, which are found by their pathname,
 may be configured either as directory trees or hashed databases
 Terminal descriptions in \fBncurses\fP are stored in terminal databases.
 These databases, which are found by their pathname,
 may be configured either as directory trees or hashed databases

-(see \fBterm\fR(\*n)),
+(see \fBterm\fR(5)),

 .PP
 The library uses a compiled-in list of pathnames,
 which can be overridden by environment variables.
 .PP
 The library uses a compiled-in list of pathnames,
 which can be overridden by environment variables.


@@ -1810,7 +1810,7 @@ A prototype command character is chosen which is used in all capabilities.
 This character is given in the
 .B cmdch
 capability to identify it.
 This character is given in the
 .B cmdch
 capability to identify it.

-The following convention is supported on some UNIX systems:
+The following convention is supported on some Unix systems:

 The environment is to be searched for a
 .B CC
 variable, and if found, all
 The environment is to be searched for a
 .B CC
 variable, and if found, all


@@ -1852,7 +1852,7 @@ A value of
 indicates that the number of lines is not fixed,
 but that there is still more memory than fits on the screen.
 .PP
 indicates that the number of lines is not fixed,
 but that there is still more memory than fits on the screen.
 .PP

-If the terminal is one of those supported by the \s-1UNIX\s+1 virtual
+If the terminal is one of those supported by the Unix virtual

 terminal protocol, the terminal number can be given as
 .BR vt .
 .PP
 terminal protocol, the terminal number can be given as
 .BR vt .
 .PP


@@ -2001,13 +2001,15 @@ When in \-C (translate to termcap) mode, the \fBncurses\fP implementation of
 translation is too long.
 The \-c (check) option also checks resolved (after tc
 expansion) lengths.
 translation is too long.
 The \-c (check) option also checks resolved (after tc
 expansion) lengths.

-.SS Binary Compatibility
-It is not wise to count on portability of binary terminfo entries between
-commercial UNIX versions.
-The problem is that there are at least two versions
-of terminfo (under HP\-UX and AIX) which diverged from System V terminfo after
-SVr1, and have added extension capabilities to the string table that (in the
-binary format) collide with System V and XSI Curses extensions.
+.SH PORTABILITY
+Do not count on compiled (binary) \fI\%terminfo\fP entries being
+portable between commercial Unix systems.
+At least two implementations of \fI\%terminfo\fP
+(those of HP-UX and AIX)
+diverged from those of other System V Unices after SVr1,
+adding extension capabilities to the string table that
+(in the binary format)
+collide with subsequent System V and XSI Curses extensions.

 .SH EXTENSIONS
 Searching for terminal descriptions in
 \fB$HOME/.terminfo\fP and TERMINFO_DIRS
 .SH EXTENSIONS
 Searching for terminal descriptions in
 \fB$HOME/.terminfo\fP and TERMINFO_DIRS


@@ -2049,36 +2051,45 @@ an absent or cancelled \fBncv\fP.
 If italics should work with colors,
 then the \fBncv\fP value must be specified, even if it is zero.
 .PP
 If italics should work with colors,
 then the \fBncv\fP value must be specified, even if it is zero.
 .PP

-Different commercial ports of terminfo and curses support different subsets of
-the XSI Curses standard and (in some cases) different extension sets.
-Here
-is a summary, accurate as of October 1995:
+Different commercial ports of \fI\%terminfo\fP and \fIcurses\fP support
+different subsets of XSI Curses and
+(in some cases)
+different extensions.
+Here is a summary,
+accurate as of October 1995,
+after which the commercial Unix market contracted and lost diversity.

 .bP
 .bP

-\fBSVR4, Solaris, ncurses\fP \-\-
-These support all SVr4 capabilities.
+SVr4,
+Solaris,
+and \fI\%ncurses\fP support all SVr4 capabilities.

 .bP
 .bP

-\fBSGI\fP \-\-
-Supports the SVr4 set, adds one undocumented extended string
-capability (\fBset_pglen\fP).
+IRIX supports the SVr4 set and adds one undocumented extended string
+capability (\fB\%set_pglen\fP).

 .bP
 .bP

-\fBSVr1, Ultrix\fP \-\-
-These support a restricted subset of terminfo capabilities.
-The booleans end with \fBxon_xoff\fP;
-the numerics with \fBwidth_status_line\fP;
-and the strings with \fBprtr_non\fP.
-.bP
-\fBHP/UX\fP \-\-
-Supports the SVr1 subset, plus the SVr[234] numerics \fBnum_labels\fP,
-\fBlabel_height\fP, \fBlabel_width\fP, plus function keys 11 through 63, plus
-\fBplab_norm\fP, \fBlabel_on\fP, and \fBlabel_off\fP, plus some incompatible
-extensions in the string table.
+SVr1 and Ultrix support a restricted subset of \fI\%terminfo\fP
+capabilities.
+The Booleans end with \fB\%xon_xoff\fP;
+the numerics with \fB\%width_status_line\fP;
+and the strings with \fB\%prtr_non\fP.
+.bP
+HP/UX supports the SVr1 subset,
+plus the SVr[234] numerics
+\fB\%num_labels\fP,
+\fB\%label_height\fP,
+\fB\%label_width\fP,
+plus function keys 11 through 63,
+plus
+\fB\%plab_norm\fP,
+\fB\%label_on\fP,
+and
+\fB\%label_off\fP,
+plus a number of incompatible string table extensions.

 .bP
 .bP

-\fBAIX\fP \-\-
-Supports the SVr1 subset, plus function keys 11 through 63, plus a number
-of incompatible string table extensions.
+AIX supports the SVr1 subset,
+plus function keys 11 through 63,
+plus a number of incompatible string table extensions.

 .bP
 .bP

-\fBOSF\fP \-\-
-Supports both the SVr4 set and the AIX extensions.
+OSF/1 supports both the SVr4 set and the AIX extensions.

 .SH FILES
 .TP
 .I \*d
 .SH FILES
 .TP
 .I \*d


@@ -2096,5 +2107,5 @@ Based on \fIpcurses\fP by Pavel Curtis.
 \fB\%curs_variables\fP(3X),
 \fB\%printf\fP(3),
 \fB\%term_variables\fP(3X),
 \fB\%curs_variables\fP(3X),
 \fB\%printf\fP(3),
 \fB\%term_variables\fP(3X),

-\fB\%term\fP(\*n),
+\fB\%term\fP(5),

 \fB\%user_caps\fP(5)
 \fB\%user_caps\fP(5)