Updated manpages for function rename sprint_key -> strfkey

This commit is contained in:
Paul LeoNerd Evans 2011-03-31 15:42:32 +01:00
parent 9b97244c54
commit 7c9f24fc8e
4 changed files with 10 additions and 8 deletions

View File

@ -18,4 +18,4 @@ Link with \fI-ltermkey\fP.
.BR termkey_getkey (3), .BR termkey_getkey (3),
.BR termkey_waitkey (3), .BR termkey_waitkey (3),
.BR termkey_keyname2sym (3), .BR termkey_keyname2sym (3),
.BR termkey_snprint_key (3) .BR termkey_strfkey (3)

View File

@ -18,4 +18,4 @@ Because the key names are stored in an array indexed by the symbol number, this
.SH "SEE ALSO" .SH "SEE ALSO"
.BR termkey_new (3), .BR termkey_new (3),
.BR termkey_get_keyname (3), .BR termkey_get_keyname (3),
.BR termkey_snprint_key (3) .BR termkey_strfkey (3)

View File

@ -1,17 +1,17 @@
.TH TERMKEY_SNPRINT_KEY 3 .TH TERMKEY_STRFKEY 3
.SH NAME .SH NAME
termkey_snprint_key \- format a string representing a key event termkey_strfkey \- format a string representing a key event
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #include <termkey.h> .B #include <termkey.h>
.sp .sp
.BI "size_t termkey_snprint_key(TermKey *" tk ", char *" buffer ", size_t " len ", .BI "size_t termkey_strfkey(TermKey *" tk ", char *" buffer ", size_t " len ",
.BI " TermKeyKey " key ", TermKeyFormat " format ); .BI " TermKeyKey " key ", TermKeyFormat " format );
.fi .fi
.sp .sp
Link with \fI-ltermkey\fP. Link with \fI-ltermkey\fP.
.SH DESCRIPTION .SH DESCRIPTION
\fBtermkey_snprint_key\fP formats a string buffer to contain a human-readable representation of a key event. It fills the \fIbuffer\fP in a way analogous to the \fBsnprintf\fP(3) standard library function. \fBtermkey_strfkey\fP formats a string buffer to contain a human-readable representation of a key event. It fills the \fIbuffer\fP in a way analogous to the \fBsnprintf\fP(3) or \fBstrftime\fP(3) standard library functions. This function used to be called \fBtermkey_snprint_key\fP but was renamed after version 0.6.
.PP .PP
The \fIformat\fP argument specifies the format of the output, as a bitmask of the following constants: The \fIformat\fP argument specifies the format of the output, as a bitmask of the following constants:
.TP .TP
@ -34,8 +34,10 @@ The following shortcuts are provided for common combinations of format bits:
.TP .TP
.B TERMKEY_FORMAT_VIM .B TERMKEY_FORMAT_VIM
Shortcut to set \fBALTISMETA\fP and \fBWRAPBRACKET\fP, to give an output close to the format the \fIvim\fP editor uses. Shortcut to set \fBALTISMETA\fP and \fBWRAPBRACKET\fP, to give an output close to the format the \fIvim\fP editor uses.
.PP
When formatting a \fBTERMKEY_TYPE_UNICODE\fP key structure, this function uses the \fIutf8\fP member. If this member contains an empty string (i.e. its first character is 0) then this member will be prefilled by the function from the \fIcode.number\fP member. This can be convenient when the key structure is being constructed programatically by user code.
.SH "RETURN VALUE" .SH "RETURN VALUE"
\fBtermkey_snprint_key\fP() returns the number of characters written to \fIbuffer\fP. \fBtermkey_strfkey\fP() returns the number of characters written to \fIbuffer\fP.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR termkey_new (3), .BR termkey_new (3),
.BR termkey_getkey (3), .BR termkey_getkey (3),

View File

@ -40,5 +40,5 @@ cat <<EOF
.BR termkey_getkey (3), .BR termkey_getkey (3),
.BR termkey_set_waittime (3), .BR termkey_set_waittime (3),
.BR termkey_get_keyname (3), .BR termkey_get_keyname (3),
.BR termkey_snprint_key (3) .BR termkey_strfkey (3)
EOF EOF