doc: add a placeholder man page

We don't provide man pages (the ones created by doxygen are pretty
terrible) so provide a placeholder page to provide the minimum info and point
people in the right direction.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

diff --git a/configure.ac b/configure.ac
index 9e122f0..5e3b40c 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -129,6 +129,7 @@ AC_CONFIG_FILES([Makefile
                 libevdev/Makefile
                 doc/Makefile
                 doc/libevdev.doxygen
+                doc/libevdev.man
                 tools/Makefile
                 test/Makefile
                 libevdev.pc])

diff --git a/doc/.gitignore b/doc/.gitignore
index 823fa26..20b4ef5 100644 (file)
--- a/doc/.gitignore
+++ b/doc/.gitignore
@@ -1,2 +1,3 @@
 html/
 libevdev.doxygen
+libevdev.man

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 7fe9096..c1a06aa 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,3 +1,5 @@
+man3_MANS = libevdev.man
+
 if HAVE_DOXYGEN
 
 noinst_DATA = html/index.html

diff --git a/doc/libevdev.man.in b/doc/libevdev.man.in
new file mode 100644 (file)
index 0000000..58a15c7
--- /dev/null
+++ b/doc/libevdev.man.in
@@ -0,0 +1,32 @@
+.TH LIBEVDEV 3 @PACKAGE_VERSION@
+.SH NAME
+libevdev \- wrapper library for evdev devices
+.SH SYNOPSIS
+.HP
+#include <libevdev/libevdev.h>
+.PP
+int 
+.B libevdev_new_from_fd
+(int fd, struct libevdev **device)
+.PP
+void 
+.B libevdev_free
+(struct libevdev *device)
+
+.SH DESCRIPTION
+.PP
+.B libevdev
+is a wrapper library for evdev devices. it moves the common
+tasks when dealing with evdev devices into a library and provides a library
+interface to the callers, thus avoiding erroneous ioctls, etc.
+.PP
+This man page is a placeholder only. The documentation for this version of
+.B libevdev
+is available at:
+.PP
+.B http://www.freedesktop.org/software/libevdev/doc/@PACKAGE_VERSION@/
+.SH LICENSE
+.B libevdev
+is licensed under the MIT license.
+
+