diff options
| author | Paul LeoNerd Evans <leonerd@leonerd.org.uk> | 2008-11-06 19:40:28 +0000 |
|---|---|---|
| committer | Paul LeoNerd Evans <leonerd@leonerd.org.uk> | 2008-11-06 19:40:28 +0000 |
| commit | 9aaf16888c9bd1ab63f0336f6becca87525118c6 (patch) | |
| tree | dbcafad11051949f050d85e3229976565db13c0b | |
| parent | 9df6f621b984b9a5dd3ae95df3d3ef94b6280de3 (diff) | |
| download | termo-9aaf16888c9bd1ab63f0336f6becca87525118c6.tar.gz termo-9aaf16888c9bd1ab63f0336f6becca87525118c6.tar.xz termo-9aaf16888c9bd1ab63f0336f6becca87525118c6.zip | |
Include demo.c and demo-async.c in the manpages under an EXAMPLE section
| -rw-r--r-- | Makefile | 7 | ||||
| -rw-r--r-- | termkey_getkey.3.sh (renamed from termkey_getkey.3) | 11 | ||||
| -rw-r--r-- | termkey_waitkey.3.sh (renamed from termkey_waitkey.3) | 11 |
3 files changed, 28 insertions, 1 deletions
@@ -15,7 +15,7 @@ ifeq ($(DEBUG),1) CFLAGS_DEBUG=-ggdb -DDEBUG endif -all: demo demo-async +all: demo demo-async doc demo: libtermkey.so demo.c $(CC) $(CFLAGS) $(CFLAGS_DEBUG) -o $@ $^ @@ -29,6 +29,11 @@ libtermkey.so: termkey.o driver-csi.o driver-ti.o %.o: %.c termkey.h termkey-internal.h $(CC) $(CFLAGS) $(CFLAGS_DEBUG) -Wall -std=c99 -fPIC -o $@ -c $< +doc: termkey_waitkey.3 termkey_getkey.3 + +%.3: %.3.sh + sh $< >$@ + .PHONY: clean clean: rm -f *.o demo diff --git a/termkey_getkey.3 b/termkey_getkey.3.sh index f77caa0..1b78948 100644 --- a/termkey_getkey.3 +++ b/termkey_getkey.3.sh @@ -1,3 +1,5 @@ +# vim:ft=nroff +cat <<EOF .TH TERMKEY_GETKEY 3 .SH NAME termkey_getkey, termkey_getkey_force \- retrieve the next key event @@ -65,6 +67,14 @@ No key events are ready and the terminal has been closed, so no more will arrive .TP .B TERMKEY_RES_AGAIN No key event is ready yet, but a partial one has been found. This is only returned by \fBtermkey_getkey\fP(). To obtain the partial result even if it never completes, use \fBtermkey_getkey_force\fP(). +.SH EXAMPLE +The following example program prints details of every keypress until the user presses "Ctrl-C". It demonstrates how to use the termkey instance in a typical \fBpoll\fP()-driven asynchronous program, which may include mixed IO with other file handles. +.PP +.in +4n +`sed i.br demo-async.c` +.in +.nf +.fi .SH "SEE ALSO" .BR termkey_new (3), .BR termkey_advisereadable (3), @@ -72,3 +82,4 @@ No key event is ready yet, but a partial one has been found. This is only return .BR termkey_setwaittime (3), .BR termkey_get_keyname (3), .BR termkey_snprint_key (3) +EOF diff --git a/termkey_waitkey.3 b/termkey_waitkey.3.sh index 9079dcb..c14bbd7 100644 --- a/termkey_waitkey.3 +++ b/termkey_waitkey.3.sh @@ -1,3 +1,5 @@ +# vim:ft=nroff +cat <<EOF .TH TERMKEY_WAITKEY 3 .SH NAME termkey_waitkey \- wait for and retrieve the next key event @@ -23,9 +25,18 @@ A key event as been provided. .TP .B TERMKEY_RES_EOF No key events are ready and the terminal has been closed, so no more will arrive. +.SH EXAMPLE +The following example program prints details of every keypress until the user presses "Ctrl-C". +.PP +.in +4n +`sed i.br demo.c` +.in +.nf +.fi .SH "SEE ALSO" .BR termkey_new (3), .BR termkey_getkey (3), .BR termkey_setwaittime (3), .BR termkey_get_keyname (3), .BR termkey_snprint_key (3) +EOF |