path: root/contrib/ncurses/man/keybound.3x
diff options
Diffstat (limited to 'contrib/ncurses/man/keybound.3x')
1 files changed, 9 insertions, 6 deletions
diff --git a/contrib/ncurses/man/keybound.3x b/contrib/ncurses/man/keybound.3x
index 79c480cfd386..93e17945a31a 100644
--- a/contrib/ncurses/man/keybound.3x
+++ b/contrib/ncurses/man/keybound.3x
@@ -1,5 +1,5 @@
-.\" Copyright (c) 1999,2002 Free Software Foundation, Inc. *
+.\" Copyright (c) 1999-2003,2006 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,24 +26,27 @@
.\" authorization. *
-.\" Author: Thomas E. Dickey <dickey@clark.net> 1999
+.\" Author: Thomas E. Dickey 1999
-.\" $Id: keybound.3x,v 1.3 2002/02/16 22:30:36 tom Exp $
+.\" $Id: keybound.3x,v 1.6 2006/02/25 21:47:06 tom Exp $
.TH keyok 3X ""
\fBkeybound\fP \- return definition of keycode
\fB#include <curses.h>\fP
\fBchar * keybound(int keycode, int count);\fP
This is an extension to the curses library.
It permits an application to determine the string which is defined
in the terminfo for specific keycodes.
-The keycode must be greater than zero, else NULL is returned.
+The \fIkeycode\fP parameter must be greater than zero, else NULL is returned.
If it does not correspond to a defined key, then NULL is returned.
-Otherwise, the function returns a string, which must be freed by the caller.
+The \fIcount\fP parameter is used to allow the application to iterate
+through multiple definitions, counting from zero.
+When successful,
+the function returns a string which must be freed by the caller.
These routines are specific to ncurses. They were not supported on
Version 7, BSD or System V implementations. It is recommended that