ncurses 6.3 - patch 20220709

[ncurses.git] / man / terminfo.head

diff --git a/man/terminfo.head b/man/terminfo.head
index 122812ac296fc81587c988571415d3ba72ec7550..a17fa7828c6565a504f03e568e0172af1abecb25 100644 (file)
--- a/man/terminfo.head
+++ b/man/terminfo.head
@@ -1,5 +1,6 @@
 .\"***************************************************************************
 .\"***************************************************************************

-.\" Copyright (c) 1998-2018,2019 Free Software Foundation, Inc.              *
+.\" Copyright 2018-2020,2021 Thomas E. Dickey                                *
+.\" Copyright 1998-2016,2017 Free Software Foundation, Inc.                  *

 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *


@@ -26,7 +27,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: terminfo.head,v 1.36 2019/07/13 23:17:33 tom Exp $
+.\" $Id: terminfo.head,v 1.42 2021/12/25 17:39:16 tom Exp $

 .TH terminfo 5 "" "" "File Formats"
 .ds n 5
 .ds d @TERMINFO@
 .TH terminfo 5 "" "" "File Formats"
 .ds n 5
 .ds d @TERMINFO@


@@ -53,21 +54,28 @@
 .el    .in -2
 ..
 .SH NAME
 .el    .in -2
 ..
 .SH NAME

-terminfo \- terminal capability data base
+terminfo \- terminal capability database

 .SH SYNOPSIS
 \*d/*/*
 .SH DESCRIPTION
 .I Terminfo
 .SH SYNOPSIS
 \*d/*/*
 .SH DESCRIPTION
 .I Terminfo

-is a data base describing terminals, used by screen-oriented programs such as
-\fBnvi\fR(1),
-\fBrogue\fR(1)
-and libraries such as
-\fBcurses\fR(3X).
+is a database describing terminals,
+used by screen-oriented programs such as
+\fBnvi\fP(1),
+\fBlynx\fP(1),
+\fBmutt\fP(1),
+and other curses applications,
+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)).
+.PP

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

-This describes \fBncurses\fR
+.PP
+This manual describes \fBncurses\fP

 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
 .SS Terminfo Entry Syntax
 .PP
 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
 .SS Terminfo Entry Syntax
 .PP


@@ -75,7 +83,7 @@ Entries in
 .I terminfo
 consist of a sequence of fields:
 .bP
 .I terminfo
 consist of a sequence of fields:
 .bP

-Each field ends with a comma \*(``,\*('' 
+Each field ends with a comma \*(``,\*(''

 (embedded commas may be
 escaped with a backslash or written as \*(``\\054\*('').
 .bP
 (embedded commas may be
 escaped with a backslash or written as \*(``\\054\*('').
 .bP


@@ -183,7 +191,7 @@ rather than a capability value.
 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
 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
 the name of the base terminal:
 .bP
 The capabilities given before


@@ -191,14 +199,14 @@ The capabilities given before
 override those in the base type named by
 .BR use .
 .bP
 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
 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
 .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
 use reference that imports it, where \fIxx\fP is the capability.
 For example, the entry
 .RS


@@ -206,7 +214,7 @@ For example, the entry
 2621\-nl, smkx@, rmkx@, use=2621,
 .RE
 .PP
 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.
 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.