[PATCH libevdev] doc: add a placeholder man page
Peter Hutterer
peter.hutterer at who-t.net
Sun Dec 8 14:46:45 PST 2013
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 at who-t.net>
---
configure.ac | 1 +
doc/.gitignore | 1 +
doc/Makefile.am | 2 ++
doc/libevdev.man.in | 32 ++++++++++++++++++++++++++++++++
4 files changed, 36 insertions(+)
create mode 100644 doc/libevdev.man.in
diff --git a/configure.ac b/configure.ac
index 9e122f0..5e3b40c 100644
--- 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
--- 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
--- 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
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.
+
+
--
1.8.3.1
More information about the Input-tools
mailing list