ncurses 6.4 - patch 20230909

[ncurses.git] / man / terminfo.head

diff --git a/man/terminfo.head b/man/terminfo.head
index 15be24e71c35123ee974d1910da12040f42c2419..ab24174e993dc3343cb97e74cd5fe3eb0e3ee9f3 100644 (file)
--- a/man/terminfo.head
+++ b/man/terminfo.head
@@ -1,5 +1,5 @@
 .\"***************************************************************************
-.\" Copyright 2018-2020,2021 Thomas E. Dickey                                *
+.\" Copyright 2018-2021,2023 Thomas E. Dickey                                *
 .\" Copyright 1998-2016,2017 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
@@ -27,14 +27,23 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: terminfo.head,v 1.41 2021/08/15 19:32:53 tom Exp $
-.TH terminfo 5 "" "" "File Formats"
+.\" $Id: terminfo.head,v 1.48 2023/09/09 21:34:18 tom Exp $
+.TH terminfo 5 2023-09-09 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "File formats"
 .ds n 5
 .ds d @TERMINFO@
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``
 .ie \n(.g .ds '' \(rq
 .el       .ds '' ''
+.ie \n(.g .ds ^ \(ha
+.el       .ds ^ ^
+.ie \n(.g .ds ~ \(ti
+.el       .ds ~ ~
+.ie n .ds CW R
+.el   \{
+.ie \n(.g .ds CW CR
+.el       .ds CW CW
+.\}
 .de bP
 .ie n  .IP \(bu 4
 .el    .IP \(bu 2
@@ -45,7 +54,7 @@
 .ie n  .in +4
 .el    .in +2
 .nf
-.ft C                  \" Courier
+.ft \*(CW
 ..
 .de NE
 .fi
@@ -61,11 +70,11 @@ terminfo \- terminal capability database
 .I Terminfo
 is a database describing terminals,
 used by screen-oriented programs such as
-\fBnvi\fR(1),
-\fBlynx\fR(1),
-\fBmutt\fR(1),
+\fBnvi\fP(1),
+\fBlynx\fP(1),
+\fBmutt\fP(1),
 and other curses applications,
-using high-level calls to libraries such as \fBcurses\fR(3X).
+using high-level calls to libraries such as \fBcurses\fP(3X).
 It is also used via low-level calls by non-curses applications
 which may be screen-oriented (such as \fB@CLEAR@\fP(1))
 or non-screen (such as \fB@TABS@\fP(1)).
@@ -75,10 +84,9 @@ describes terminals by giving a set of capabilities which they
 have, by specifying how to perform screen operations, and by
 specifying padding requirements and initialization sequences.
 .PP
-This manual describes \fBncurses\fR
+This manual describes \fBncurses\fP
 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
 .SS Terminfo Entry Syntax
-.PP
 Entries in
 .I terminfo
 consist of a sequence of fields:
@@ -136,10 +144,11 @@ Thus, a vt100 in 132-column mode would be vt100\-w.
 The following suffixes should be used where possible:
 .PP
 .TS
-center ;
-l c l
-l l l.
-\fBSuffix      Meaning Example\fP
+center;
+lb cb lb
+l  l  l .
+Suffix Meaning Example
+_
 \-\fInn\fP     Number of lines on the screen   aaa\-60
 \-\fIn\fPp     Number of pages of memory       c100\-4p
 \-am   With automargins (usually the default)  vt100\-am
@@ -157,7 +166,6 @@ l l l.
 .PP
 For more on terminal naming conventions, see the \fBterm\fP(7) manual page.
 .SS Terminfo Capabilities Syntax
-.PP
 The terminfo entry consists of several \fIcapabilities\fP,
 i.e., features that the terminal has,
 or methods for exercising the terminal's features.
@@ -187,11 +195,10 @@ i.e., suppressed from the terminal entry,
 by following its name with \*(``@\*(''
 rather than a capability value.
 .SS Similar Terminals
-.PP
 If there are two very similar terminals, one (the variant) can be defined as
 being just like the other (the base) with certain exceptions.
 In the
-definition of the variant, the string capability \fBuse\fR can be given with
+definition of the variant, the string capability \fBuse\fP can be given with
 the name of the base terminal:
 .bP
 The capabilities given before
@@ -199,14 +206,14 @@ The capabilities given before
 override those in the base type named by
 .BR use .
 .bP
-If there are multiple \fBuse\fR capabilities, they are merged in reverse order.
-That is, the rightmost \fBuse\fR reference is processed first, then the one to
+If there are multiple \fBuse\fP capabilities, they are merged in reverse order.
+That is, the rightmost \fBuse\fP reference is processed first, then the one to
 its left, and so forth.
 .bP
 Capabilities given explicitly in the entry override
-those brought in by \fBuse\fR references.
+those brought in by \fBuse\fP references.
 .PP
-A capability can be canceled by placing \fBxx@\fR to the left of the
+A capability can be canceled by placing \fBxx@\fP to the left of the
 use reference that imports it, where \fIxx\fP is the capability.
 For example, the entry
 .RS
@@ -214,7 +221,7 @@ For example, the entry
 2621\-nl, smkx@, rmkx@, use=2621,
 .RE
 .PP
-defines a 2621\-nl that does not have the \fBsmkx\fR or \fBrmkx\fR capabilities,
+defines a 2621\-nl that does not have the \fBsmkx\fP or \fBrmkx\fP capabilities,
 and hence does not turn on the function key labels when in visual mode.
 This is useful for different modes for a terminal, or for different
 user preferences.