aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul LeoNerd Evans <leonerd@leonerd.org.uk>2008-11-06 19:50:53 +0000
committerPaul LeoNerd Evans <leonerd@leonerd.org.uk>2008-11-06 19:50:53 +0000
commit023943c7389cd1ece50bb92bb8bd1af42b62c580 (patch)
treec76129191d80bb98c0c53e465bee0291c6d20824
parent9aaf16888c9bd1ab63f0336f6becca87525118c6 (diff)
downloadtermo-023943c7389cd1ece50bb92bb8bd1af42b62c580.tar.gz
termo-023943c7389cd1ece50bb92bb8bd1af42b62c580.tar.xz
termo-023943c7389cd1ece50bb92bb8bd1af42b62c580.zip
Don't document the termkey_free() function as it doesn't restore termios; document termkey_destroy() instead
-rw-r--r--Makefile2
-rw-r--r--termkey_get_keyname.32
-rw-r--r--termkey_new.38
3 files changed, 6 insertions, 6 deletions
diff --git a/Makefile b/Makefile
index 5a08630..4b9cec2 100644
--- a/Makefile
+++ b/Makefile
@@ -57,6 +57,6 @@ install-man:
for F in *.3; do \
gzip <$$F >$(DESTDIR)$(MAN3DIR)/$$F.gz; \
done
- ln -sf termkey_new.3.gz $(DESTDIR)$(MAN3DIR)/termkey_free.3.gz
+ ln -sf termkey_new.3.gz $(DESTDIR)$(MAN3DIR)/termkey_destroy.3.gz
ln -sf termkey_getkey.3.gz $(DESTDIR)$(MAN3DIR)/termkey_getkey_force.3.gz
ln -sf termkey_setwaittime.3.gz $(DESTDIR)$(MAN3DIR)/termkey_getwaittime.3.gz
diff --git a/termkey_get_keyname.3 b/termkey_get_keyname.3
index cc46460..c1f0d79 100644
--- a/termkey_get_keyname.3
+++ b/termkey_get_keyname.3
@@ -10,7 +10,7 @@ termkey_get_keyname \- return a string name for a symbolic key
.sp
Link with \fI-ltermkey\fP.
.SH DESCRIPTION
-\fBtermkey_get_keyname\fP returns a human-readable string name for the symbolic key value given by \fBsym\fP. The returned string is owned by the termkey instance \fItk\fP so should not be modified or freed. The returned pointer is guaranteed to be valid until the termkey instance is released using \fBtermkey_free\fP(3).
+\fBtermkey_get_keyname\fP returns a human-readable string name for the symbolic key value given by \fBsym\fP. The returned string is owned by the termkey instance \fItk\fP so should not be modified or freed. The returned pointer is guaranteed to be valid until the termkey instance is released using \fBtermkey_destroy\fP(3).
.SH "RETURN VALUE"
\fBtermkey_get_key\fP() returns a pointer to a string.
.SH "SEE ALSO"
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 <termkey.h>
.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),