X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fterminfo.head;h=a17fa7828c6565a504f03e568e0172af1abecb25;hb=4c9f63c460cb7134f142aa65f6866c175ed77605;hp=24d4e2a5621a0ad43febd4375f7384bb0a4d4cad;hpb=cccf831ed7c83410c7f6cec2a43e71e9c4278b4c;p=ncurses.git diff --git a/man/terminfo.head b/man/terminfo.head index 24d4e2a5..a17fa782 100644 --- a/man/terminfo.head +++ b/man/terminfo.head @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2016,2017 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 * @@ -26,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: terminfo.head,v 1.33 2018/05/19 20:57:27 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@ @@ -49,24 +50,32 @@ .de NE .fi .ft R -.in -4 +.ie n .in -4 +.el .in -2 .. .SH NAME -terminfo \- terminal capability data base +terminfo \- terminal capability database .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. -This describes \fBncurses\fR +.PP +This manual describes \fBncurses\fP version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@). .SS Terminfo Entry Syntax .PP @@ -74,7 +83,7 @@ Entries in .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 @@ -123,7 +132,7 @@ have a root name, thus \*(``hp2621\*(''. This name should not contain hyphens. Modes that the hardware can be in, or user preferences, should be indicated by appending a hyphen and a mode suffix. -Thus, a vt100 in 132 column mode would be vt100\-w. +Thus, a vt100 in 132-column mode would be vt100\-w. The following suffixes should be used where possible: .PP .TS @@ -182,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 -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 @@ -190,14 +199,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 @@ -205,7 +214,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.