X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fkeyok.3x.html;h=dbb3f0c1cca1d94d056d81801e032a61bc63ef9b;hb=HEAD;hp=4e65b40c689470ed5c6df743c9064072b7f69f2f;hpb=0eedaa5673ff8181abe51e3a6fadca3820f90c46;p=ncurses.git diff --git a/doc/html/man/keyok.3x.html b/doc/html/man/keyok.3x.html index 4e65b40c..e6d3a35e 100644 --- a/doc/html/man/keyok.3x.html +++ b/doc/html/man/keyok.3x.html @@ -1,6 +1,6 @@ -keyok 3x 2023-09-23 ncurses 6.4 Library calls +keyok 3x 2024-05-18 ncurses 6.5 Library calls -

keyok 3x 2023-09-23 ncurses 6.4 Library calls

+

keyok 3x 2024-05-18 ncurses 6.5 Library calls

 keyok(3x)                        Library calls                       keyok(3x)
 
@@ -48,44 +48,56 @@

NAME

-       keyok - enable or disable a curses keycode
+       keyok - enable or disable a curses function key code

SYNOPSIS

        #include <curses.h>
 
-       int keyok(int keycode, bool enable);
+       int keyok(int key-code, bool bf);

DESCRIPTION

-       This  is an extension to the curses library.  It permits an application
-       to disable specific keycodes, rather than use the  keypad  function  to
-       disable all keycodes.  Keys that have been disabled can be re-enabled.
+       The  keyok  ncurses extension permits a curses application to disable a
+       function key key-code returned by wgetch(3x) (wide-character API users:
+       wget_wch(3x)).   Key  codes  that have been disabled can be re-enabled.
+       bf indicates the desired enablement status.   This  operation  is  more
+       fine-grained than calling keypad(3x), which affects all function keys.

RETURN VALUE

-       The  keycode  must  be  greater than zero, else ERR is returned.  If it
-       does not correspond to a defined key, then ERR  is  returned.   If  the
-       enable  parameter  is  true,  then the key must have been disabled, and
-       vice versa.  Otherwise, the function returns OK.
+       keyok returns ERR if
 
+       o   key-code is nonpositive,
 
-

PORTABILITY

-       This routine is specific to ncurses.  It was not supported  on  Version
-       7,  BSD  or  System V implementations.  It is recommended that any code
-       depending on them be conditioned using NCURSES_VERSION.
+       o   key-code is not a recognized value, or
 
+       o   enablement of key-code is already in the desired state.
+
+       Otherwise, keyok returns OK.
 
-

SEE ALSO

-       define_key(3x)
 
+

EXTENSIONS

+       keyok is an ncurses extension.
+
+
+

PORTABILITY

+       Applications employing ncurses extensions should condition their use on
+       the visibility of the NCURSES_VERSION preprocessor macro.
 
-

AUTHOR

+       NetBSD curses since 2.0 (2004) supports keyok.
+
+
+

AUTHORS

        Thomas Dickey
 
 
+

SEE ALSO

+       ncurses(3x), define_key(3x), key_defined(3x), keybound(3x), keyok(3x),
+
+
 
-ncurses 6.4                       2023-09-23                         keyok(3x)
+ncurses 6.5                       2024-05-18                         keyok(3x)