From 023943c7389cd1ece50bb92bb8bd1af42b62c580 Mon Sep 17 00:00:00 2001 From: Paul LeoNerd Evans Date: Thu, 6 Nov 2008 19:50:53 +0000 Subject: Don't document the termkey_free() function as it doesn't restore termios; document termkey_destroy() instead --- termkey_new.3 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'termkey_new.3') diff --git a/termkey_new.3 b/termkey_new.3 index 7aaed18..3fcea96 100644 --- a/termkey_new.3 +++ b/termkey_new.3 @@ -1,20 +1,20 @@ .TH TERMKEY_NEW 3 .SH NAME -termkey_new, termkey_free \- create or destroy new termkey instance +termkey_new, termkey_destroy \- create or destroy new termkey instance .SH SYNOPSIS .nf .B #include .sp .BI "termkey_tk *termkey_new(int " fd ", int " flags ); .br -.BI "void termkey_free(termkey_t *" tk ); +.BI "void termkey_destroy(termkey_t *" tk ); .fi .sp Link with \fI\-ltermkey\fP. .SH DESCRIPTION \fBtermkey_new\fP() creates a new termkey instance connected to the file handle opened by \fIfd\fP using the \fIflags\fP. The \fBtermkey_tk\fP structure should be considered opaque; its contents are not intended for use outside of the library. .PP -\fBtermkey_free\fP() destroys the given instance and releases any resources controlled by it. It will not close the underlying filehandle given as the \fIfd\fP argument to \fBtermkey_new\fP(). +\fBtermkey_destroy\fP() destroys the given instance and releases any resources controlled by it. It will not close the underlying filehandle given as the \fIfd\fP argument to \fBtermkey_new\fP(). .PP The following values may be given as the \fIflags\fP bitmask: .TP @@ -37,7 +37,7 @@ Even if the terminal file descriptor \fIfd\fP represents a .SM TTY device, do not call the \fBtcsetattr\fP() \fBtermios\fP function on it to set it to canonical input mode. .SH "RETURN VALUE" -If successful, \fBtermkey_new\fP() returns a pointer to the new instance. On failure, \fBNULL\fP is returned. \fBtermkey_free\fP() returns no value. +If successful, \fBtermkey_new\fP() returns a pointer to the new instance. On failure, \fBNULL\fP is returned. \fBtermkey_destroy\fP() returns no value. .SH "SEE ALSO" .BR termkey_waitkey (3), .BR termkey_advisereadable (3), -- cgit v1.2.3-54-g00ecf