--- man/curs_inopts.3x | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-)
diff --git a/man/curs_inopts.3x b/man/curs_inopts.3x
index 75c2394a3..14c54ed46 100644
--- a/man/curs_inopts.3x
+++ b/man/curs_inopts.3x
@@ -735,34 +735,37 @@ .SH PORTABILITY
.PP
When
.B \%keypad
-is first enabled,
+is first enabled for a window,
.I \%ncurses
-loads the key definitions for the current terminal type description.
+loads the standard function key string capabilities
+for the terminal type description of its screen;
+see the entries beginning with \*(``key_\*('' in \fB\%terminfo\fP(5).
If that description includes extended string capabilities,
-for example,
-by using the
+produced by the
.B \-x
option of \fB\%@TIC@\fP(1),
+for example,
then
.I \%ncurses
-also defines keys for the capabilities whose names begin with
+also defines keys for the capabilities whose codes begin with
\*(``k\*(''.
-Corresponding key codes are generated and
-(depending on previous loads of terminal descriptions)
-may differ from one execution of a program to the next.
-The generated key codes are recognized by \fB\%keyname\fP(3X),
-which then returns a name beginning with \*(``k\*('' denoting the
+.I \%ncurses
+generates a numeric key code for each such extended capability;
+depending on previous loads of terminal type descriptions,
+these may differ from one execution of a program to the next.
+\fB\%keyname\fP(3X) recognizes the generated key codes
+and returns a name beginning with \*(``k\*('' denoting the
.I \%term\%info
-capability name rather than \*(``K\*('',
+capability name rather than \*(``KEY_\*('',
used for
.I curses
key names.
On the other hand,
an application can use \fB\%define_key\fP(3X) to bind
-a specific key to a string of the programmer's choice.
+a selected key to a string of the programmer's choice.
This feature enables an application to check for its presence
with \fB\%tigetstr\fP(3X),
-and reassign the key code to match its own needs.
+and reassign the numeric key code to match its own needs.
.PP
Low-level applications can use \fB\%tigetstr\fP(3X) to obtain the
definition of any string capability.
@@ -789,7 +792,8 @@ .SH PORTABILITY
.IR \%ncurses ,
extended capabilities can be interpreted as key definitions.
The library loads these after its built-in definitions,
-and if a capability's value is the same as one previously loaded,
+and if an extended capability's value
+is the same as one previously loaded,
the library uses the later definition.
.SH HISTORY
4BSD (1980)
--
2.30.2
signature.asc
Description: PGP signature
