- added man-pages, contributed by Marcus Better <marcus@better.se>

6 files changed, 127 insertions, 2 deletions

diff --git a/.cvsignore b/.cvsignore
new file mode 100644
index 0000000..7ca1ee2
--- /dev/null
+++ b/.cvsignore
@@ -0,0 +1,13 @@
+Make.config
+BTN.h
+BUS.h
+EV.h
+KEY.h
+REL.h
+lircd.conf
+input-events
+input-kbd
+input-recv
+input-send
+lsinput
+
diff --git a/GNUmakefile b/GNUmakefile
index 0479955..8f96e6f 100644
--- a/GNUmakefile
+++ b/GNUmakefile
@@ -44,8 +44,12 @@ input-recv: input-recv.o input.o tcp.o
 input.o: input.c $(HEADERS)
 
 install: build
-	install -d $(bindir)
-	install -s lsinput input-events input-kbd input-send input-recv $(bindir)
+	$(INSTALL_DIR) $(bindir) $(mandir)/man8
+	$(INSTALL_BINARY) lsinput input-events input-kbd input-send input-recv $(bindir)
+	$(INSTALL_DATA) lsinput.man $(mandir)/man8/lsinput.8
+	$(INSTALL_DATA) input-kbd.man $(mandir)/man8/input-kbd.8
+	$(INSTALL_DATA) input-events.man $(mandir)/man8/input-events.8
+
 
 clean:
 	-rm -f *.o $(depfiles)
diff --git a/input-events.man b/input-events.man
new file mode 100644
index 0000000..da381c7
--- /dev/null
+++ b/input-events.man
@@ -0,0 +1,34 @@
+.TH INPUT-EVENTS 8 "July 2005" "" ""
+.SH NAME
+
+input-events \- list input devices
+
+.SH SYNOPSIS
+\fBinput\-events \fR [\fB\-t\fR\ \fIsec\fR] [\fB\-g\fR]\ \fIdevnr\fR
+
+.SH DESCRIPTION
+.PP
+\fBinput\-events\fR listens for events on kernel input device
+\fIdevnr\fR and prints them.
+
+.SH OPTIONS
+.TP
+\fIdevnr\fR
+The index of the input device to use (0 for /dev/input/event0 and so on).
+
+.TP
+\fB\-g\fR
+Grab device using EVIOCGRAB, i\&.e\&.,
+get exclusive access to the device.
+
+.TP
+\fB\-t\fR\ \fIsec\fR
+Set the timeout.
+The program will quit after \fIsec\fR seconds without activity.
+
+.SH SEE ALSO
+.PP
+lsinput(8)
+
+.SH AUTHOR
+Gerd Knorr.
diff --git a/input-kbd.man b/input-kbd.man
new file mode 100644
index 0000000..3a792ba
--- /dev/null
+++ b/input-kbd.man
@@ -0,0 +1,54 @@
+.TH INPUT-KBD 8 "July 2005" "" ""
+
+.SH NAME
+input-kbd \- print or modify keyboard maps for input devices
+
+.SH SYNOPSIS
+\fBinput\-kbd\fR \fInum\fR
+.HP 10
+\fBinput\-kbd \fR [\fB\-f\fR\ \fIfile\fR] \fIdevnr\fR
+
+.SH DESCRIPTION
+
+.PP
+\fBinput\-kbd\fR prints the keyboard map of kernel input device
+\fIdevnr\fR on stdout.
+The keyboard map maps scancodes to keycodes.
+
+.PP
+If the device supports a keyboard map, 
+it is printed in the following format
+(from the output for an AT keyboard): 
+.IP
+        0x0001 =  67  # KEY_F9
+        0x0002 =  65  # KEY_F7
+        0x0003 =  63  # KEY_F5
+        0x0004 =  61  # KEY_F3
+ 
+
+.PP
+If the device does not support a keyboard map, 
+\fBinput\-kbd\fR just lists the keys and buttons supported by the device,
+like this (for a mouse):
+.IP
+        bits: BTN_LEFT
+        bits: BTN_RIGHT
+        bits: BTN_MIDDLE
+ 
+
+.SH OPTIONS
+
+.TP
+\fIdevnr\fR
+The index of the input device to use (0 for /dev/input/event0 and so on).
+
+.TP
+\fB\-f\fR \fIfile\fR
+Read a keyboard map from a file and reconfigure the device with this map.
+The map file uses the same format as the output of this command.
+Key names are also accepted instead of keycodes, like this: 
+.IP
+	0x0001 = KEY_F9
+ 
+.SH AUTHOR
+Gerd Knorr.
diff --git a/lsinput.man b/lsinput.man
new file mode 100644
index 0000000..dc7338d
--- /dev/null
+++ b/lsinput.man
@@ -0,0 +1,19 @@
+.TH LSINPUT 8 "July 2005" "" ""
+
+.SH NAME
+lsinput \- list input devices
+
+.SH SYNOPSIS
+.B lsinput
+
+.SH DESCRIPTION
+.PP
+\fBlsinput\fR displays a list of all input devices of the kernel,
+along with some information about each device.
+
+.SH SEE ALSO
+.PP
+input\-events(8)
+
+.SH AUTHOR
+Gerd Knorr.
diff --git a/mk/.cvsignore b/mk/.cvsignore
new file mode 100644
index 0000000..4985818
--- /dev/null
+++ b/mk/.cvsignore
@@ -0,0 +1 @@
+*.dep